Document Builder Templates

document-builder 에이전트가 사용하는 CLAUDE.md 생성 템플릿입니다.

ROOT CLAUDE.md Template

# CLAUDE.md

## 프로젝트 개요

**{project_name}**은(는) {short_description}입니다.

## 기술 스택

- **언어**: {language}
- **프레임워크**: {framework}
- **패턴**: {patterns}

## 프로젝트 구조

\`\`\`
{project_name}/
├── CLAUDE.md                    # 루트 오케스트레이터
├── agent-docs/                  # 루트 공통 문서
{structure_tree}
\`\`\`

## 주요 커맨드/에이전트

| 이름 | 설명 |
|------|------|
{main_items_table}

## 모듈별 컨텍스트

| 모듈 | CLAUDE.md | 설명 |
|------|-----------|------|
{modules_table}

## 상세 문서

- [agent-docs/architecture.md](agent-docs/architecture.md) - 아키텍처 가이드
{additional_docs}

---

MODULE CLAUDE.md Template

# {module_name}/ CLAUDE.md

## 모듈 개요

{module_description}

## 파일 구조

\`\`\`
{module_name}/
├── CLAUDE.md
{file_tree}
\`\`\`

## 포함된 항목

| 이름 | 설명 |
|------|------|
{items_table}

## 작성 가이드

{writing_guide_summary}

상세 내용은 [agent-docs/{module}-guide.md](agent-docs/{module}-guide.md) 참조

## 상세 문서

{docs_links}

## 참조

- [Root CLAUDE.md](../CLAUDE.md)

---

SUBMODULE CLAUDE.md Template

# {submodule_name}/ CLAUDE.md

## 전문 분야

{specialization}

## 포함된 에이전트

| 에이전트 | 전문 분야 |
|---------|----------|
{agents_table}

## 사용법

\`\`\`
{usage_example}
\`\`\`

## 상세 문서

{docs_links}

## 참조

- [상위 모듈](../CLAUDE.md)
- [루트](../../CLAUDE.md)

---

agent-docs/ Recommended Structure

ROOT level agent-docs/

agent-docs/
├── architecture.md      # 전체 아키텍처 다이어그램 및 설명
├── installation.md      # 설치 가이드
├── references.md        # 외부 참고 문서 링크
└── development.md       # 개발 가이드

MODULE level agent-docs/

{module}/agent-docs/
├── {module}-schema.md   # 스키마/구조 정의
├── {module}-guide.md    # 모듈별 작성 상세 가이드
└── examples.md          # 코드 예시

SUBMODULE level agent-docs/

{submodule}/agent-docs/
├── patterns.md          # 패턴/예시
└── best-practices.md    # 모범 사례

---

Placeholder Reference

Placeholder	Description	Example
{project_name}	프로젝트 이름	claude-integration
{short_description}	1줄 설명	Claude Code 생산성 향상 플러그인
{language}	주요 언어	TypeScript, Markdown
{framework}	프레임워크	Claude Code CLI
{patterns}	설계 패턴	Orchestrator-Worker
{structure_tree}	디렉토리 트리	├── commands/...
{main_items_table}	주요 항목 테이블	| /git-commit | Git 커밋 |
{modules_table}	모듈 링크 테이블	| commands/ | ... |
{module_name}	모듈 이름	commands
{module_description}	모듈 설명	슬래시 커맨드 정의 모듈
{file_tree}	파일 목록	├── git-commit.md
{items_table}	포함 항목 테이블	| git-commit | ... |
{writing_guide_summary}	작성 가이드 요약	3-5줄 요약
{docs_links}	문서 링크 목록	- guide.md
{submodule_name}	서브모듈 이름	backend
{specialization}	전문 분야	NestJS 생태계 전문 에이전트
{agents_table}	에이전트 테이블	| typeorm-expert | ... |
{usage_example}	사용법 예시	Task(subagent_type="...")

---

Line Count Guidelines

Type	Max Lines	Recommended
ROOT	150	80-120
MODULE	80	40-60
SUBMODULE	50	30-40

Over Limit? Extract to agent-docs/

Extractable sections:
├─ Detailed code blocks (> 10 lines)
├─ Comprehensive guides (> 20 lines)
├─ Large tables (> 15 rows)
├─ Architecture diagrams
└─ Examples collection