@choblue/claude-code-toolkit 1.2.5 → 1.2.6
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/.claude/.project-map-cache +1 -1
- package/.claude/CLAUDE.md +22 -0
- package/.claude/prompts/feature.md +11 -0
- package/.claude/prompts/fix.md +11 -0
- package/.claude/prompts/review.md +7 -0
- package/.claude/skills/Curation/SKILL.md +36 -0
- package/.claude/skills/FailureRecovery/SKILL.md +47 -0
- package/README.md +10 -2
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
|
|
1
|
+
661df17b80c1e5d15cac0feb533ca658c67a5155
|
package/.claude/CLAUDE.md
CHANGED
|
@@ -55,6 +55,21 @@ Step 4: 수정/삭제 → 확인
|
|
|
55
55
|
|
|
56
56
|
---
|
|
57
57
|
|
|
58
|
+
## 2-1. 완료 기준 (Definition of Done)
|
|
59
|
+
|
|
60
|
+
각 작업 단위는 다음 조건을 **모두 만족**해야 "완료"로 판단한다.
|
|
61
|
+
에이전트는 구현 후 이 체크리스트를 자체 검증한다.
|
|
62
|
+
|
|
63
|
+
### 공통 DoD
|
|
64
|
+
- [ ] 타입 에러 없음 (`tsc --noEmit` 통과)
|
|
65
|
+
- [ ] 미사용 import/변수 없음
|
|
66
|
+
- [ ] 기존 테스트가 깨지지 않음
|
|
67
|
+
- [ ] 기존 프로젝트 패턴과 일관성 유지
|
|
68
|
+
|
|
69
|
+
> FE/BE별 추가 DoD는 프로젝트 루트 `CLAUDE.md`에서 오버라이드한다.
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
58
73
|
## 3. 티어별 워크플로우
|
|
59
74
|
|
|
60
75
|
### S 티어 (trivial)
|
|
@@ -111,6 +126,13 @@ TDD/Review를 생략하고 핵심 단계만 수행한다.
|
|
|
111
126
|
- `.claude/skills/DDD/SKILL.md` - DDD 전술적 패턴 (Entity, VO, Aggregate, Repository, Domain Event)
|
|
112
127
|
- `.claude/skills/Planning/SKILL.md` - 작업 계획 (티어 판단, 작업 분해, 의존성 확인)
|
|
113
128
|
- `.claude/skills/Git/SKILL.md` - Git 커밋/PR/브랜치 규칙
|
|
129
|
+
- `.claude/skills/FailureRecovery/SKILL.md` - 실패 복구 프로토콜 (진단, 처방, 에스컬레이션)
|
|
130
|
+
- `.claude/skills/Curation/SKILL.md` - AI 결과물 큐레이션 체크리스트
|
|
131
|
+
|
|
132
|
+
### Prompts (커스텀 커맨드)
|
|
133
|
+
- `.claude/prompts/feature.md` - /feature [기능명] -> 새 기능 구현 시작
|
|
134
|
+
- `.claude/prompts/fix.md` - /fix [증상] -> 버그 수정
|
|
135
|
+
- `.claude/prompts/review.md` - /review -> 현재 변경사항 리뷰
|
|
114
136
|
|
|
115
137
|
### Scripts
|
|
116
138
|
- `.claude/scripts/generate-project-map.sh` - PROJECT_MAP.md 자동 생성
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: curation
|
|
3
|
+
description: AI 결과물의 품질을 인간 관점에서 검증하는 체크리스트. code-reviewer 에이전트가 참조하거나, 사용자가 직접 리뷰할 때 활용한다.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Curation Skill
|
|
7
|
+
|
|
8
|
+
AI가 만든 80점짜리 결과물에서 나머지 20점을 채우기 위한 인간 리뷰 관점.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. 코드 큐레이션 체크리스트
|
|
13
|
+
|
|
14
|
+
### 자연스러움 (AI스러움 제거)
|
|
15
|
+
- [ ] 불필요하게 과한 주석이 없는가 (모든 줄에 주석 금지)
|
|
16
|
+
- [ ] 변수명이 지나치게 장황하지 않은가
|
|
17
|
+
- [ ] 사용하지 않는 예외 처리가 없는가 (방어적 코딩 과잉)
|
|
18
|
+
- [ ] 기존 코드베이스의 톤과 맞는가
|
|
19
|
+
|
|
20
|
+
### 실용성
|
|
21
|
+
- [ ] 실제로 사용될 엣지 케이스만 처리하는가 (과잉 방어 금지)
|
|
22
|
+
- [ ] 추상화 수준이 적절한가 (너무 이르거나 과한 추상화 금지)
|
|
23
|
+
- [ ] import가 실제로 존재하는 모듈을 참조하는가
|
|
24
|
+
- [ ] 하드코딩된 값이 없는가 (환경변수, 상수로 분리)
|
|
25
|
+
|
|
26
|
+
### 일관성
|
|
27
|
+
- [ ] 기존 파일들과 디렉토리 위치가 맞는가
|
|
28
|
+
- [ ] 네이밍 패턴이 주변 코드와 통일되는가
|
|
29
|
+
- [ ] 에러 핸들링 방식이 프로젝트 관례와 맞는가
|
|
30
|
+
|
|
31
|
+
## 2. 리뷰 우선순위
|
|
32
|
+
|
|
33
|
+
1. **먼저 빌드/테스트 통과** 확인 (자동화 가능)
|
|
34
|
+
2. **비즈니스 로직 정확성** -- 요구사항과 일치하는지
|
|
35
|
+
3. **기존 패턴 일관성** -- 프로젝트 컨벤션을 따르는지
|
|
36
|
+
4. **AI스러움 제거** -- 과잉 주석, 과잉 방어, 불필요한 추상화
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: failure-recovery
|
|
3
|
+
description: 에이전트가 잘못된 결과를 냈을 때의 디버깅 및 재시도 프로토콜. 단순 재실행이 아닌 원인 분석 후 처방한다.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Failure Recovery Skill
|
|
7
|
+
|
|
8
|
+
에이전트 결과물이 기대와 다를 때, "다시 해"가 아닌 **원인 진단 -> 처방 -> 재시도** 사이클을 따른다.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. 실패 분류 및 처방
|
|
13
|
+
|
|
14
|
+
| 유형 | 증상 | 처방 |
|
|
15
|
+
|------|------|------|
|
|
16
|
+
| **방향 오류** | 요구사항과 전혀 다른 결과 | 요구사항을 재정의하고 배경 컨텍스트 보강 |
|
|
17
|
+
| **패턴 불일치** | 동작은 하지만 기존 코드와 스타일이 다름 | 참조할 기존 파일 경로를 명시적으로 전달 |
|
|
18
|
+
| **부분 구현** | 일부만 되고 나머지가 빠짐 | 작업을 더 작은 단위로 재분해 |
|
|
19
|
+
| **타입/런타임 에러** | 빌드 실패, 런타임 크래시 | 에러 메시지 + 관련 타입/인터페이스를 함께 전달 |
|
|
20
|
+
| **반복 실패** | 같은 에러를 2회 이상 반복 | 접근 방식 자체를 변경하거나 사용자에게 에스컬레이션 |
|
|
21
|
+
|
|
22
|
+
## 2. 재시도 프로토콜
|
|
23
|
+
|
|
24
|
+
### Step 1: 진단 (바로 "다시 해" 금지)
|
|
25
|
+
```
|
|
26
|
+
실패 진단:
|
|
27
|
+
- 기대한 결과: [구체적으로]
|
|
28
|
+
- 실제 결과: [구체적으로]
|
|
29
|
+
- 차이 원인: 방향 오류 / 패턴 불일치 / 부분 구현 / 에러
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### Step 2: 처방
|
|
33
|
+
- 방향 오류 -> 요구사항 문서를 수정하고 재전달
|
|
34
|
+
- 패턴 불일치 -> "X파일의 패턴을 따라서" 참조 경로 추가
|
|
35
|
+
- 부분 구현 -> 빠진 부분만 별도 작업으로 분리
|
|
36
|
+
- 에러 -> 에러 메시지 + 관련 타입/인터페이스를 함께 전달
|
|
37
|
+
|
|
38
|
+
### Step 3: 재시도
|
|
39
|
+
- 처방 내용을 프롬프트에 반영하여 재호출
|
|
40
|
+
- 동일 실패 2회 반복 시 -> 접근 방식 자체를 변경하거나 사용자에게 에스컬레이션
|
|
41
|
+
|
|
42
|
+
## 3. 에스컬레이션 기준
|
|
43
|
+
|
|
44
|
+
다음 중 하나라도 해당하면 사용자에게 판단을 요청한다:
|
|
45
|
+
- 동일 유형 실패가 2회 반복
|
|
46
|
+
- 처방 후에도 새로운 유형의 에러 발생
|
|
47
|
+
- 아키텍처/설계 수준의 변경이 필요한 경우
|
package/README.md
CHANGED
|
@@ -53,8 +53,16 @@
|
|
|
53
53
|
│ │ ├── SKILL.md ← TDD 핵심 원칙
|
|
54
54
|
│ │ ├── frontend.md ← React 테스트 규칙
|
|
55
55
|
│ │ └── backend.md ← NestJS 테스트 규칙
|
|
56
|
-
│
|
|
57
|
-
│
|
|
56
|
+
│ ├── Git/
|
|
57
|
+
│ │ └── SKILL.md ← 커밋/PR/브랜치 규칙
|
|
58
|
+
│ ├── FailureRecovery/
|
|
59
|
+
│ │ └── SKILL.md ← 실패 복구 프로토콜
|
|
60
|
+
│ └── Curation/
|
|
61
|
+
│ └── SKILL.md ← AI 결과물 큐레이션 체크리스트
|
|
62
|
+
├── prompts/
|
|
63
|
+
│ ├── feature.md ← /feature [기능명] 커스텀 커맨드
|
|
64
|
+
│ ├── fix.md ← /fix [증상] 커스텀 커맨드
|
|
65
|
+
│ └── review.md ← /review 커스텀 커맨드
|
|
58
66
|
├── hooks/
|
|
59
67
|
│ ├── prompt-hook.sh ← 통합 hook (품질 체크 + 스킬 추천 + 구조 변경 감지)
|
|
60
68
|
│ └── skill-keywords.conf ← 스킬별 키워드 매핑 설정
|