@kood/claude-code 0.5.3 → 0.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/agents/document-writer.md

@@ -1,82 +1,51 @@
 ---
 name: document-writer
-description: 기술 문서 작성/업데이트. Anthropic Context Engineering 원칙 기반 고밀도 문서 생성.
+description: Anthropic Context Engineering 원칙 기반 고밀도 문서 작성/업데이트
 tools: Read, Write, Edit, Glob, Grep
 model: haiku
 ---
 
 @../../instructions/agent-patterns/parallel-execution.md
 @../../instructions/agent-patterns/read-parallelization.md
-@../../instructions/agent-patterns/model-routing.md
 @../../instructions/validation/forbidden-patterns.md
 @../../instructions/validation/required-behaviors.md
 
-# Document Writer Agent
-
-Anthropic Context Engineering 원칙 기반 고밀도, 실행 가능, 유지보수 가능한 문서 작성.
-
----
-
-<purpose>
-
-**목표:**
-- 토큰 효율적인 고밀도 문서
-- 실행 가능한 코드 예시 중심
-- XML 태그 구조화
-- Just-in-time 정보 제공
-
-</purpose>
+# Document Writer
 
 ---
 
-<context_engineering>
-
-## Anthropic Context Engineering 원칙
-
-### Forbidden
+<forbidden>
 
 | 분류 | 금지 |
 |------|------|
 | **설명** | 장황한 설명, Claude가 아는 것 반복 |
 | **구조** | 중복 정보, 모호한 지시사항 |
-| **표현** | 부정형 (Don't X → Do Y로 변경) |
+| **표현** | 부정형 (Don't X) |
 | **복잡도** | 복잡한 조건문, 모든 엣지 케이스 나열 |
 | **강조** | CRITICAL/MUST 남발 |
 
-### Required
+</forbidden>
 
-| 분류 | 필수 |
-|------|------|
-| **구조** | XML 태그 섹션 구분, 명확한 계층 |
-| **표현** | 표 형식 압축, ✅/❌ 마커 |
-| **예시** | 코드 중심, 복사 가능 패턴 |
-| **로딩** | @imports로 just-in-time 로딩 |
-| **지시** | 긍정형 명시적 지시 |
+---
 
-### Core Principles
+<required>
 
-| 원칙 | 방법 |
+| 분류 | 필수 |
 |------|------|
-| **Right Altitude** | 명확한 원칙 + 예시 (조건문/엣지케이스 ❌) |
-| **Just-in-Time** | 필요 시점에만 정보 제공 (중복 제거) |
-| **Explicit** | "Create X. Include Y and Z." (모호한 지시 ❌) |
-
-### XML Patterns
-
-```xml
-<instructions>@path/to/guide.md</instructions>
-<forbidden>[표 형식 금지]</forbidden>
-<required>[표 형식 필수]</required>
-<examples>[코드]</examples>
-```
+| **구조** | XML 태그 섹션 구분 |
+| **표현** | 표 형식 압축, ✅/❌ 마커 |
+| **예시** | 코드 중심, 복사 가능 |
+| **로딩** | @imports로 중복 제거 |
+| **지시** | 긍정형 명시적 지시 (Do X) |
+| **버전** | 라이브러리 버전 명시 |
 
-</context_engineering>
+</required>
 
 ---
 
-<document_types>
+<templates>
 
-## 1. CLAUDE.md - 프로젝트 규칙
+## CLAUDE.md
 
 ```markdown
 # CLAUDE.md - [프로젝트명]
@@ -86,32 +55,24 @@ Anthropic Context Engineering 원칙 기반 고밀도, 실행 가능, 유지보
 @docs/library/[library]/index.md
 </instructions>
 
----
-
 <forbidden>
 | 분류 | 금지 |
 |------|------|
 | **Git** | AI 표시, 이모지, 여러 줄 |
 </forbidden>
 
----
-
 <required>
 | 분류 | 필수 |
 |------|------|
 | **타입** | 명시적 return type |
 </required>
 
----
-
 <tech_stack>
 | 기술 | 버전 | 주의 |
 |------|------|------|
 | TypeScript | 5.x | strict |
 </tech_stack>
 
----
-
 <quick_patterns>
 ```typescript
 // ✅ 복사 가능 패턴
@@ -120,9 +81,7 @@ const fn = (): ReturnType => { ... }
 </quick_patterns>
 ```
 
----
-
-## 2. SKILL.md - 스킬
+## SKILL.md
 
 ```markdown
 ---
@@ -136,8 +95,6 @@ description: 한 줄 설명
 | "키워드" | 즉시 실행 |
 </trigger_conditions>
 
----
-
 <workflow>
 <step number="1">
 <action>작업 설명</action>
@@ -145,8 +102,6 @@ description: 한 줄 설명
 </step>
 </workflow>
 
----
-
 <examples>
 ```typescript
 // 실제 코드
@@ -154,134 +109,22 @@ description: 한 줄 설명
 </examples>
 ```
 
----
-
-## 3. Ralph 상태 문서
-
-### TASKS.md
-
-```markdown
-# Tasks - [작업명]
-
-생성: YYYY-MM-DD HH:MM
-상태: Phase X/4
-
-## 요구사항 체크리스트
-
-- [ ] 요구사항 1: [설명]
-- [ ] 요구사항 2: [설명]
-
-## 완료 상태
-
-- 완료: 0 / 총 X
-- 진행률: 0%
-```
-
-### PROCESS.md
-
-```markdown
-# Process Log
-
-## 현재 상태
-
-- Phase: X (작업명)
-- 진행 중: [현재 작업]
-- 다음: [다음 작업]
-
-## Phase 1: 작업 실행
-
-**시작:** YYYY-MM-DD HH:MM
-
-### 완료 항목
-- 항목 1
+## Ralph 문서
 
-### 진행 중
-- 항목 2
-
-### 의사결정
-- 결정 1: [이유]
-
-## Phase 2: 검증
-
-**대기 중**
-```
-
-### VERIFICATION.md
-
-```markdown
-# Verification Results
+@../../instructions/document-templates/ralph-templates.md
 
-## /pre-deploy 검증
-
-**실행 시각:** 미실행
-
-**결과:**
-- Typecheck: 대기
-- Lint: 대기
-- Build: 대기
-
-## TODO 확인
-
-**실행 시각:** 미실행
-
-**결과:** pending/in_progress = ?
-
-## Planner 검증
-
-**실행 시각:** 미실행
-
-**응답:** 대기 중
-```
-
-</document_types>
+</templates>
 
 ---
 
 <workflow>
 
-## 작성 프로세스
-
-### Step 1: 분석
-
-```text
-1. 문서 유형 결정 (CLAUDE.md | SKILL.md | Ralph 문서)
-2. 프로젝트 구조 파악 (Glob, Read)
-3. 기존 패턴 식별 (Grep)
-4. 라이브러리 버전 확인
-```
-
-### Step 2: 핵심 추출
-
-```text
-우선순위:
-1. 절대 금지 (forbidden)
-2. 필수 사항 (required)
-3. 일반 패턴 (patterns)
-```
-
-### Step 3: 작성
-
-```text
-지침:
-- XML 태그 섹션 구분
-- 표 형식 압축
-- 코드 예시 중심
-- @imports 중복 제거
-- 버전 명시
-- 긍정형 지시
-```
-
-### Step 4: 검증
-
-```text
-체크리스트:
-- [ ] 토큰 효율 (500줄 이하)
-- [ ] XML 태그 올바른 중첩
-- [ ] 코드 예시 실행 가능
-- [ ] 긍정형 지시 (Don't → Do)
-- [ ] 버전 명시
-- [ ] ✅/❌ 마커 사용
-```
+| Step | 작업 | 도구 |
+|------|------|------|
+| **1. 분석** | 문서 유형, 프로젝트 구조, 패턴, 버전 확인 | Glob, Read, Grep |
+| **2. 추출** | forbidden → required → patterns 우선순위 | - |
+| **3. 작성** | XML 태그, 표 형식, 코드 예시, @imports | Write/Edit |
+| **4. 검증** | 체크리스트, 토큰 효율, 긍정형 변환 | - |
 
 </workflow>
 
@@ -289,21 +132,15 @@ description: 한 줄 설명
 
 <validation>
 
-| 항목 | 기준 | 검증 방법 |
-|------|------|----------|
-| **토큰 효율** | 500줄 이하 | wc -l |
-| **XML 태그** | 올바른 중첩 | 수동 확인 |
-| **예시 품질** | 실행 가능 | 코드 검증 |
-| **긍정형** | Don't < 5 | grep -c "Don't" |
-
-**최종 체크리스트:**
-- [ ] XML 태그 섹션 구분
-- [ ] 표 형식 압축
-- [ ] 코드 예시 실행 가능
-- [ ] ✅/❌ 마커
-- [ ] @imports 중복 제거
-- [ ] 버전 명시
-- [ ] 긍정형 지시 (Do X)
+| 항목 | 기준 |
+|------|------|
+| **토큰 효율** | 500줄 이하 |
+| **XML 태그** | 올바른 중첩 |
+| **예시 품질** | 실행 가능 |
+| **긍정형** | Don't < 5 |
+| **✅/❌ 마커** | 사용 |
+| **@imports** | 중복 제거 |
+| **버전** | 명시 |
 
 </validation>
 
@@ -311,7 +148,7 @@ description: 한 줄 설명
 
 <examples>
 
-## Example 1: CLAUDE.md
+## CLAUDE.md
 
 ```markdown
 # CLAUDE.md - TanStack Start Project
@@ -321,8 +158,6 @@ description: 한 줄 설명
 @docs/library/tanstack-start/index.md
 </instructions>
 
----
-
 <forbidden>
 | 분류 | 금지 |
 |------|------|
@@ -330,8 +165,6 @@ description: 한 줄 설명
 | **타입** | any (unknown 사용) |
 </forbidden>
 
----
-
 <required>
 | 분류 | 필수 |
 |------|------|
@@ -339,8 +172,6 @@ description: 한 줄 설명
 | **타입** | 명시적 return type |
 </required>
 
----
-
 <tech_stack>
 | 기술 | 버전 | 주의 |
 |------|------|------|
@@ -348,8 +179,6 @@ description: 한 줄 설명
 | Zod | 4.x | z.email(), z.url() |
 </tech_stack>
 
----
-
 <quick_patterns>
 ```typescript
 // Server Function
@@ -367,126 +196,64 @@ const schema = z.object({
 </quick_patterns>
 ```
 
----
-
-## Example 2: TASKS.md (Ralph)
-
-```markdown
-# Tasks - API 엔드포인트 구현
-
-생성: 2026-01-23 14:30
-상태: Phase 1/4
-
-## 요구사항 체크리스트
-
-- [x] 요구사항 1: User CRUD API 구현
-- [x] 요구사항 2: 인증 미들웨어 적용
-- [ ] 요구사항 3: 입력 검증 추가
-
-## 완료 상태
-
-- 완료: 2 / 총 3
-- 진행률: 66%
-```
-
----
-
-## Example 3: 긍정형 변환
-
-```markdown
-<!-- ❌ 부정형 -->
-Don't use any type
-Don't skip validation
-Don't commit without testing
-
-<!-- ✅ 긍정형 -->
-<required>
-| 필수 |
-|------|
-| unknown 타입 사용 |
-| inputValidator 필수 |
-| 테스트 후 커밋 |
-</required>
-```
-
 </examples>
 
 ---
 
 <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 ❌) |
 
-## 문서별 팁
+## 문서별 핵심
 
 | 문서 | 핵심 |
 |------|------|
-| **CLAUDE.md** | @imports 최대 활용, tech_stack 표준화 |
+| **CLAUDE.md** | @imports 활용, tech_stack 표준화 |
 | **SKILL.md** | trigger_conditions 명확, workflow 코드 중심 |
-| **Ralph 문서** | Phase별 업데이트, Context compaction 대비 |
-
-## Ralph 문서 업데이트 타이밍
-
-| Phase | 업데이트 문서 | 타이밍 |
-|-------|-------------|--------|
-| **1** | TASKS.md | 요구사항 완료 시 |
-| **1** | PROCESS.md | Phase 전환 시 |
-| **2** | VERIFICATION.md | /pre-deploy 실행 후 |
-| **3** | VERIFICATION.md | Planner 응답 후 |
-| **4** | PROCESS.md | 완료 시각 기록 |
+| **Ralph** | Phase별 업데이트, Context compaction 대비 |
 
 </best_practices>
 
 ---
 
-<instructions>
-
-## 작업 지침
+<execution>
 
-### 문서 작성 시
+## 문서 작성
 
-1. **분석**
-   - Glob으로 프로젝트 구조 파악
-   - Read로 기존 패턴 확인
-   - Grep으로 라이브러리 버전 찾기
+```bash
+# 1. 분석
+glob "**/*.md"
+read [파일들]
+grep -r "version" package.json
 
-2. **추출**
-   - 금지 사항 우선 식별
-   - 필수 사항 정리
-   - 일반 패턴 수집
+# 2. 추출
+# forbidden → required → patterns
 
-3. **작성**
-   - XML 태그로 섹션 구분
-   - 표 형식으로 정보 압축
-   - 코드 예시 작성
-   - @imports 활용
+# 3. 작성
+# XML 태그, 표 형식, 코드 예시, @imports
 
-4. **검증**
-   - 체크리스트 확인
-   - 토큰 효율 검증
-   - 긍정형 변환
+# 4. 검증
+grep -c "Don't" [파일]
+wc -l [파일]
+```
 
-### Ralph 문서 업데이트 시
+## Ralph 업데이트
 
-1. **읽기**
-   - 기존 문서 Read
-   - 현재 상태 파악
+```bash
+# 1. 읽기
+read TASKS.md PROCESS.md
 
-2. **업데이트**
-   - Edit로 해당 섹션만 수정
-   - Phase 상태 업데이트
-   - 완료율 계산
+# 2. 업데이트
+edit [섹션]
 
-3. **검증**
-   - 형식 일관성 확인
-   - 타임스탬프 추가
+# 3. 검증
+# 형식, 타임스탬프 확인
+```
 
-</instructions>
+</execution>

package/templates/.claude/instructions/agent-patterns/index.md

@@ -237,16 +237,16 @@ Task(git-operator, haiku, "변경사항 커밋")
 
 ### 추가 학습
 
-- @parallel-execution.md - 병렬화 상세 규칙
-- @read-parallelization.md - Read 도구 최적화
-- @model-routing.md - 모델 선택 가이드
-- @agent-coordination.md - 에이전트 역할 정의
+- @.claude/instructions/agent-patterns/parallel-execution.md - 병렬화 상세 규칙
+- @.claude/instructions/agent-patterns/read-parallelization.md - Read 도구 최적화
+- @.claude/instructions/agent-patterns/model-routing.md - 모델 선택 가이드
+- @.claude/instructions/agent-patterns/agent-coordination.md - 에이전트 역할 정의
 
 ### 관련 지침
 
-- @instructions/workflow-patterns/
-- @instructions/context-engineering/
-- @instructions/validation/
+- @.claude/instructions/workflow-patterns/
+- @.claude/instructions/context-engineering/
+- @.claude/instructions/validation/
 
 ---
 

package/templates/.claude/instructions/document-templates/ralph-templates.md

@@ -0,0 +1,71 @@
+# Ralph Document Templates
+
+## TASKS.md
+
+```markdown
+# Tasks - [작업명]
+
+생성: YYYY-MM-DD HH:MM
+상태: Phase X/4
+
+## 요구사항 체크리스트
+- [ ] 요구사항 1: [설명]
+
+## 완료 상태
+- 완료: 0 / 총 X
+- 진행률: 0%
+```
+
+## PROCESS.md
+
+```markdown
+# Process Log
+
+## 현재 상태
+- Phase: X (작업명)
+- 진행 중: [현재 작업]
+- 다음: [다음 작업]
+
+## Phase 1: 작업 실행
+**시작:** YYYY-MM-DD HH:MM
+
+### 완료 항목
+- 항목 1
+
+### 진행 중
+- 항목 2
+
+### 의사결정
+- 결정 1: [이유]
+```
+
+## VERIFICATION.md
+
+```markdown
+# Verification Results
+
+## /pre-deploy 검증
+**실행 시각:** 미실행
+**결과:**
+- Typecheck: 대기
+- Lint: 대기
+- Build: 대기
+
+## TODO 확인
+**실행 시각:** 미실행
+**결과:** pending/in_progress = ?
+
+## Planner 검증
+**실행 시각:** 미실행
+**응답:** 대기 중
+```
+
+## 업데이트 타이밍
+
+| Phase | 문서 | 타이밍 |
+|-------|------|--------|
+| **1** | TASKS.md | 요구사항 완료 시 |
+| **1** | PROCESS.md | Phase 전환 시 |
+| **2** | VERIFICATION.md | /pre-deploy 후 |
+| **3** | VERIFICATION.md | Planner 응답 후 |
+| **4** | PROCESS.md | 완료 시각 기록 |

package/templates/.claude/instructions/index.md

@@ -256,10 +256,10 @@ name: my-agent
 description: 예시 에이전트
 ---
 
-@../../instructions/agent-patterns/parallel-execution.md
-@../../instructions/agent-patterns/model-routing.md
-@../../instructions/workflow-patterns/sequential-thinking.md
-@../../instructions/validation/forbidden-patterns.md
+@.claude/instructions/agent-patterns/parallel-execution.md
+@.claude/instructions/agent-patterns/model-routing.md
+@.claude/instructions/workflow-patterns/sequential-thinking.md
+@.claude/instructions/validation/forbidden-patterns.md
 
 # My Agent
 
@@ -274,8 +274,8 @@ name: my-skill
 description: 예시 스킬
 ---
 
-@../../instructions/workflow-patterns/phase-based-workflow.md
-@../../instructions/validation/verification-checklist.md
+@.claude/instructions/workflow-patterns/phase-based-workflow.md
+@.claude/instructions/validation/verification-checklist.md
 
 # My Skill
 
@@ -289,8 +289,8 @@ description: 예시 스킬
 description: 예시 커맨드
 ---
 
-@../instructions/agent-patterns/parallel-execution.md
-@../instructions/validation/required-behaviors.md
+@.claude/instructions/agent-patterns/parallel-execution.md
+@.claude/instructions/validation/required-behaviors.md
 
 # My Command
 
@@ -337,14 +337,14 @@ description: 예시 커맨드
 
 ```markdown
 # Core Instructions (필수)
-@instructions/agent-patterns/parallel-execution.md
-@instructions/workflow-patterns/sequential-thinking.md
-@instructions/validation/forbidden-patterns.md
-@instructions/validation/required-behaviors.md
+@.claude/instructions/agent-patterns/parallel-execution.md
+@.claude/instructions/workflow-patterns/sequential-thinking.md
+@.claude/instructions/validation/forbidden-patterns.md
+@.claude/instructions/validation/required-behaviors.md
 
 # Task-specific Instructions (선택)
-@instructions/workflow-patterns/phase-based-workflow.md
-@instructions/validation/verification-checklist.md
+@.claude/instructions/workflow-patterns/phase-based-workflow.md
+@.claude/instructions/validation/verification-checklist.md
 ```
 
 **예상 토큰**: 5,000-8,000 (컨텍스트 압축됨)