3장 Codex가 읽는 저장소를 설계한다
ChatGPT의 대화는 설계 재료이고 저장소 파일이 정본이다. Codex가 매번 같은 규칙을 따르려면 루트 AGENTS.md에 목표, 디렉터리, 실행 명령, 완료 조건, 금지 행동을 짧게 적는다.
# BridgePilot 작업 규칙
- 정본 데이터는 fixtures/bridgepilot.json이다.
- 외부 에이전트 결과는 fixtures/inbox에서만 읽는다.
- 변경 후 npm test를 실행한다.
- 출처 URL 없는 claim은 UI에 표시하지 않는다.
- 비밀값, 고객 데이터, 법률 결론을 커밋하지 않는다.
Codex 공식 문서의 중요한 점은 모델 이름보다 실행 경계다. SDK로 프로그래밍 가능한 코딩 스레드를 만들고, MCP 서버 모드에서는 codex와 후속 대화 도구로 저장소 작업을 연결할 수 있다. 샌드박스는 읽기 전용, 작업공간 쓰기, 전체 접근처럼 위험에 맞게 선택한다. 이 책은 기본을 작업공간 쓰기로 두고 외부 네트워크와 파괴적 명령은 별도 승인 대상으로 본다.
공식 멀티에이전트 예제도 PM·디자인·프런트엔드·백엔드·테스트 산출물을 게이트로 연결한다. 핵심은 에이전트 수가 아니라 앞 단계 산출물이 검사에 통과해야 다음 단계가 시작되는 구조다.
첫 GREEN
cd 03-labs
npm run verify
이 명령은 문법과 계약, 저장소, HTTP 요청 핸들러를 검사한다. 포트가 금지된 CI에서도 요청 핸들러를 직접 호출하므로 테스트할 수 있다. 첫 GREEN을 만든 뒤 기능을 추가하면 실패의 원인을 좁힐 수 있다.