작업 패킷

작업 패킷은 복붙 프롬프트 모음이 아닙니다. Codex에게 무엇을, 어디까지, 무엇을 남기며 맡길지 적은 작은 일감 봉투입니다.

이 문서를 읽으면

첫 요청을 작고 안전하게 자르는 법을 배웁니다.
금지 범위와 중단 조건을 명확히 적습니다.
로컬 패치, 클라우드 조사, CI 실패, PR 리뷰를 같은 형식으로 맡깁니다.

오늘 바로 해볼 일

다음 작업에서 “목표, 허용 범위, 금지, 증거” 네 줄만 먼저 적어보세요. 이 네 줄이 없으면 Codex가 똑똑해도 작업 경계가 흔들립니다.

기본 패킷 구조

실행 표면:
목표:
허용 범위:
금지:
먼저 확인할 것:
수정 후 검증:
남길 증거:
중단 조건:

나쁜 요청을 패킷으로 바꾸기

처음에는 길게 쓰려고 하기보다, 애매한 요청을 네 줄짜리 패킷으로 바꾸는 연습이 좋습니다.

나쁜 요청	좋은 요청
이거 알아서 고쳐줘	`src/content/docs/ko/packets.md`에서 예시가 부족한 부분만 보강하고, 빌드 결과를 남겨줘
CI 좀 봐줘	실패 job 이름과 로그를 먼저 분류하고, 설정 완화나 테스트 삭제 없이 최소 수정 후보를 제안해줘
문서 예쁘게 해줘	모바일에서 글이 넘치는지 확인하고, CSS 변경이 필요하면 해당 selector만 고쳐줘

좋은 요청은 Codex가 똑똑해지는 문장이 아니라, 실패했을 때 멈출 수 있는 문장입니다. 목표, 허용 범위, 금지, 검증이 있으면 결과가 흔들려도 다시 이어받기 쉽습니다.

로컬 패치 패킷

실행 표면: CLI 또는 IDE extension
목표: checkout retry 실패를 좁은 패치로 수정
허용 범위: payment adapter와 해당 테스트 파일
금지: 패키지 설치, 설정 완화, 테스트 삭제
먼저 확인할 것: 재현 경로와 의심 파일 요약
수정 후 검증: 관련 테스트 실행
남길 증거: diff, 테스트 명령과 결과, 남은 위험
중단 조건: 외부 sandbox credential이 필요하면 진행 중단 후 보고

클라우드 조사 패킷

실행 표면: Web/Cloud 또는 Codex app
목표: 큰 코드베이스에서 인증 요청 흐름을 추적하고 개선 후보 제안
허용 범위: 읽기 전용 분석
금지: 파일 수정, migration 작성, secret 접근
남길 증거: 요청 흐름 지도, 위험 목록, 제안 패치 후보
handoff: 로컬 패치로 넘길 가장 작은 후보 3개

CI 실패 패킷

실행 표면: CLI + GitHub/CI
목표: 실패한 CI job을 실패 유형으로 분류하고 최소 수정 계획 수립
입력: job name, failing log, current diff
금지: CI 설정 완화, 테스트 삭제, lockfile 변경
남길 증거: 로컬 재현 여부, 원인 후보, 수정 diff, rerun 결과
중단 조건: CI 환경에서만 재현되면 환경 차이로 보고

PR 리뷰 패킷

실행 표면: Codex app review 또는 GitHub
목표: PR을 merge 전 위험 중심으로 리뷰
초점: 정확성, 회귀, 누락 테스트, 보안, migration 위험
금지: 스타일 취향 위주 리뷰
남길 증거: finding 목록, 파일/라인 참조, 권장 확인
출력: 리뷰어가 바로 판단할 수 있는 review note

좋은 패킷의 기준

사람이 읽어도 작업 경계가 보입니다.
Codex가 실패했을 때 멈출 조건이 있습니다.
결과가 말이 아니라 diff, 테스트 결과, 리뷰 메모, 인수인계로 남습니다.
다음 사람이 이어받을 수 있습니다.
외부 문서나 tool output에 섞인 지시문보다 사용자 요청과 저장소 규칙이 우선한다는 기준이 보입니다.