@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.
- package/dist/index.js +117 -67
- package/package.json +1 -1
- package/templates/.claude/agents/build-fixer.md +371 -0
- package/templates/.claude/agents/critic.md +223 -0
- package/templates/.claude/agents/deep-executor.md +320 -0
- package/templates/.claude/agents/git-operator.md +15 -0
- package/templates/.claude/agents/planner.md +11 -7
- package/templates/.claude/agents/qa-tester.md +488 -0
- package/templates/.claude/agents/researcher.md +189 -0
- package/templates/.claude/agents/scientist.md +544 -0
- package/templates/.claude/agents/security-reviewer.md +549 -0
- package/templates/.claude/agents/tdd-guide.md +413 -0
- package/templates/.claude/agents/vision.md +165 -0
- package/templates/.claude/commands/pre-deploy.md +79 -2
- package/templates/.claude/instructions/agent-patterns/model-routing.md +2 -2
- package/templates/.claude/skills/brainstorm/SKILL.md +889 -0
- package/templates/.claude/skills/bug-fix/SKILL.md +69 -0
- package/templates/.claude/skills/crawler/SKILL.md +156 -0
- package/templates/.claude/skills/crawler/references/anti-bot-checklist.md +162 -0
- package/templates/.claude/skills/crawler/references/code-templates.md +119 -0
- package/templates/.claude/skills/crawler/references/crawling-patterns.md +167 -0
- package/templates/.claude/skills/crawler/references/document-templates.md +147 -0
- package/templates/.claude/skills/crawler/references/network-crawling.md +141 -0
- package/templates/.claude/skills/crawler/references/playwriter-commands.md +172 -0
- package/templates/.claude/skills/crawler/references/pre-crawl-checklist.md +221 -0
- package/templates/.claude/skills/crawler/references/selector-strategies.md +140 -0
- package/templates/.claude/skills/execute/SKILL.md +5 -0
- package/templates/.claude/skills/feedback/SKILL.md +570 -0
- package/templates/.claude/skills/figma-to-code/SKILL.md +1 -0
- package/templates/.claude/skills/global-uiux-design/SKILL.md +1 -0
- package/templates/.claude/skills/korea-uiux-design/SKILL.md +1 -0
- package/templates/.claude/skills/nextjs-react-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/plan/SKILL.md +44 -0
- package/templates/.claude/skills/ralph/SKILL.md +16 -18
- package/templates/.claude/skills/refactor/SKILL.md +19 -0
- 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/
|
|
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/
|
|
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/
|
|
728
|
+
**필수:** 세션 시작 시 `.claude/ralph/00.[작업명]/` 폴더 생성
|
|
729
729
|
|
|
730
730
|
```
|
|
731
|
-
.claude/ralph/
|
|
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
|
-
**폴더명 형식:** `
|
|
740
|
-
|
|
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/
|
|
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
|
|
1316
|
-
3. `cat .claude/ralph/
|
|
1317
|
-
4. `cat .claude/ralph/
|
|
1318
|
-
5. `cat .claude/ralph/
|
|
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/
|
|
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"
|