이 문서는 Codex가 Trace를 구현할 때 작업을 어떻게 나누고 검증할지 정의한다.
Codex는 구현 전에 다음 문서를 확인한다.
docs/mvp-spec.mddocs/development/architecture.mddocs/development/feature-specs.md- 권한 또는 자동 전달 작업이면
docs/development/permissions.md,docs/development/delivery.md - 관련 구현 파일
하나의 작업은 가능하면 하나의 기능 흐름만 다룬다.
좋은 작업 예시:
- 메뉴바 앱 셸 추가
- 설정 저장소 추가
- 날짜별 파일명 생성 로직 추가
- 기본 캡처 흐름 연결
- 히스토리 목록 정렬 로직 추가
피해야 할 작업 예시:
- 앱 전체 구현
- 캡처, 히스토리, 설정을 한 번에 구현
- UI 리팩터링과 기능 추가를 동시에 수행
Codex는 docs/development/implementation-plan.md의 순서를 따른다. 단, 사용자가 특정 기능을 먼저 요청하면 해당 요청을 우선한다.
다음 경우 문서를 함께 수정한다.
- 제품 흐름이 바뀐 경우
- 저장 구조가 바뀐 경우
- 모듈 책임이 바뀐 경우
- MVP 포함/제외 범위가 바뀐 경우
- 테스트 전략이 바뀐 경우
코드 변경 후 가능한 검증을 실행한다.
우선순위:
- 포맷 또는 빌드
- 단위 테스트
- 핵심 흐름 수동 점검
검증하지 못한 경우 최종 응답에 이유를 남긴다.
커밋을 요청받은 경우 다음을 확인한다.
- 의도하지 않은 파일 변경이 없는지 확인한다.
- 제품 문서와 개발 문서가 충돌하지 않는지 확인한다.
- 테스트 또는 빌드 결과를 확인한다.
- 커밋 메시지는 변경 내용을 짧고 명확하게 쓴다.