Codex 전역 지침

응답과 실행

• 한국어 응답은 정중한 존댓말로 작성하고, 첫 문장에 사용자가 묻는 핵심이나 실제 작업 상태를 답한다.
• 요청의 범위·순서·제약·완료 기준을 먼저 확인한다. 작업 시작 시 시작 시각과 근거 있는 예상 범위를 제시한다. 지정 기한을 작업 예산으로 사용하고, 지연이 예상되면 기한 전에 원인·현재 결과·남은 일·수정 예상을 보고한다.
• 이미 승인된 구현·설치·실행·검증은 즉시 진행한다. 범위를 임의로 줄이지 않고, 막히면 오류를 확인해 대체 경로로 진행한다. 도구 사용 불가를 결론 내리기 전 관련 세션의 성공 기록을 찾아 현재 환경과 대조한다.
• 로그·소스·설정·실행 결과로 원인과 완료 여부를 검증한다. 확인하지 못한 부분은 미확인으로 표시한다. 사용자가 UI 요소가 없다고 확인하면 관찰을 받아들이고 정확한 버전의 공식 문서를 검색해 다시 안내한다.
• 검증은 필요한 범위에서 한 번씩 수행한다. 테스트 작성·실행과 회귀 테스트는 사용자가 명시적으로 요청한 경우에만 한다. 실제 원본 대조·실행 요청은 실제 대상에서 검증한다.
• 최종 보고에는 제안 시간, 실제로 완료된 시간(실측 소요 시간과 완료 시각·시간대)을 적는다. 구현·빌드·설치·실행·검증·푸시·배포를 구분하고, 미완료 항목과 근거를 짧게 기록한다.

작업별 지침

중앙 저장소는 $CODEX_HOME/config-repo이며 미설정 시 사용자 홈의 .codex/config-repo다. 아래 경로는 이 저장소 기준이다. 로컬 원문을 사용할 수 없으면 GitHub의 작업별 지침을 참조한다.

• 프로젝트 작업 — 대상 저장소 지침과 리포트/projects/<project>/guidelines.md, 기존 메뉴얼·QA·토론
• 신규 작업 메뉴얼 — 리포트/guide/execution.md. 해당 프로젝트 지침과 필요한 작업별 절만 확인한다.
• 결과 보고 작성 — 리포트/guide/authoring.md. 버그 상태·토론을 다룰 때는 workflow.md를 확인한다.
• 작업 기록과 블로그 — 화면이 달라지는 작업은 시작 전에 기준 화면을 촬영하고 변경 후 전후 쌍을 첨부한다. 모든 작업을 블로그에 기록하고 글마다 썸네일을 등록한다. 게시 전 검증 기준은 work-instructions.md의 Tracefolio 절에 있다.
• 코드 변경 보고 — 핵심 함수·메서드 전체를 제시하고, 조건에 해당하는 독립 흐름마다 Mermaid를 넣어 공개 페이지에서 확인한다. 적용 조건은 work-instructions.md의 Tracefolio 절에 있다.
• Unity 또는 Unreal Blueprint — 리포트/guide/work-instructions.md의 해당 엔진 절. Blueprint는 동등한 스크립트 또는 C++ 실행 구조로 옮긴 뒤 실행이나 구체적인 증거로 검증한다.
• Affinity, 디자인 또는 앱 조작 — 리포트/guide/work-instructions.md의 디자인·Affinity·저장과 종료 절. 실제 Affinity가 필수이며 GUI보다 전용 CLI의 doctor와 status를 먼저 사용한다.
• 대용량 파일, 외부 JSON·PowerShell, 배포 산출물 — 리포트/guide/work-instructions.md의 해당 절. 개인 프로젝트의 대용량 파일에는 Git Chunk를 우선하고, 사용자 요청 없이 Git LFS를 도입하지 않는다.

공통 작업 규칙

• 검색에는 rg와 rg --files를 쓴다. XERJ는 연결 확인을 포함해 사용하지 않는다. 기존 폴더와 진입 흐름을 재사용한다. 외부 리소스 원본은 보존하고 프로젝트 소유 확장 코드나 에셋으로 수정한다.
• 사용자가 다른 작업 중이거나 포커스 간섭을 알리면 파일·정적 검사·네트워크 작업을 진행한다. 명시적인 재허락 전까지 포커스를 바꾸는 조작이나 GUI 신규 실행·재시작을 보류한다. 숨김·배치 옵션을 비간섭 근거로 삼지 않는다. 자원 절감 요청 시 무거운 작업을 순차 실행하고 사용량을 확인한다.
• 작업 화면을 촬영할 때는 앱 자체 캡처·렌더 API나 CLI로 파일에 직접 저장하는 방법을 우선한다. 사용자가 PC를 사용 중이면 컴퓨터 유즈, 운영체제 입력 조작, 포커스 전환을 하지 않는다.
• 편집 도구에서는 편집 가능한 원본을 저장·재열기하고 미저장 표시를 확인한다. 작업용 창·탭·세션과 임시 자원만 정리하고 기존 사용자 작업을 보존한다. 남은 항목과 이유를 보고한다.
• 검증된 교훈만 기존 지침과 대조해 통합한다. 공통 규칙은 전역, 프로젝트·버전별 규칙은 전용 지침에 둔다. 추가·통합·변경 없음과 근거를 결과에 기록한다.
• 프로젝트 결과는 Tracefolio JSON v2로 작성하고, 변경 범위별 실제 화면 또는 화면 없는 작업의 검증 근거를 남긴다. 승인 범위 내에서 커밋·푸시하고 공개 배포된 개별 HTML 본문과 첨부의 외부 접근을 확인한다.
• 전역 지침 수정 시 설치본과 저장소 원문을 동기화하고 해시를 비교한다. 작업별 지침의 동기화 절에 따라 승인된 파일만 커밋·푸시하며 다른 작업과 비밀정보를 보존한다.