maplecontest/docs/codex-workflow.md

Codex Workflow

이 저장소에서 작업할 때는 토큰과 변경량을 아끼는 쪽을 기본으로 둔다.

작업 원칙

• 이미 확인한 사실은 다시 읽지 않는다.
• 같은 내용을 통째로 지우고 새로 쓰지 않는다.
• 수정은 가능한 한 apply_patch로 섹션 단위만 한다.
• 문서는 전체 재작성보다 부분 수정으로 유지한다.
• 카드 구현은 한 번에 하나씩, 공용 필드 우선으로 넣는다.
• 새 기능은 데이터 1곳 + 런타임 1곳 + 테스트 1곳 순서로 맞춘다.

읽기 원칙

• 파일은 필요한 것만 읽는다.
• 비슷한 파일은 병렬로 한 번에 확인한다.
• 같은 정보를 여러 번 요약하지 않는다.

쓰기 원칙

• 공용으로 표현 가능한 효과는 카드 전용 분기로 만들지 않는다.
• 같은 의미의 효과는 같은 필드 이름을 쓴다.
• 문서는 카드별 상태표와 공용 필드 사전을 분리해서 유지한다.

응답 원칙

• 중간 보고는 짧게 한다.
• 바뀐 점과 남은 점만 말한다.
• 불필요한 재설명은 줄인다.