@kood/claude-code 0.5.1 → 0.5.4

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

@@ -1,19 +1,21 @@
 ---
 name: docs-creator
-description: Claude Code 문서 작성 가이드. CLAUDE.md, SKILL.md, COMMAND.md 등 효과적인 문서 작성 시 사용.
+description: Claude Code 문서 작성. CLAUDE.md, SKILL.md, COMMAND.md 효율적 작성.
 metadata:
   author: kood
-  version: "1.0.0"
+  version: "2.0.0"
 ---
 
+@../../instructions/workflow-patterns/sequential-thinking.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
 # Docs Creator Skill
 
-> Claude Code 문서 (CLAUDE.md, SKILL.md, COMMAND.md)를 Anthropic 가이드라인에 따라 효과적으로 작성
+> Anthropic 가이드라인 기반 고밀도 문서 작성
 
 <purpose>
-
-**목표:** 고밀도, 실행 가능한, 유지보수 가능한 문서 작성
-
+고밀도, 실행 가능, 유지보수 가능한 문서 작성
 </purpose>
 
 ---
@@ -22,25 +24,104 @@ metadata:
 
 | 상황 | 작성 필요 |
 |------|----------|
-| **새 프로젝트** | CLAUDE.md 생성 |
-| **새 스킬** | SKILL.md 생성 |
-| **새 커맨드** | COMMAND.md 생성 |
-| **문서 부재** | 프로젝트 규칙 문서화 |
-| **지식 공유** | 팀 온보딩 가이드 |
+| **새 프로젝트** | CLAUDE.md |
+| **새 스킬** | SKILL.md |
+| **새 커맨드** | COMMAND.md |
 
 </trigger_conditions>
 
 ---
 
+<parallel_agent_execution>
+
+## 핵심 원칙
+
+| 원칙 | 방법 | 효과 |
+|------|------|------|
+| **PARALLEL** | 단일 메시지 여러 에이전트 호출 | 5-10배 속도 |
+| **DELEGATE** | 전문 에이전트 즉시 위임 | 품질 향상 |
+| **SMART MODEL** | 작업 복잡도별 모델 | 비용 최적화 |
+
+```typescript
+// ❌ 순차 (120초)
+Task(...) // 60초
+Task(...) // 60초
+
+// ✅ 병렬 (60초) - 단일 메시지
+Task(subagent_type="explore", model="haiku", prompt="...")
+Task(subagent_type="document-writer", model="haiku", prompt="...")
+```
+
+---
+
+## Phase별 활용
+
+| Phase | 작업 | 에이전트 | 모델 | 병렬 |
+|-------|------|---------|------|------|
+| **1** | 구조 파악 | explore | haiku | ✅ |
+| **1** | 규칙 추출 | analyst | sonnet | ✅ |
+| **2** | 문서 작성 | document-writer | haiku/sonnet | ✅ |
+| **3** | 검증 (복잡) | architect | opus | ✅ |
+
+---
+
+## 실전 패턴
+
+### 패턴 1: 다중 문서 동시 작성
+
+```typescript
+// CLAUDE.md + 3개 라이브러리 가이드 (60초)
+Task(subagent_type="document-writer", model="haiku",
+     prompt="CLAUDE.md 작성 - 프로젝트 규칙")
+Task(subagent_type="document-writer", model="haiku",
+     prompt="TanStack Start 가이드")
+Task(subagent_type="document-writer", model="haiku",
+     prompt="Prisma 가이드")
+Task(subagent_type="document-writer", model="haiku",
+     prompt="Zod 가이드")
+```
+
+**효과:** 순차 240초 → 병렬 60초 (4배)
+
+---
+
+### 패턴 2: 조사 + 작성 병렬
+
+```typescript
+// 탐색과 작성 동시
+Task(subagent_type="explore", model="haiku",
+     prompt="프로젝트 React Query 사용 패턴 조사")
+Task(subagent_type="document-writer", model="haiku",
+     prompt="React Query 가이드 초안 (버전 나중 추가)")
+
+// 탐색 결과로 버전 정보 추가
+Read(".../react-query-usage.md")
+Edit("docs/library/react-query/index.md", ...)
+```
+
+---
+
+### 모델 라우팅
+
+| 복잡도 | 모델 | 문서 | 비용 |
+|--------|------|------|------|
+| **LOW** | haiku | 간단 규칙, 반복 패턴 | 💰 |
+| **MEDIUM** | sonnet | CLAUDE.md, 라이브러리 가이드 | 💰💰 |
+| **HIGH** | opus | 아키텍처, 보안/성능 | 💰💰💰 |
+
+</parallel_agent_execution>
+
+---
+
 <forbidden>
 
-| 분류 | 금지 사항 |
-|------|----------|
-| **설명** | 장황한 설명, 불필요한 텍스트, 중복 정보 |
-| **구조** | XML 태그 없는 복잡 구조, 모호한 지시 |
-| **표현** | 부정형 지시 (Don't X → Do Y) |
-| **복잡도** | 복잡한 조건문, 모든 엣지 케이스 |
-| **강조** | 과도한 강조 (CRITICAL, MUST 남발) |
+| 분류 | 금지 |
+|------|------|
+| **설명** | 장황, 중복, Claude가 아는 것 반복 |
+| **구조** | XML 태그 없음, 모호한 지시 |
+| **표현** | 부정형 (Don't X → Do Y) |
+| **복잡도** | 조건문, 엣지 케이스 나열 |
+| **강조** | CRITICAL/MUST 남발 |
 
 </forbidden>
 
@@ -48,13 +129,13 @@ metadata:
 
 <required>
 
-| 분류 | 필수 사항 |
-|------|----------|
-| **구조** | XML 태그 섹션 구분, 명확한 계층 |
-| **표현** | 표 형식 압축, ✅/❌ 마커 |
-| **예시** | 코드/예시 중심, 복사 가능 패턴 |
-| **로딩** | @imports로 just-in-time |
-| **지시** | 명시적 지시, 긍정형 표현 |
+| 분류 | 필수 |
+|------|------|
+| **구조** | XML 태그 섹션, 명확한 계층 |
+| **표현** | 표 형식, ✅/❌ 마커 |
+| **예시** | 코드 중심, 복사 가능 |
+| **로딩** | @imports just-in-time |
+| **지시** | 긍정형, 명시적 |
 | **버전** | 라이브러리 버전 명시 |
 
 </required>
@@ -63,17 +144,14 @@ metadata:
 
 <document_types>
 
-## CLAUDE.md - 프로젝트 규칙
+## CLAUDE.md
 
-**용도:** 프로젝트별 코딩 규칙, 금지/필수 사항, 빠른 참조
-
-**구조:**
 ```markdown
 # CLAUDE.md - [프로젝트명]
 
 <instructions>
-@path/to/common-rules.md
-@docs/library/[라이브러리]/index.md
+@path/to/common.md
+@docs/library/[lib]/index.md
 </instructions>
 
 ---
@@ -81,7 +159,7 @@ metadata:
 <forbidden>
 | 분류 | 금지 |
 |------|------|
-| **Git** | AI 표시, 이모지, 여러 줄 |
+| **Git** | AI 표시, 이모지 |
 </forbidden>
 
 ---
@@ -104,28 +182,25 @@ metadata:
 
 <quick_patterns>
 ```typescript
-// 복사 가능한 패턴
-const example = () => { ... }
+// 복사 가능 패턴
+const fn = (): ReturnType => { ... }
 ```
 </quick_patterns>
 ```
 
 ---
 
-## SKILL.md - 재사용 작업
-
-**용도:** 특정 작업 자동화 스킬 정의
+## SKILL.md
 
-**구조:**
 ```markdown
 ---
 name: skill-name
-description: 짧은 설명 (1줄)
+description: 한 줄 설명
 ---
 
 <trigger_conditions>
-| 키워드/상황 | 반응 |
-|-----------|------|
+| 트리거 | 반응 |
+|--------|------|
 | "키워드" | 즉시 실행 |
 </trigger_conditions>
 
@@ -133,8 +208,8 @@ description: 짧은 설명 (1줄)
 
 <workflow>
 <step number="1">
-<action>액션 설명</action>
-<tools>Tool1, Tool2</tools>
+<action>작업</action>
+<tools>Tool1</tools>
 </step>
 </workflow>
 
@@ -142,23 +217,20 @@ description: 짧은 설명 (1줄)
 
 <examples>
 ```typescript
-// 실제 코드
+// 실행 가능 코드
 ```
 </examples>
 ```
 
 ---
 
-## COMMAND.md - CLI 커맨드
+## COMMAND.md
 
-**용도:** 슬래시 커맨드 정의 (/commit, /review)
-
-**구조:**
 ```markdown
 ---
 description: 커맨드 설명
-allowed-tools: Read, Edit, Bash
-argument-hint: <인자 설명>
+allowed-tools: Read, Edit
+argument-hint: <인자>
 ---
 
 <purpose>
@@ -174,7 +246,7 @@ argument-hint: <인자 설명>
 ---
 
 <examples>
-✅/❌ 비교 예시
+✅/❌ 비교
 </examples>
 ```
 
@@ -182,169 +254,14 @@ argument-hint: <인자 설명>
 
 ---
 
-<templates>
-
-## Template 1: CLAUDE.md
-
-```markdown
-# CLAUDE.md - [프로젝트명]
-
-<instructions>
-@.claude/instructions/git-rules.md
-@docs/library/react/index.md
-</instructions>
-
----
-
-<forbidden>
-| 분류 | 금지 |
-|------|------|
-| **Git** | AI 표시, 이모지 |
-| **타입** | any (unknown 사용) |
-</forbidden>
-
----
-
-<required>
-| 분류 | 필수 |
-|------|------|
-| **함수** | const 선언, 명시적 return type |
-| **Import** | 절대 경로 (@/) |
-</required>
-
----
-
-<quick_patterns>
-```typescript
-// ✅ 올바른 패턴
-const fetchUser = async (id: string): Promise<User> => {
-  return await prisma.user.findUnique({ where: { id } })
-}
-
-// ❌ 잘못된 패턴
-function fetchUser(id) { ... }
-```
-</quick_patterns>
-```
-
----
-
-## Template 2: SKILL.md
-
-```markdown
----
-name: test-runner
-description: 테스트 실행 및 실패 수정
----
-
-<trigger_conditions>
-| 트리거 | 반응 |
-|--------|------|
-| 코드 수정 완료 | 자동 실행 |
-| "테스트 실행" | 즉시 실행 |
-</trigger_conditions>
-
----
-
-<forbidden>
-| 금지 |
-|------|
-| 테스트 삭제로 통과, 테스트 없이 완료 |
-</forbidden>
-
----
-
-<required>
-| 필수 |
-|------|
-| 모든 테스트 통과, 실패 원인 설명 |
-</required>
-
----
-
-<workflow>
-<step number="1">
-<action>테스트 실행</action>
-<tools>Bash</tools>
-<command>npm test</command>
-</step>
-
-<step number="2">
-<action>실패 분석</action>
-<tools>Read</tools>
-</step>
-
-<step number="3">
-<action>코드 수정</action>
-<tools>Edit</tools>
-</step>
-
-<step number="4">
-<action>재실행</action>
-<criteria>모든 테스트 통과</criteria>
-</step>
-</workflow>
-
----
-
-<examples>
-```typescript
-// ❌ 버그
-const sum = (a: number, b: number) => a - b
-
-// ✅ 수정
-const sum = (a: number, b: number) => a + b
-```
-</examples>
-```
-
-</templates>
-
----
-
 <workflow>
 
-<step number="1">
-<action>문서 유형 결정 및 프로젝트 분석</action>
-<output>
-- CLAUDE.md | SKILL.md | COMMAND.md 선택
-- 프로젝트 구조 파악 (Glob, Read)
-- 기존 패턴 식별 (Grep)
-- 라이브러리 버전 확인
-</output>
-</step>
-
-<step number="2">
-<action>핵심 규칙 추출</action>
-<priority>
-1. 절대 금지 사항 (forbidden)
-2. 필수 사항 (required)
-3. 일반적 패턴 (patterns)
-</priority>
-</step>
-
-<step number="3">
-<action>템플릿 선택 및 작성</action>
-<guidelines>
-- XML 태그로 섹션 구분
-- 표 형식으로 정보 압축
-- 코드 예시 중심
-- @imports로 공통 규칙 분리
-- 버전 명시
-</guidelines>
-</step>
-
-<step number="4">
-<action>품질 검증</action>
-<checklist>
-- [ ] 토큰 효율 (500줄 이하)
-- [ ] XML 태그 올바른 중첩
-- [ ] 코드 예시 실행 가능
-- [ ] 긍정형 지시 (Don't → Do)
-- [ ] 버전 명시
-- [ ] ✅/❌ 마커 사용
-</checklist>
-</step>
+| Step | 작업 | 도구 |
+|------|------|------|
+| **1** | 유형 결정, 구조 파악 | Glob, Read |
+| **2** | 규칙 추출 (forbidden → required → patterns) | Grep |
+| **3** | 작성 (XML 태그, 표, 코드, @imports) | Write |
+| **4** | 검증 (체크리스트) | - |
 
 </workflow>
 
@@ -352,19 +269,14 @@ const sum = (a: number, b: number) => a + b
 
 <examples>
 
-### Example 1: TanStack Start CLAUDE.md
-
-**상황:** 새 TanStack Start 프로젝트, Prisma + Zod 사용
+## TanStack Start CLAUDE.md
 
-**작성 결과:**
 ```markdown
-# CLAUDE.md - TanStack Start Project
+# CLAUDE.md - TanStack Start
 
 <instructions>
 @.claude/instructions/git-rules.md
 @docs/library/tanstack-start/index.md
-@docs/library/prisma/index.md
-@docs/library/zod/index.md
 </instructions>
 
 ---
@@ -373,7 +285,6 @@ const sum = (a: number, b: number) => a + b
 | 분류 | 금지 |
 |------|------|
 | **API** | `/api` 라우터 (명시 요청 제외) |
-| **Server Function** | handler 내부 수동 검증/인증 |
 | **타입** | any (unknown 사용) |
 </forbidden>
 
@@ -383,7 +294,6 @@ const sum = (a: number, b: number) => a + b
 | 분류 | 필수 |
 |------|------|
 | **Server Function** | POST/PUT → inputValidator + middleware |
-| **클라이언트** | Server Function → TanStack Query |
 | **타입** | 명시적 return type |
 </required>
 
@@ -392,7 +302,6 @@ const sum = (a: number, b: number) => a + b
 <tech_stack>
 | 기술 | 버전 | 주의 |
 |------|------|------|
-| TanStack Start | 최신 | File-based routing |
 | Prisma | 7.x | prisma-client, output 필수 |
 | Zod | 4.x | z.email(), z.url() |
 </tech_stack>
@@ -401,7 +310,7 @@ const sum = (a: number, b: number) => a + b
 
 <quick_patterns>
 ```typescript
-// Server Function (POST + Validation + Auth)
+// Server Function
 export const createUser = createServerFn({ method: 'POST' })
   .middleware([authMiddleware])
   .inputValidator(createUserSchema)
@@ -412,17 +321,10 @@ const schema = z.object({
   email: z.email(),
   website: z.url().optional(),
 })
-
-// TanStack Query
-const mutation = useMutation({
-  mutationFn: createUser,
-  onSuccess: () => queryClient.invalidateQueries({ queryKey: ['users'] }),
-})
 ```
 </quick_patterns>
 ```
 
-
 </examples>
 
 ---
@@ -431,10 +333,10 @@ const mutation = useMutation({
 
 | 항목 | 기준 | 검증 |
 |------|------|------|
-| **토큰 효율** | 500줄 이하 | `wc -l` |
-| **XML 태그** | 올바른 중첩 | `grep -o '<[^>]*>'` |
-| **예시 품질** | 실행 가능 | 테스트 |
-| **긍정형** | Don't < 5 | `grep -c "Don't"` |
+| **토큰** | 500줄 이하 | wc -l |
+| **XML** | 올바른 중첩 | 수동 |
+| **예시** | 실행 가능 | 테스트 |
+| **긍정형** | Don't < 5 | grep -c |
 
 **체크리스트:**
 - [ ] XML 태그 섹션 구분
@@ -451,32 +353,22 @@ const mutation = useMutation({
 
 <best_practices>
 
-## 작성 원칙
-
 | 원칙 | 방법 |
 |------|------|
-| **Show, Don't Tell** | 설명보다 코드 예시 |
-| **High Density** | 1줄당 최대 정보 압축 |
-| **Copy-Paste Ready** | 바로 사용 가능한 패턴 |
-| **Version Explicit** | 라이브러리 버전 명시 |
-| **Positive Language** | "Do X" > "Don't Y" |
+| **Show, Don't Tell** | 설명 < 코드 |
+| **High Density** | 1줄당 최대 정보 |
+| **Copy-Paste Ready** | 바로 사용 가능 |
+| **Version Explicit** | 버전 명시 |
+| **Positive Language** | Do X > Don't Y |
 
 ## 일반적 실수
 
 | 실수 | 올바른 방법 |
 |------|------------|
-| 장황한 설명 | 표 형식 + 코드 예시 |
-| XML 태그 없음 | 모든 섹션 태그 구분 |
-| 추상적 예시 | 실행 가능한 코드 |
-| 중복 정보 | @imports 분리 |
-| 버전 누락 | 모든 라이브러리 버전 명시 |
-
-## 문서별 팁
-
-| 문서 | 핵심 |
-|------|------|
-| **CLAUDE.md** | @imports 최대 활용, tech_stack 표준화 |
-| **SKILL.md** | trigger_conditions 명확, workflow 코드 중심 |
-| **COMMAND.md** | purpose 간결, workflow 실행 가능 코드 |
+| 장황한 설명 | 표 + 코드 |
+| XML 태그 없음 | 섹션 태그 구분 |
+| 추상적 예시 | 실행 가능 코드 |
+| 중복 정보 | @imports |
+| 버전 누락 | 버전 명시 |
 
 </best_practices>