Agentic-AI-Template/Document/AGENTS.md

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: 저장소 검증.