@kood/claude-code 0.4.0 → 0.5.0

package/templates/.claude/skills/docs-creator/AGENTS.md

@@ -0,0 +1,238 @@
+# Docs Creator - Agent Coordination
+
+문서 작성 스킬에서 에이전트 활용 가이드.
+
+---
+
+<agents_reference>
+
+전체 에이전트 조정 가이드: @../../PARALLEL_AGENTS.md
+
+</agents_reference>
+
+---
+
+<recommended_agents>
+
+## 추천 에이전트
+
+| 에이전트 | 모델 | 용도 |
+|---------|------|------|
+| **document-writer** | haiku/sonnet | 문서 작성, README, 주석, 기술 문서 |
+| **explore** | haiku | 코드베이스 구조 파악, 기존 패턴 분석 |
+| **analyst** | sonnet | 프로젝트 요구사항 분석, 패턴 도출 |
+| **code-reviewer** | opus | 문서 품질 검증, 정확성 검토 |
+
+</recommended_agents>
+
+---
+
+<coordination_patterns>
+
+## 조정 패턴
+
+### 패턴 1: 병렬 문서 작성
+
+**용도:** 여러 문서를 동시에 작성
+
+```typescript
+// CLAUDE.md, SKILL.md, README.md 동시 작성
+Task(
+  subagent_type="document-writer",
+  model="sonnet",
+  prompt="CLAUDE.md 작성: 프로젝트 규칙 및 금지/필수 사항"
+)
+
+Task(
+  subagent_type="document-writer",
+  model="haiku",
+  prompt="README.md 작성: 설치 및 빠른 시작 가이드"
+)
+
+Task(
+  subagent_type="document-writer",
+  model="haiku",
+  prompt="CONTRIBUTING.md 작성: 기여 가이드"
+)
+```
+
+**효과:** 순차 실행 대비 3배 빠름
+
+---
+
+### 패턴 2: 탐색 → 문서화 파이프라인
+
+**용도:** 기존 프로젝트 문서화
+
+```typescript
+// Step 1: 구조 분석
+Task(
+  subagent_type="explore",
+  model="haiku",
+  prompt="프로젝트 구조, 기술 스택, 주요 패턴 분석"
+)
+
+// Step 2: 분석 결과 바탕 문서 작성
+Task(
+  subagent_type="document-writer",
+  model="sonnet",
+  prompt="분석 결과 기반 CLAUDE.md 작성"
+)
+```
+
+---
+
+### 패턴 3: 작성 → 검증 → 개선
+
+**용도:** 고품질 문서 생성
+
+```typescript
+// Step 1: 문서 작성
+Task(
+  subagent_type="document-writer",
+  model="sonnet",
+  prompt="SKILL.md 작성: workflow, examples 포함"
+)
+
+// Step 2: 품질 검증
+Task(
+  subagent_type="code-reviewer",
+  model="opus",
+  prompt="SKILL.md 검증: 명확성, 실행 가능성, 예시 품질"
+)
+
+// Step 3: 피드백 반영 개선
+Task(
+  subagent_type="document-writer",
+  model="sonnet",
+  prompt="code-reviewer 피드백 반영하여 SKILL.md 개선"
+)
+```
+
+---
+
+### 패턴 4: 다국어 문서 병렬 작성
+
+**용도:** 한/영 동시 문서화
+
+```typescript
+// 한국어/영어 문서 동시 작성
+Task(
+  subagent_type="document-writer",
+  model="sonnet",
+  prompt="한국어 문서 작성: docs/ko/guide.md"
+)
+
+Task(
+  subagent_type="document-writer",
+  model="sonnet",
+  prompt="영어 문서 작성: docs/en/guide.md"
+)
+```
+
+</coordination_patterns>
+
+---
+
+<model_routing>
+
+## 모델 라우팅
+
+| 작업 | 모델 | 이유 |
+|------|------|------|
+| **README, 설치 가이드** | haiku | 간단한 구조, 빠른 작성 |
+| **CLAUDE.md, SKILL.md** | sonnet | 복잡한 구조, XML 태그 필요 |
+| **아키텍처 문서** | opus | 깊은 분석, 설계 패턴 설명 |
+| **문서 품질 검증** | opus | 정확성, 일관성 검토 |
+
+</model_routing>
+
+---
+
+<practical_examples>
+
+## 실전 예시
+
+### 예시 1: 새 프로젝트 문서화
+
+```typescript
+// Phase 1: 병렬 탐색
+Task(subagent_type="explore", model="haiku",
+     prompt="프로젝트 구조 분석")
+Task(subagent_type="explore", model="haiku",
+     prompt="기술 스택 및 버전 확인")
+
+// Phase 2: 병렬 문서 작성
+Task(subagent_type="document-writer", model="sonnet",
+     prompt="CLAUDE.md: 프로젝트 규칙, 금지/필수 사항")
+Task(subagent_type="document-writer", model="haiku",
+     prompt="README.md: 빠른 시작, 설치 가이드")
+Task(subagent_type="document-writer", model="haiku",
+     prompt="CONTRIBUTING.md: 기여 방법")
+
+// Phase 3: 검증
+Task(subagent_type="code-reviewer", model="opus",
+     prompt="문서 품질 검증: 명확성, 실행 가능성")
+```
+
+---
+
+### 예시 2: API 문서 작성
+
+```typescript
+// 여러 API 엔드포인트 문서 동시 작성
+Task(subagent_type="document-writer", model="haiku",
+     prompt="docs/api/users.md: User API 문서")
+Task(subagent_type="document-writer", model="haiku",
+     prompt="docs/api/posts.md: Post API 문서")
+Task(subagent_type="document-writer", model="haiku",
+     prompt="docs/api/comments.md: Comment API 문서")
+```
+
+---
+
+### 예시 3: 스킬 문서 작성
+
+```typescript
+// Step 1: 스킬 분석
+Task(subagent_type="analyst", model="sonnet",
+     prompt="스킬 요구사항 분석 및 구조 도출")
+
+// Step 2: 문서 작성
+Task(subagent_type="document-writer", model="sonnet",
+     prompt="SKILL.md 작성: trigger, workflow, examples")
+
+// Step 3: 검증 및 개선
+Task(subagent_type="code-reviewer", model="opus",
+     prompt="SKILL.md 검증 및 개선사항 제안")
+```
+
+</practical_examples>
+
+---
+
+<best_practices>
+
+## 모범 사례
+
+### 작업 시작 전 체크
+
+- [ ] 여러 문서를 작성하는가? → 병렬 document-writer
+- [ ] 기존 프로젝트인가? → explore 먼저, 그 후 문서화
+- [ ] 복잡한 구조인가? → sonnet/opus 모델 사용
+- [ ] 다국어 필요한가? → 병렬 작성
+
+### 에이전트 활용 원칙
+
+**DO:**
+- 독립 문서 → 병렬 작성
+- 복잡한 문서 → sonnet/opus
+- 품질 중요 → code-reviewer 검증
+- 대량 문서 → haiku로 빠르게
+
+**DON'T:**
+- 간단한 문서에 opus 사용
+- 순차 작성 (병렬 가능한 경우)
+- 검증 없이 완료
+
+</best_practices>

package/templates/.claude/{commands/docs-creator.md → skills/docs-creator/SKILL.md}

@@ -1,32 +1,18 @@
 ---
-description: Claude Code 문서 작성 가이드
-allowed-tools: Read, Write, Glob, Grep
-argument-hint: <document type: CLAUDE.md | SKILL.md | COMMAND.md>
+name: docs-creator
+description: Claude Code 문서 작성 가이드. CLAUDE.md, SKILL.md, COMMAND.md 등 효과적인 문서 작성 시 사용.
+metadata:
+  author: kood
+  version: "1.0.0"
 ---
 
-<critical_instruction>
+# Docs Creator Skill
 
-**CRITICAL: 사용자와의 모든 커뮤니케이션은 반드시 한국어로 작성하세요.**
-
-- 내부 사고와 분석은 영어로 해도 됨
-- 설명, 요약, 보고서, 피드백 등 사용자에게 전달하는 모든 내용은 반드시 한국어
-- 사용자가 영어로 말하더라도 답변은 한국어로
-- 진행 상황 업데이트와 상태 보고는 반드시 한국어
-
-이 규칙은 절대적이며 예외가 없습니다.
-
-</critical_instruction>
-
----
-
-
-# Docs Creator Command
-
-> Effectively create Claude Code documents (CLAUDE.md, SKILL.md, COMMAND.md) following Anthropic guidelines
+> Claude Code 문서 (CLAUDE.md, SKILL.md, COMMAND.md)를 Anthropic 가이드라인에 따라 효과적으로 작성
 
 <purpose>
 
-**Goal:** Create high-density, executable, maintainable documentation
+**목표:** 고밀도, 실행 가능한, 유지보수 가능한 문서 작성
 
 </purpose>
 
@@ -34,13 +20,13 @@ argument-hint: <document type: CLAUDE.md | SKILL.md | COMMAND.md>
 
 <trigger_conditions>
 
-| Situation | Create |
-|-----------|--------|
-| **New project** | Create CLAUDE.md |
-| **New skill** | Create SKILL.md |
-| **New command** | Create COMMAND.md |
-| **Missing docs** | Document project rules |
-| **Knowledge sharing** | Team onboarding guide |
+| 상황 | 작성 필요 |
+|------|----------|
+| **새 프로젝트** | CLAUDE.md 생성 |
+| **새 스킬** | SKILL.md 생성 |
+| **새 커맨드** | COMMAND.md 생성 |
+| **문서 부재** | 프로젝트 규칙 문서화 |
+| **지식 공유** | 팀 온보딩 가이드 |
 
 </trigger_conditions>
 
@@ -48,13 +34,13 @@ argument-hint: <document type: CLAUDE.md | SKILL.md | COMMAND.md>
 
 <forbidden>
 
-| Category | Prohibited |
-|----------|-----------|
-| **Description** | Verbose text, unnecessary content, duplication |
-| **Structure** | Complex without XML tags, vague instructions |
-| **Expression** | Negative instructions (Don't X → Do Y) |
-| **Complexity** | Complex conditionals, all edge cases |
-| **Emphasis** | Excessive (CRITICAL, MUST overuse) |
+| 분류 | 금지 사항 |
+|------|----------|
+| **설명** | 장황한 설명, 불필요한 텍스트, 중복 정보 |
+| **구조** | XML 태그 없는 복잡 구조, 모호한 지시 |
+| **표현** | 부정형 지시 (Don't X → Do Y) |
+| **복잡도** | 복잡한 조건문, 모든 엣지 케이스 |
+| **강조** | 과도한 강조 (CRITICAL, MUST 남발) |
 
 </forbidden>
 
@@ -62,14 +48,14 @@ argument-hint: <document type: CLAUDE.md | SKILL.md | COMMAND.md>
 
 <required>
 
-| Category | Required |
-|----------|----------|
-| **Structure** | XML tag sections, clear hierarchy |
-| **Expression** | Compressed tables, ✅/❌ markers |
-| **Examples** | Code-focused, copy-paste-ready patterns |
-| **Loading** | Just-in-time with @imports |
-| **Instructions** | Explicit, positive expression |
-| **Version** | Library versions specified |
+| 분류 | 필수 사항 |
+|------|----------|
+| **구조** | XML 태그 섹션 구분, 명확한 계층 |
+| **표현** | 표 형식 압축, ✅/❌ 마커 |
+| **예시** | 코드/예시 중심, 복사 가능 패턴 |
+| **로딩** | @imports로 just-in-time |
+| **지시** | 명시적 지시, 긍정형 표현 |
+| **버전** | 라이브러리 버전 명시 |
 
 </required>
 
@@ -77,40 +63,40 @@ argument-hint: <document type: CLAUDE.md | SKILL.md | COMMAND.md>
 
 <document_types>
 
-## CLAUDE.md - Project Rules
+## CLAUDE.md - 프로젝트 규칙
 
-**Usage:** Project-specific coding rules, forbidden/required items, quick reference
+**용도:** 프로젝트별 코딩 규칙, 금지/필수 사항, 빠른 참조
 
-**Structure:**
+**구조:**
 ```markdown
-# CLAUDE.md - [Project Name]
+# CLAUDE.md - [프로젝트명]
 
 <instructions>
 @path/to/common-rules.md
-@docs/library/[library]/index.md
+@docs/library/[라이브러리]/index.md
 </instructions>
 
 ---
 
 <forbidden>
-| Category | Forbidden |
-|----------|----------|
-| **Git** | AI indicators, emoji, multiple lines |
+| 분류 | 금지 |
+|------|------|
+| **Git** | AI 표시, 이모지, 여러 줄 |
 </forbidden>
 
 ---
 
 <required>
-| Category | Required |
-|----------|----------|
-| **Type** | Explicit return type |
+| 분류 | 필수 |
+|------|------|
+| **타입** | 명시적 return type |
 </required>
 
 ---
 
 <tech_stack>
-| Technology | Version | Note |
-|----------|---------|------|
+| 기술 | 버전 | 주의 |
+|------|------|------|
 | TypeScript | 5.x | strict |
 </tech_stack>
 
@@ -118,7 +104,7 @@ argument-hint: <document type: CLAUDE.md | SKILL.md | COMMAND.md>
 
 <quick_patterns>
 ```typescript
-// Copy-paste-ready pattern
+// 복사 가능한 패턴
 const example = () => { ... }
 ```
 </quick_patterns>
@@ -126,28 +112,28 @@ const example = () => { ... }
 
 ---
 
-## SKILL.md - Reusable Task
+## SKILL.md - 재사용 작업
 
-**Usage:** Define skill for specific task automation
+**용도:** 특정 작업 자동화 스킬 정의
 
-**Structure:**
+**구조:**
 ```markdown
 ---
 name: skill-name
-description: Brief description (1 line)
+description: 짧은 설명 (1줄)
 ---
 
 <trigger_conditions>
-| Keyword/Situation | Action |
-|------------------|--------|
-| "keyword" | Execute immediately |
+| 키워드/상황 | 반응 |
+|-----------|------|
+| "키워드" | 즉시 실행 |
 </trigger_conditions>
 
 ---
 
 <workflow>
 <step number="1">
-<action>Action description</action>
+<action>액션 설명</action>
 <tools>Tool1, Tool2</tools>
 </step>
 </workflow>
@@ -156,39 +142,39 @@ description: Brief description (1 line)
 
 <examples>
 ```typescript
-// Actual code
+// 실제 코드
 ```
 </examples>
 ```
 
 ---
 
-## COMMAND.md - CLI Command
+## COMMAND.md - CLI 커맨드
 
-**Usage:** Define slash command (/commit, /review)
+**용도:** 슬래시 커맨드 정의 (/commit, /review)
 
-**Structure:**
+**구조:**
 ```markdown
 ---
-description: Command description
+description: 커맨드 설명
 allowed-tools: Read, Edit, Bash
-argument-hint: <argument description>
+argument-hint: <인자 설명>
 ---
 
 <purpose>
-Specific goal
+구체적 목표
 </purpose>
 
 ---
 
 <workflow>
-Execution steps
+실행 단계
 </workflow>
 
 ---
 
 <examples>
-✅/❌ Comparison examples
+✅/❌ 비교 예시
 </examples>
 ```