# Codex 개발 기록: Astra

| 항목 | 값 |
| --- | --- |
| Model | GPT-6 Astra (Ultra) |
| 도구 | Codex (ChatGPT Plus 플랜) |
| 프로젝트 | [codex-astra](../../codex-astra/) |
| Usage | 사용 한도 1회 소진 후, 후속 연속 요청 시 42% 잔여 |
| Time | 24분 37초 (원문 기록) |
| Steps | 미기록 |
| Files | 51개 |
| Lines | 5,655줄 (텍스트 전체, 빈 줄 포함) |
| 코드 비공백 LOC | 3,010줄 |
| 규모 측정일 | 2026-09-06 |

## 해석 및 측정 기준

- 원문에는 약 17분 후 사용 한도로 중단하고 사용량 재설정 기회를 사용했다는 기록이 있다. 위 Time이 중단·재개 전체를 포함하는지는 확인되지 않았다.
- 잔여 42%는 후속 시점의 관측값이다. 시작 잔여량과 윈도우 경계가 불명확하므로 총 소진율이나 크레딧으로 환산하지 않는다.
- 파일·라인 수는 현재 폴더의 실측값이며, 개발 당시 생성량이나 편집량이 아니다. [공통 집계 기준](README.md#측정-기준)을 따른다.

## 개발 로그

<details>
<summary>원문 펼치기</summary>

~~~~text

첨부한 마크다운의 요구사항을 확인한 뒤 codex-astra 폴더에 장기게임을 구현하겠습니다. P10과 P11은 이번 구현 범위에서 제외하겠습니다.
한국 장기 규칙 엔진과 화면을 분리하고, 로컬 2인 대국·기보 저장/재생·오프라인 실행까지 구현하겠습니다. 규칙은 첨부 문서를 기준으로 고정하며, 한의 점수는 기물 72점에 덤 1.5점을 더해 표시하겠습니다.
생성됨 types.ts+32-0


Engine, Board 및 Records: 작업을 시작했습니다

파일 수정함생성됨 .gitignore+4-0
생성됨 index.html+16-0
생성됨 package.json+31-0
생성됨 icon.svg+1-0
생성됨 manifest.webmanifest+16-0
생성됨 build-sw.mjs+32-0
생성됨 tsconfig.json+16-0
생성됨 vite.config.ts+9-0Records 및 Engine: 업데이트했습니다

초·한의 마상 배치를 고르는 준비 화면과, 장기판을 중심으로 한 대국 화면을 만들고 있습니다. 엔진은 포의 포대 조건, 마·상의 길막힘, 궁성 대각선 이동부터 테스트하고 있습니다.
Board 및 Records: 작업을 마쳤습니다

규칙 엔진의 랜덤 대국 1,000판 검증을 통과했습니다. 생성된 약 487만 개의 수에서 궁 잡기, 포 규칙 위반 등 금지된 이동을 검사했고, 무르기로 이전 상태가 정확히 복원되는 것도 확인했습니다. 이제 화면과 기보 기능을 연결해 빌드와 실제 조작을 점검하고 있습니다.
Engine, Board 및 Records: 업데이트했습니다

현재 62개 테스트와 프로덕션 빌드가 통과했습니다. Browser 스킬을 사용해 착수·무르기·기보 복기·자동 복구를 직접 확인하고, 모바일 화면과 오프라인 실행도 마무리하겠습니다.
장기게임 브라우저 연결

Engine: 업데이트했습니다

로컬 화면 검증 준비

Records 및 Board: 작업을 마쳤습니다

Chrome 통합 사용함장기게임 준비 화면 확인

준비 화면 디자인 점검

배치 선택과 대국 시작·합법수 확인사용 한도에 도달했습니다. 계속하려면 요금제를 업그레이드하거나 크레딧을 추가하세요. 또는 나중에 다시 시도하세요.


  파일 9개를 편집했습니다+157-0변경 사항 검토실행 취소리뷰

codex-astra/src/engine/types.tscodex-astra/src/engine/types.ts+32-0
codex-astra/.gitignorecodex-astra/.gitignore+4-0
codex-astra/index.htmlcodex-astra/index.html+16-0
codex-astra/package.jsoncodex-astra/package.json+31-0
codex-astra/public/icon.svgcodex-astra/public/icon.svg+1-0
codex-astra/public/manifest.webmanifestcodex-astra/public/manifest.webmanifest+16-0
codex-astra/scripts/build-sw.mjscodex-astra/scripts/build-sw.mjs+32-0
codex-astra/tsconfig.jsoncodex-astra/tsconfig.json+16-0
codex-astra/vite.config.tscodex-astra/vite.config.ts+9-0
파일 접기

네, 계속 진행 중입니다. 장기 규칙 테스트 62개와 랜덤 대국 1,000판을 통과했고, 화면도 실제로 열어 배치 선택과 합법수 표시를 확인했습니다. 지금은 저장·복구·복기 조작과 모바일 화면을 점검하면서 오프라인 파일 용량을 줄이고 있습니다.
이동 가능한 교차점 확인
No tab with id: 530148171.


Engine: 업데이트했습니다

Chrome 통합 사용함저장된 대국 복구 화면 확인

대국 복구 및 졸 이동 대상 검증

착수·쉬기·무르기·복기 조작 확인


Engine: 작업을 마쳤습니다

Chrome 통합 사용함화면 갱신 후 대국 상태 확인

프로덕션 화면에서 대국 조작 검증

착수·쉬기·무르기와 복기 중 착수 차단 검증

키보드 착수 및 390px 모바일 화면 검증

모바일 배치와 실행 오류 확인

모바일 드래그 경로와 잡기 대상 확인


실제 화면에서 착수·쉬기·무르기·키보드 조작과 복기 중 착수 차단을 확인했습니다. 390px 모바일 화면에서도 장기판이 잘리지 않고, 터치 영역은 44px 이상입니다. 오프라인 배포 파일은 약 2.4MB로 줄였으며, 마지막으로 서버를 끈 상태에서 재접속을 확인하고 있습니다.
Chrome 통합 사용함드래그 잡기와 기물 점수 반영 검증

서버 종료 상태에서 오프라인 재접속·대국 복구 검증

오프라인 재접속 문제 확인

오프라인 캐시 상태 안내 확인

캐시 준비와 복구 화면 재확인

오프라인 캐시로 화면 재실행 확인

오프라인 새로고침 결과 확인

오프라인 로딩 원인 진단


Records: 업데이트했습니다

Chrome 통합 사용함오프라인 정적 파일 캐시 수정 검증

대국 복구와 표시 옵션 확인

한글 기물·색 구분·뒤집기 옵션 검증

수정된 서비스워커의 오프라인 재실행 확인

오프라인 복구 후 대국 계속 진행 확인


오프라인 재접속 과정에서 정적 파일 캐시 문제를 발견해 수정했습니다. 이제 서버를 완전히 꺼도 장기판이 다시 열리고, 저장된 대국을 복구한 뒤 계속 둘 수 있습니다. 최종 회귀 테스트와 실행 안내를 정리하고 있습니다.
Chrome 통합 사용함기권 종료 및 결과 다이얼로그 확인

합의 점수 판정과 새 대국 흐름 확인

완성된 게임을 준비 화면으로 정리


Records: 작업을 마쳤습니다

장기게임 완성본 준비
codex-astra 폴더에 장기게임 수담을 구현했습니다. P10(AI)·P11(온라인)은 제외했습니다.
- 로컬 2인 대국, 마상 배치, 장군·승패 판정
- 기보 저장·불러오기·복기, 자동 저장·복구
- 모바일·키보드 조작, 오프라인 실행
테스트 65개, 랜덤 대국 1,000판, 빌드 및 브라우저 검증을 통과했습니다.


특이 사항
17분 만에 사용량 소진되어 멈춤
사용 한도에 도달했습니다. 계속하려면 요금제를 업그레이드하거나 크레딧을 추가하세요. 또는 오후 4:31에 다시 시도하세요.
(사용량 재설정 찬스 사용)


`codex-astra` 폴더에 장기게임 **수담**을 구현했습니다. P10(AI)·P11(온라인)은 제외했습니다.

- 로컬 2인 대국, 마상 배치, 장군·승패 판정
- 기보 저장·불러오기·복기, 자동 저장·복구
- 모바일·키보드 조작, 오프라인 실행

**테스트 65개, 랜덤 대국 1,000판, 빌드 및 브라우저 검증을 통과했습니다.**

[장기게임 열기](http://127.0.0.1:5187/) · [실행 안내](/Volumes/nvme1tb/Dev/janggi/codex-astra/README.md)
~~~~

</details>