modify template

Document/AGENTS.md

@@ -0,0 +1,60 @@
+# Project: {보고서 프로젝트명}
+
+## Repository Role
+- This repository is a Codex-first Report Generation Harness template.
+- Persistent repository instructions live in this `AGENTS.md`.
+- Reusable repo-scoped workflows live in `.agents/skills/`.
+- Project-scoped custom agents live in `.codex/agents/`.
+- Experimental hooks live in `.codex/hooks.json`.
+- The repository is optimized for evidence-backed report creation, not application development.
+
+## 보고서 입력값
+- `docs/PRD.md`에 아래 내용을 먼저 입력한다.
+- 보고서 주제: {무엇에 대한 보고서인지 한 문장으로 작성}
+- 용도: {의사결정, 내부 공유, 시장 조사, 전략 수립, 기술 검토, 정책 검토 등}
+- 핵심 키워드: {보고서 내용에 반드시 포함할 키워드, 산업, 기업, 지역, 기간, 이해관계자}
+- 방향성: {중립 분석, 찬반 비교, 실행 전략, 리스크 중심, 트렌드 전망, 근거 기반 추천 등}
+- 독자: {최종 보고서를 읽는 사람과 기대 수준}
+- 형식: {요약 보고서, 심층 보고서, 임원 브리프, 조사 메모, 백서 초안 등}
+
+## 산출물 규칙
+- CRITICAL: 사실 주장, 수치, 최신 동향, 법/정책/시장 정보는 반드시 웹 검색으로 확인하고 출처를 남길 것.
+- CRITICAL: 출처가 없는 핵심 주장은 보고서 본문에 단정적으로 쓰지 말고 `docs/RESEARCH_LOG.md`의 `검증 필요` 항목에 남길 것.
+- CRITICAL: 검색 출처는 제목, 발행기관, URL, 발행일 또는 접근일, 핵심 내용, 신뢰도 메모를 함께 기록할 것.
+- CRITICAL: 사용자가 제공한 방향성과 충돌하는 보고서 구조 변경은 먼저 피드백 요청 항목으로 남길 것.
+- 보고서 초안은 `docs/REPORT_DRAFT.md`에 작성한다.
+- 조사 누적 기록은 `docs/RESEARCH_LOG.md`에 작성한다.
+- 사용자 피드백과 반영 이력은 `docs/FEEDBACK.md`에 작성한다.
+- 상대 날짜 표현(오늘, 최근, 작년 등)은 가능한 한 절대 날짜로 풀어 쓴다.
+
+## Report Harness Workflow
+- 먼저 `docs/PRD.md`, `docs/ARCHITECTURE.md`, `docs/ADR.md`, `docs/UI_GUIDE.md`, `docs/RESEARCH_LOG.md`, `docs/REPORT_DRAFT.md`, `docs/FEEDBACK.md`를 읽고 보고서 의도를 파악할 것.
+- 단계별 실행 계획이 필요하면 repo skill `harness-workflow`를 사용해 `phases/` 아래 파일을 설계할 것.
+- 변경사항 리뷰가 필요하면 repo skill `harness-review` 또는 Codex의 `/review`를 사용할 것.
+- `phases/{phase}/index.json`은 phase 진행 상태의 단일 진실 공급원으로 취급할 것.
+- 각 `stepN.md`는 독립된 Codex 세션에서도 실행 가능하도록 자기완결적으로 작성할 것.
+
+## 보고서 생성 프로세스
+- 사용자가 `docs/PRD.md`의 입력값을 채운다.
+- Codex는 필요한 AI agent 역할을 설계한다. 예: research lead, domain researcher, source reviewer, outline writer, report editor.
+- 웹 검색을 통해 주제별 근거를 축적하고, 모든 핵심 근거를 `docs/RESEARCH_LOG.md`에 남긴다.
+- 축적된 근거를 바탕으로 `docs/REPORT_DRAFT.md`에 초안을 작성한다.
+- 초안 말미에 사용자에게 확인할 피드백 질문을 남기고, 답변은 `docs/FEEDBACK.md`에 축적한다.
+- 피드백 반영 후 필요한 추가 검색, 구조 변경, 문체 조정, 결론 보강을 반복한다.
+
+## 품질 기준
+- 결론은 근거보다 앞서가면 안 된다.
+- 반대 근거, 불확실성, 데이터 한계, 이해관계자별 관점을 별도 섹션으로 다룬다.
+- 출처 품질은 1차 자료, 공식 문서, 학술/정부/공공기관, 신뢰도 높은 언론/리서치 순으로 우선한다.
+- 웹 검색 결과가 서로 충돌하면 충돌 내용을 숨기지 말고 비교 표로 정리한다.
+- 보고서에는 독자가 다음 행동을 결정할 수 있는 요약, 근거, 리스크, 권고가 포함되어야 한다.
+
+## 검증
+- 기본 검증 스크립트는 `python scripts/validate_workspace.py`.
+- `HARNESS_VALIDATION_COMMANDS` 환경 변수에 줄바꿈 기준으로 검증 커맨드를 지정하면 해당 커맨드를 실행한다.
+- Node 프로젝트가 추가된 경우 `package.json`의 `lint`, `build`, `test` 스크립트를 자동 탐지해 순서대로 실행한다.
+
+## 명령어
+- `python scripts/execute.py <phase-dir>`: Codex 기반 report phase 순차 실행.
+- `python scripts/execute.py <phase-dir> --push`: phase 완료 후 브랜치 push.
+- `python scripts/validate_workspace.py`: 저장소 검증.