docs: record project operation and verification guidance

AGENTS.md

@@ -4,6 +4,7 @@ ShortVideoGenerator는 혼자 Codex에서 사용하는 짧은 영상 제작 프
 
 ## 작업 전에 확인
 
+- docs/standards.md, docs/engineering-notes.md와 변경할 영역의 AGENTS.md를 먼저 읽는다. 결과 구조 변경 전에는 해당 스키마·양식, 시간 설계 전에는 실제 WAV와 구간, 이미지 작업 전에는 사용자 스타일 원본·조사 근거를 확인한다.
 - 제작 내용을 작성할 때는 docs/short-video-guide.md의 담당 단계 절을 읽는다. 참고 영상의 소재 사실은 새 자료 조사에서 확인한다.
 - 단계 결과·승인·시간·파일을 다룰 때는 docs/workflow-contracts.md와 해당 templates/stages 양식·contracts 스키마를 읽는다.
 - 담당 역할은 .codex/agents의 TOML, 반복 작업은 .agents/skills의 SKILL.md를 사용한다. 목록·파일 형식과 실제 도구 실행 성공을 구분한다.
@@ -15,6 +16,41 @@ ShortVideoGenerator는 혼자 Codex에서 사용하는 짧은 영상 제작 프
 - topic/story/scenes/final의 실제 사용자 승인 없이 다음 경계를 넘지 않는다. 같은 승인 버전으로 재개하면 다시 묻지 않는다.
 - 총괄만 project.json을 작성한다. 담당은 자기 새 버전의 결과·검토를 제출하고 이전 결과를 보존한다. 요청·예상·예제와 실제 결과·실측·승인을 구분한다.
 
+## 프로젝트 구조
+
+```text
+ShortVideoGenerator/
+├── AGENTS.md                    → Codex 작업 기준과 탐색 시작점
+├── CLAUDE.md                    → 같은 프로젝트 작업 기준
+├── docs/
+│   ├── architecture.md          → 구성과 전달 흐름
+│   ├── business-rules.md        → 제작·승인·수정 규칙
+│   ├── security.md              → 접근·기록·인증정보 경계
+│   ├── standards.md             → 작성·확인의 공통 기준
+│   ├── engineering-notes.md     → 반복 작업의 원인과 대응
+│   ├── operations.md            → 사용·제출·검증 명령
+│   ├── contracts.md             → 사용자·생성 도구 전달 표면
+│   ├── workflow-contracts.md    → 단계별 필드·완료·보류 기준
+│   ├── short-video-guide.md     → 내용·화면 구성과 검토 메모
+│   └── tracking/
+│       ├── status.md            → 확인한 기능과 다음 구현
+│       ├── verification.md      → 실제 검사 명령·결과·한계
+│       ├── findings.md          → 미해결 문제
+│       └── decisions/
+│           ├── index.md         → 결정 기록 목록
+│           └── 0001-local-instructions.md → 로컬 지침·JSON 전달 선택
+├── .codex/agents/AGENTS.md       → 8개 역할 설정의 작성 경계
+├── .agents/skills/AGENTS.md      → 15개 작업 스킬의 작성 경계
+├── contracts/AGENTS.md           → 스키마의 구조·의미 구분
+├── templates/AGENTS.md           → 빈 양식·검토 양식의 경계
+├── references/                  → 사용자 그림체와 참고 분석
+└── examples/                    → 실제 실행과 구분한 연결 예제
+```
+
+## 문제 보고
+
+사용자 승인 우회, 이전 결과의 손실, 다른 제작물·오래된 버전 혼입, 비밀정보 기록, 미확인 파일·시간을 실제 결과로 처리하는 문제는 즉시 사용자에게 보고한다. 부재한 생성 결과는 준비 조건과 돌아갈 단계를 보고하고 기다린다. 현재 범위에서 해결할 수 없는 그 밖의 문제는 원인·영향·보류 이유를 docs/tracking/findings.md에 남긴다.
+
 ## 생각하고 필요한 만큼 구현
 
 가정을 먼저 밝히고 불명확한 점을 숨기지 않는다. 해석이 여러 개라면 선택지를 설명하고 중요한 미확정 사항을 질문한다. 더 간단한 방법이 있으면 설명한다. 이해하지 못한 상태에서는 그 지점을 명시하고 확인한다.