@kood/claude-code 0.5.10 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/dist/index.js +117 -67
  2. package/package.json +1 -1
  3. package/templates/.claude/agents/build-fixer.md +371 -0
  4. package/templates/.claude/agents/critic.md +223 -0
  5. package/templates/.claude/agents/deep-executor.md +320 -0
  6. package/templates/.claude/agents/git-operator.md +15 -0
  7. package/templates/.claude/agents/planner.md +11 -7
  8. package/templates/.claude/agents/qa-tester.md +488 -0
  9. package/templates/.claude/agents/researcher.md +189 -0
  10. package/templates/.claude/agents/scientist.md +544 -0
  11. package/templates/.claude/agents/security-reviewer.md +549 -0
  12. package/templates/.claude/agents/tdd-guide.md +413 -0
  13. package/templates/.claude/agents/vision.md +165 -0
  14. package/templates/.claude/commands/pre-deploy.md +79 -2
  15. package/templates/.claude/instructions/agent-patterns/model-routing.md +2 -2
  16. package/templates/.claude/skills/brainstorm/SKILL.md +889 -0
  17. package/templates/.claude/skills/bug-fix/SKILL.md +69 -0
  18. package/templates/.claude/skills/crawler/SKILL.md +156 -0
  19. package/templates/.claude/skills/crawler/references/anti-bot-checklist.md +162 -0
  20. package/templates/.claude/skills/crawler/references/code-templates.md +119 -0
  21. package/templates/.claude/skills/crawler/references/crawling-patterns.md +167 -0
  22. package/templates/.claude/skills/crawler/references/document-templates.md +147 -0
  23. package/templates/.claude/skills/crawler/references/network-crawling.md +141 -0
  24. package/templates/.claude/skills/crawler/references/playwriter-commands.md +172 -0
  25. package/templates/.claude/skills/crawler/references/pre-crawl-checklist.md +221 -0
  26. package/templates/.claude/skills/crawler/references/selector-strategies.md +140 -0
  27. package/templates/.claude/skills/execute/SKILL.md +5 -0
  28. package/templates/.claude/skills/feedback/SKILL.md +570 -0
  29. package/templates/.claude/skills/figma-to-code/SKILL.md +1 -0
  30. package/templates/.claude/skills/global-uiux-design/SKILL.md +1 -0
  31. package/templates/.claude/skills/korea-uiux-design/SKILL.md +1 -0
  32. package/templates/.claude/skills/nextjs-react-best-practices/SKILL.md +1 -0
  33. package/templates/.claude/skills/plan/SKILL.md +44 -0
  34. package/templates/.claude/skills/ralph/SKILL.md +16 -18
  35. package/templates/.claude/skills/refactor/SKILL.md +19 -0
  36. package/templates/.claude/skills/tanstack-start-react-best-practices/SKILL.md +1 -0
@@ -66,7 +66,7 @@ while (true) {
66
66
 
67
67
  **하나라도 실패 → ITERATION++ → Phase 1로 복귀**
68
68
 
69
- ### 상태 문서 (`.claude/ralph/{{SESSION}}/`)
69
+ ### 상태 문서 (`.claude/ralph/00.[작업명]/`)
70
70
 
71
71
  | 파일 | 역할 | 업데이트 시점 |
72
72
  |------|------|--------------|
@@ -114,7 +114,7 @@ while (true) {
114
114
  | 2 | 코드 검증 | **새로 실행한** `/pre-deploy` 결과 | typecheck/lint/build 모두 통과 |
115
115
  | 3 | TODO 확인 | **새로 실행한** TaskList 조회 | pending/in_progress = 0 |
116
116
  | 4 | 플래너 검증 | **새로 생성한** Planner 에이전트 호출 | "승인" 응답 |
117
- | 5 | 상태 정리 | `.claude/ralph/` 상태 문서 최종 업데이트 | 완료 시각 기록 |
117
+ | 5 | 상태 정리 | `.claude/ralph/00.[작업명]/` 상태 문서 최종 업데이트 | 완료 시각 기록 |
118
118
 
119
119
  **모든 5단계 통과 후에만 `<promise>` 출력. 하나라도 실패 시 루프 재개.**
120
120
 
@@ -157,7 +157,7 @@ Task(subagent_type="planner", model="opus", ...) // 새로 검증
157
157
 
158
158
  ### 상태 문서 정리
159
159
 
160
- 완료 직전 `.claude/ralph/{{SESSION}}/` 최종 업데이트:
160
+ 완료 직전 `.claude/ralph/00.[작업명]/` 최종 업데이트:
161
161
  - TASKS.md: 모든 체크박스 완료
162
162
  - PROCESS.md: 완료 시각, 총 소요 시간
163
163
  - VERIFICATION.md: 최종 검증 결과
@@ -725,10 +725,10 @@ Task(subagent_type="ko-to-en-translator", model="haiku",
725
725
 
726
726
  ### 문서화 폴더 구조
727
727
 
728
- **필수:** 세션 시작 시 `.claude/ralph/{{YYMMDD}}-{{N}}-{{작업명}}/` 폴더 생성
728
+ **필수:** 세션 시작 시 `.claude/ralph/00.[작업명]/` 폴더 생성
729
729
 
730
730
  ```
731
- .claude/ralph/260129-01-사용자_인증_구현/
731
+ .claude/ralph/00.사용자_인증_구현/
732
732
  ├── TASKS.md # 작업 체크리스트
733
733
  ├── PROCESS.md # 진행 단계 및 의사결정
734
734
  ├── VERIFICATION.md # 검증 결과 기록 (매 반복마다 업데이트)
@@ -736,10 +736,8 @@ Task(subagent_type="ko-to-en-translator", model="haiku",
736
736
  └── NOTES.md # 추가 메모
737
737
  ```
738
738
 
739
- **폴더명 형식:** `YYMMDD-N-작업명` (날짜 + 시퀀스 + 한글 설명)
740
- - 날짜: 오늘 날짜 (YYMMDD)
741
- - 시퀀스: 같은 날 여러 세션 시 증가 (01, 02, 03...)
742
- - 작업명: 한글 설명 (언더스코어로 구분)
739
+ **폴더명 형식:** `00.[작업명]` (넘버링 + 한글 설명, 언더스코어로 구분)
740
+ **넘버링:** 기존 ralph 폴더 목록 조회 → 다음 번호 자동 부여 (00, 01, 02...)
743
741
 
744
742
  **생성 시점:** Ralph 루프 진입 즉시 (첫 반복 시작 전)
745
743
 
@@ -908,7 +906,7 @@ Context compaction 후 세션 재개 시:
908
906
 
909
907
  ```text
910
908
  1. pwd 실행 → 작업 디렉토리 확인
911
- 2. ls .claude/ralph/ → 최신 세션 폴더 식별 (가장 큰 번호)
909
+ 2. ls .claude/ralph/ → 최신 세션 폴더 식별 (가장 큰 넘버링)
912
910
  3. TASKS.md 읽기 → 요구사항 및 진행 상태 파악
913
911
  4. PROCESS.md 읽기 → 현재 Phase 및 다음 단계 확인
914
912
  5. VERIFICATION.md 읽기 → 검증 결과 확인
@@ -928,7 +926,7 @@ Context compaction 후 세션 재개 시:
928
926
 
929
927
  ```text
930
928
  1. 원본 작업 요구사항 분석
931
- 2. 넘버링 결정 (ls .claude/ralph/)
929
+ 2. 넘버링 결정 (ls .claude/ralph/ → 다음 번호 자동 부여)
932
930
  3. .claude/ralph/00.[작업명]/ 폴더 생성 (한글 설명)
933
931
  4. TASKS.md 작성 (체크리스트)
934
932
  5. PROCESS.md 작성 (Phase 1 시작 기록)
@@ -1275,8 +1273,8 @@ Task(subagent_type="code-reviewer", model="opus", ...)
1275
1273
 
1276
1274
  **즉시 실행 (순차):**
1277
1275
  1. 원본 작업(`{{PROMPT}}`) 읽기
1278
- 2. 세션 폴더 생성: `.claude/ralph/{{YYMMDD}}-{{N}}-{{작업명}}/`
1279
- - `ls .claude/ralph/` → 오늘 날짜 폴더 찾기 → 다음 시퀀스 결정
1276
+ 2. 세션 폴더 생성: `.claude/ralph/00.[작업명]/`
1277
+ - `ls .claude/ralph/` → 기존 폴더 조회 → 다음 넘버링 결정
1280
1278
  3. 상태 문서 초기화 (병렬):
1281
1279
  ```typescript
1282
1280
  Task(subagent_type="document-writer", model="haiku",
@@ -1312,10 +1310,10 @@ Task(subagent_type="code-reviewer", model="opus", ...)
1312
1310
 
1313
1311
  **복구 프로토콜 (순차):**
1314
1312
  1. `pwd` → 작업 디렉토리 확인
1315
- 2. `ls -lt .claude/ralph/` → 최신 세션 폴더 찾기 (날짜순 정렬)
1316
- 3. `cat .claude/ralph/{{SESSION}}/ITERATION.md` → 반복 히스토리 확인
1317
- 4. `cat .claude/ralph/{{SESSION}}/VERIFICATION.md` → 마지막 검증 결과
1318
- 5. `cat .claude/ralph/{{SESSION}}/TASKS.md` → 미완료 항목
1313
+ 2. `ls .claude/ralph/` → 최신 세션 폴더 찾기 (가장 큰 넘버링)
1314
+ 3. `cat .claude/ralph/00.[작업명]/ITERATION.md` → 반복 히스토리 확인
1315
+ 4. `cat .claude/ralph/00.[작업명]/VERIFICATION.md` → 마지막 검증 결과
1316
+ 5. `cat .claude/ralph/00.[작업명]/TASKS.md` → 미완료 항목
1319
1317
  6. `git log --oneline -10` → 최근 커밋
1320
1318
  7. 현재 Iteration 번호 식별 후 루프 재개
1321
1319
 
@@ -1440,7 +1438,7 @@ Task(subagent_type="planner", ...) // Iteration N에서 새로 생성
1440
1438
 
1441
1439
  ### 6. 문서 = 루프 지속성
1442
1440
 
1443
- `.claude/ralph/{{SESSION}}/` 상태 문서:
1441
+ `.claude/ralph/00.[작업명]/` 상태 문서:
1444
1442
  - TASKS.md: 요구사항 체크리스트
1445
1443
  - PROCESS.md: Phase 진행 상황
1446
1444
  - VERIFICATION.md: 매 반복 검증 결과
@@ -161,6 +161,8 @@ $ARGUMENTS 있음 → 다음 단계 진행
161
161
  | **@analyst** | sonnet | 코드 메트릭 분석, 엣지 케이스 검증 |
162
162
  | **@explore** | haiku | 코드베이스 탐색, 의존성 파악 |
163
163
  | **@document-writer** | haiku/sonnet | 리팩토링 계획 및 결과 문서화 |
164
+ | **@security-reviewer** | opus | 리팩토링 후 보안 취약점 검증 |
165
+ | **@build-fixer** | sonnet | 리팩토링 후 빌드/타입 오류 수정 |
164
166
 
165
167
  ### 병렬 실행 패턴
166
168
 
@@ -314,6 +316,23 @@ Task({
314
316
  })
315
317
  ```
316
318
 
319
+ #### 5-1. 리팩토링 후 보안 + 빌드 검증 병렬
320
+
321
+ ```typescript
322
+ // ✅ 리팩토링 후 보안 + 빌드 검증 병렬
323
+ Task({
324
+ subagent_type: "security-reviewer",
325
+ model: "opus",
326
+ prompt: "리팩토링 후 보안 취약점 검토"
327
+ })
328
+
329
+ Task({
330
+ subagent_type: "build-fixer",
331
+ model: "sonnet",
332
+ prompt: "리팩토링으로 발생한 빌드/타입 오류 수정"
333
+ })
334
+ ```
335
+
317
336
  #### 6. 점진적 마이그레이션 병렬화
318
337
 
319
338
  ```typescript
@@ -2,6 +2,7 @@
2
2
  name: tanstack-start-react-best-practices
3
3
  description: TanStack Start와 React 성능 최적화 가이드. React 컴포넌트, TanStack Start 페이지 작성/리뷰/리팩토링 시 최적 성능 패턴 보장. React 컴포넌트, TanStack Router 라우트, 데이터 페칭, 번들 최적화, 성능 개선 작업에 트리거.
4
4
  license: MIT
5
+ framework: tanstack-start
5
6
  metadata:
6
7
  author: vercel
7
8
  version: "1.0.0"