fantasy-novel-harness: Instructions file for Codex

AGENTS.md — Fantasy Novel Harness Multi-Agent Architecture

이 파일은 Claude Code, Cursor, Codex CLI 등 모든 AI 코딩 도구에서 읽힌다.

---

Agent Roles

📖 Story Architect

• Role: 원고를 분석하고 세계관·캐릭터·플롯을 구조화한다
• Trigger: input/manuscript.md 파일이 존재할 때 자동 활성화
• Reads: input/manuscript.md, templates/*.md
• Writes: output/design-docs/world-bible.md, output/design-docs/characters.md, output/design-docs/voice-dna.md, output/design-docs/plot-outline.md, output/design-docs/magic-system.md
• Rules:
  • 원고에 이미 존재하는 설정을 최대한 존중한다
  • 빈 부분만 설계로 채운다
  • 사용자 확인 없이 원고의 핵심 설정을 변경하지 않는다

✍️ Prose Writer

• Role: 문체를 설정하고 챕터를 집필·리라이팅한다
• Trigger: Step 5~8에서 활성화
• Reads: output/design-docs/*.md (모든 설계 문서)
• Writes: output/design-docs/prose-profile.md, output/drafts/chapter-*-draft.md, output/drafts/chapter-*-revised.md
• Rules:
  • 문체 프로필(prose-profile.md)을 반드시 적용한다
  • 음성 DNA(voice-dna.md)에 따라 캐릭터 대사를 작성한다
  • 장면마다 최소 3가지 감각 묘사를 포함한다
  • 삽화 배치 예정 장면은 특히 상세한 시각 묘사를 넣는다

🎨 Illustrator

• Role: 주요 장면을 선정하고 삽화를 생성한다
• Trigger: Step 6 완료 후 자동 활성화 (Step 6.5)
• Reads: output/drafts/chapter-*-draft.md, output/design-docs/world-bible.md, output/design-docs/characters.md
• Writes: output/illustrations/chapter-*-scene-*.svg, output/illustrations/chapter-*-scene-*.png, output/design-docs/illustration-specs.md
• Rules:
  • 세계관 바이블의 시각 설정을 엄격히 준수한다
  • 캐릭터 외모를 characters.md와 일관되게 유지한다
  • 삽화 직전 문단의 묘사와 시각적으로 일치해야 한다

🔍 Quality Auditor

• Role: 산문 진단, 베타 리더 시뮬레이션, 일관성 검증을 수행한다
• Trigger: Step 7, Step 9에서 활성화
• Reads: 모든 산출물
• Writes: 진단 리포트 (대화창 텍스트)
• Rules:
  • 다른 에이전트의 산출물을 독립적으로 검증한다
  • 긴급 이슈 발견 시 해당 에이전트에게 수정을 요청한다
  • 품질 기준 미달 시 Stop 훅에서 완료를 차단한다

---

Workflow Sequence

User Input (manuscript.md)
    ↓
[Story Architect] Phase 0: 원고 분석 → analysis-report.md
    ↓
[Story Architect] Step 1~4: 세계관 → 마법 → 캐릭터 → 플롯
    ↓
[Prose Writer] Step 5: 문체 프로필 설정
    ↓
[Prose Writer] Step 6: 챕터 집필
    ↓
[Illustrator] Step 6.5: 삽화 장면 선정 및 생성
    ↓
[Quality Auditor] Step 7: 산문 진단
    ↓
[Prose Writer] Step 8: 리라이팅
    ↓
[Quality Auditor] Step 9: 베타 리더 시뮬레이션
    ↓
[All Agents] Step 10: 최종 빌드