@choblue/claude-code-toolkit 1.2.4 → 1.2.5
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.
|
@@ -1 +1 @@
|
|
|
1
|
-
|
|
1
|
+
e48648429d9686e998960a4fddaa11593ee785d5
|
package/.claude/CLAUDE.md
CHANGED
|
@@ -32,7 +32,30 @@ Claude는 작업 시작 전 반드시 이 규칙을 따라야 한다.
|
|
|
32
32
|
|
|
33
33
|
---
|
|
34
34
|
|
|
35
|
-
## 2.
|
|
35
|
+
## 2. 점진적 구현 원칙
|
|
36
|
+
|
|
37
|
+
**"한 번에 하나, 완전하게"** — 범위를 넓게 잡고 80%로 끝내지 말고, 좁게 잡고 100%로 완성한다.
|
|
38
|
+
|
|
39
|
+
### 작업 분해
|
|
40
|
+
- 요구사항을 **가장 작은 배포 가능 단위(smallest deliverable unit)**로 쪼갠다
|
|
41
|
+
- 한 단위를 **완전히 끝낸 후** 다음 단위로 이동한다
|
|
42
|
+
- 에이전트 1회 호출 당 **파일 3개 이하**를 원칙으로 한다
|
|
43
|
+
|
|
44
|
+
### 예시: "게시판 만들어줘"
|
|
45
|
+
```
|
|
46
|
+
Step 1: Entity + API (목록 조회만) → 확인
|
|
47
|
+
Step 2: 목록 UI → 확인
|
|
48
|
+
Step 3: 생성 API + UI → 확인
|
|
49
|
+
Step 4: 수정/삭제 → 확인
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
### 금지
|
|
53
|
+
- 한 번의 계획에 기능 전체를 담아 한꺼번에 구현하는 것
|
|
54
|
+
- 에이전트에 5개 이상 파일 동시 생성/수정을 위임하는 것
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## 3. 티어별 워크플로우
|
|
36
59
|
|
|
37
60
|
### S 티어 (trivial)
|
|
38
61
|
Main Agent가 직접 처리한다. 서브에이전트 위임 불필요.
|
|
@@ -42,15 +65,15 @@ Main Agent가 직접 처리한다. 서브에이전트 위임 불필요.
|
|
|
42
65
|
### M 티어 (moderate)
|
|
43
66
|
TDD/Review를 생략하고 핵심 단계만 수행한다.
|
|
44
67
|
1. **Planning**: 요구사항 정리, 필요 시 `explore`로 탐색
|
|
45
|
-
2. **Implementation**: `code-writer` 에이전트에 구현 위임
|
|
68
|
+
2. **Implementation**: `code-writer` 에이전트에 구현 위임 (단위별로 나눠 호출)
|
|
46
69
|
3. **Commit**: `git-manager`로 커밋/PR 생성
|
|
47
70
|
|
|
48
71
|
### L 티어 (complex)
|
|
49
|
-
파일 기반 설계 후 구현한다.
|
|
72
|
+
파일 기반 설계 후 **단위별로** 구현한다.
|
|
50
73
|
1. **Research**: `explore`로 탐색 → `research.md` 작성 (관련 코드 분석, 제약 조건)
|
|
51
|
-
2. **Plan**: `plan.md` 작성 (접근 방식, 변경 파일, 트레이드 오프, 작업
|
|
74
|
+
2. **Plan**: `plan.md` 작성 (접근 방식, 변경 파일, 트레이드 오프, **단위별 작업 순서**)
|
|
52
75
|
3. **주석 사이클**: 사용자가 plan.md에 메모 → 반영 → **승인 전까지 구현 금지**
|
|
53
|
-
4. **Implementation + Test**:
|
|
76
|
+
4. **Implementation + Test**: plan.md의 각 단위를 순서대로 `implementer`에 위임 (단위당 1회 호출)
|
|
54
77
|
5. **Review**: `code-reviewer`로 리뷰 → `git-manager`로 커밋/PR
|
|
55
78
|
|
|
56
79
|
### 풀스택 작업 (FE + BE 동시 변경)
|
|
@@ -58,7 +81,7 @@ TDD/Review를 생략하고 핵심 단계만 수행한다.
|
|
|
58
81
|
|
|
59
82
|
---
|
|
60
83
|
|
|
61
|
-
##
|
|
84
|
+
## 4. 문서 참조 가이드
|
|
62
85
|
|
|
63
86
|
### Agents (서브에이전트 프롬프트)
|
|
64
87
|
- `.claude/agents/explore.md` - 코드베이스 탐색 전문가
|
|
@@ -98,7 +121,7 @@ TDD/Review를 생략하고 핵심 단계만 수행한다.
|
|
|
98
121
|
|
|
99
122
|
---
|
|
100
123
|
|
|
101
|
-
##
|
|
124
|
+
## 5. 프로젝트별 오버라이드
|
|
102
125
|
|
|
103
126
|
프로젝트 루트에 `CLAUDE.md`가 있으면 이 글로벌 규칙보다 우선한다.
|
|
104
127
|
프로젝트별 규칙은 글로벌 규칙을 확장하되, 충돌 시 프로젝트 규칙을 따른다.
|
|
@@ -68,10 +68,29 @@ M 티어는 파일 없이 채팅에서 간단히 계획을 제시한다:
|
|
|
68
68
|
2. [작업] → [담당 에이전트]
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
## 4. 작업 분해
|
|
71
|
+
## 4. 작업 분해 원칙
|
|
72
72
|
|
|
73
|
+
**"한 번에 하나, 완전하게"** — 전체를 한꺼번에 80%로 끝내지 말고, 단위별로 100% 완성한다.
|
|
74
|
+
|
|
75
|
+
### 분해 기준
|
|
76
|
+
- **가장 작은 배포 가능 단위(smallest deliverable unit)**로 쪼갠다
|
|
77
|
+
- 각 단위는 독립적으로 동작하고 확인할 수 있어야 한다
|
|
78
|
+
- 에이전트 1회 호출 당 파일 3개 이하를 원칙으로 한다
|
|
79
|
+
|
|
80
|
+
### 분해 체크리스트
|
|
73
81
|
- [ ] 사용자가 원하는 최종 결과물은?
|
|
82
|
+
- [ ] 가장 작은 동작 단위로 쪼갰는가?
|
|
83
|
+
- [ ] 각 단위가 독립적으로 확인 가능한가?
|
|
74
84
|
- [ ] 변경되는 레이어는? (UI / API / Domain / DB)
|
|
75
|
-
- [ ] 기존 코드에 영향을 주는 범위는?
|
|
76
85
|
- [ ] 작업 간 순서 의존성이 있는가?
|
|
77
|
-
- [ ] 외부 의존성이 있는가? (패키지 설치, DB 마이그레이션 등)
|
|
86
|
+
- [ ] 외부 의존성이 있는가? (패키지 설치, DB 마이그레이션 등)
|
|
87
|
+
|
|
88
|
+
### plan.md 작업 순서 작성 예시
|
|
89
|
+
```markdown
|
|
90
|
+
## 작업 순서 (단위별)
|
|
91
|
+
1. Entity + Repository 정의 → implementer-be (파일 2개)
|
|
92
|
+
2. 목록 조회 API → implementer-be (파일 2개) → **확인**
|
|
93
|
+
3. 목록 UI → implementer-fe (파일 2~3개) → **확인**
|
|
94
|
+
4. 생성 API + UI → implementer-be → implementer-fe → **확인**
|
|
95
|
+
5. 수정/삭제 → implementer-be → implementer-fe → **확인**
|
|
96
|
+
```
|