Codex 실전 사용 가이드

현재 저장소에서 [기능]을 구현해줘. 먼저 관련 진입점과 테스트를 읽고 3~5단계 계획을 제시해. 수정 범위는 [허용 파일]로 제한하고 [변경 금지 항목]은 유지해. 완료 조건은 [완료 조건], 검증 명령은 [테스트 명령]이야. 구현 후 변경 파일, 테스트 결과, 남은 위험을 보고해.

사용 팁: 기능 하나와 관찰 가능한 완료 조건 하나부터 맡기세요.

[오류 로그]와 [재현 단계]를 기준으로 원인 후보를 순위화해. 먼저 실패를 재현하는 테스트나 읽기 전용 확인을 수행하고, 원인이 확인되면 가장 작은 수정만 적용해. 관련 테스트 [테스트 명령]을 실행하고 오류를 숨기는 우회는 하지 마.

사용 팁: 로그의 비밀값과 개인정보는 지운 뒤 전달하세요.

[대상]을 [개선 목표]에 맞게 리팩터링해. 공개 API와 [보존 동작]을 유지하고 현재 동작을 고정하는 테스트부터 확인해. 한 단계마다 작은 diff와 [테스트 명령] 결과를 보여주고 기능 변경은 분리해.

사용 팁: 리팩터링과 새 기능을 한 요청에 섞지 마세요.

[사용자 행동]이 저장소에서 처리되는 흐름을 라우트·컴포넌트·데이터 경계 순으로 찾아줘. 파일과 심볼 근거를 붙이고 확인한 사실과 추정을 구분해. 아직 파일은 수정하지 말고 다음에 읽을 파일 5개 이하만 제안해.

사용 팁: 읽기와 수정을 분리하면 불필요한 변경을 줄일 수 있습니다.

[diff 또는 PR]을 요구사항 [요구사항]과 대조해 리뷰해. 정확성, 데이터 손실, 보안, 접근성, 테스트 누락 순으로 실제 문제가 되는 항목만 심각도·근거·재현 조건·최소 수정안과 함께 보고해. 스타일 취향은 제외해.

사용 팁: 리뷰할 요구사항과 실행된 테스트를 같이 제공하세요.

[기능]의 현재 테스트와 실패 가능 경로를 조사해. 가장 가치 있는 누락 사례 [사례]를 재현하는 테스트를 추가하고 테스트가 실제 사용자 동작을 검증하는지 설명해. 제품 코드는 테스트를 통과시키는 데 꼭 필요한 경우만 수정해.

사용 팁: 구현 세부보다 사용자에게 보이는 결과를 검증하세요.

[패키지]를 [목표 버전]으로 올릴 필요가 있는지 공식 변경 로그와 현재 사용 코드를 조사해. breaking change, 필요한 코드 수정, 테스트, 롤백 방법을 보고하고 승인 전에는 설치나 파일 수정을 하지 마.

사용 팁: 조사와 실제 업데이트를 별도 작업으로 나누세요.

[느린 동작]의 재현 조건과 현재 측정값을 확인해. 네트워크, 렌더링, 데이터 접근 후보를 근거로 좁히고 가장 작은 측정 실험을 실행해. 숫자 없이 성능이 좋아졌다고 결론 내리지 마.

사용 팁: 같은 입력과 환경으로 전후를 비교하세요.

현재 브랜치를 배포 기준 [기준 브랜치]와 비교해. Git 상태, 변경 파일, migration·환경변수·binding 영향, 테스트 결과, 롤백 방법을 확인하고 운영 상태를 바꾸지는 마. 배포를 막아야 할 항목을 먼저 보고해.

사용 팁: 점검 요청과 실제 배포 권한을 분리하세요.

현재 변경을 [요구사항]과 대조해 누락, 무관한 수정, 생성된 임시 파일, 비밀값 노출을 확인해. [테스트 명령]을 실행하고 결과와 변경 파일을 요약해. 파일 삭제·커밋·push는 승인된 범위에서만 수행해.

사용 팁: git status와 diff를 함께 검토하게 하세요.