jun-claude-code 0.6.4 → 0.6.7
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/package.json
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
# Claude Code 작업 가이드
|
|
2
2
|
|
|
3
|
+
## Monorepo 주의사항
|
|
4
|
+
|
|
5
|
+
Monorepo 환경에서는 **반드시 repo root에서 Claude Code CLI를 실행**해야 hooks가 정상 작동합니다. 서브 패키지 디렉토리에서 실행하면 `.claude/` 경로를 찾지 못해 hooks가 무시됩니다.
|
|
6
|
+
|
|
3
7
|
## Context 절약 원칙
|
|
4
8
|
|
|
5
9
|
Main Agent의 Context Window는 제한적입니다. Subagent가 할 수 있는 작업은 Subagent에 위임합니다.
|
|
@@ -188,6 +192,34 @@ Plan 파일의 Context 섹션에 위 내용을 명시하여 작업 목적이 희
|
|
|
188
192
|
|
|
189
193
|
<checklist>
|
|
190
194
|
|
|
195
|
+
### Step 3.0: BFF 구현 순서 -- FE/BE/DB가 모두 관련된 기능인 경우
|
|
196
|
+
|
|
197
|
+
> FE가 필요로 하는 기능을 먼저 정의하고, 그에 맞춰 DB와 API를 설계한다.
|
|
198
|
+
|
|
199
|
+
구현 순서:
|
|
200
|
+
1. FE 구현 (UI + 인터랙션)
|
|
201
|
+
2. DB 설계 (FE가 필요로 하는 데이터 구조 기반)
|
|
202
|
+
3. Decision Gate: DB 구현 타당성 평가
|
|
203
|
+
4. API 구현 (FE와 DB를 연결)
|
|
204
|
+
|
|
205
|
+
Decision Gate 판단 기준:
|
|
206
|
+
|
|
207
|
+
| 판단 항목 | 타당 (진행) | 비타당 (분리 또는 FE 수정) |
|
|
208
|
+
|-----------|------------|--------------------------|
|
|
209
|
+
| DB 구현 난이도 | 기존 스키마 확장 수준 | 대규모 스키마 변경, 마이그레이션 리스크 |
|
|
210
|
+
| 유지보수 비용 | 장기적으로 감당 가능 | 사용자 가치 대비 유지보수 비용이 큼 |
|
|
211
|
+
| 사용자 가치 | 핵심 기능, 즉시 필요 | nice-to-have, 후순위 가능 |
|
|
212
|
+
|
|
213
|
+
Decision Gate 결과별 액션:
|
|
214
|
+
- **타당** → DB 구현 후 API 구현으로 진행
|
|
215
|
+
- **FE 수정** → DB에 맞게 FE를 조정한 후 API 구현 (같은 Phase 내)
|
|
216
|
+
- **Phase 분리** → GitHub Issue를 생성하고, 현재 Phase에서 해당 기능 제외
|
|
217
|
+
|
|
218
|
+
적용 범위:
|
|
219
|
+
- FE/BE/DB가 모두 관련된 **신규 기능 구현**에 적용
|
|
220
|
+
- FE-only, BE-only, DB-only 작업에는 건너뛰고 Step 3.1로 진행
|
|
221
|
+
- 단순 CRUD처럼 DB 설계가 자명한 경우에도 건너뛰기 가능
|
|
222
|
+
|
|
191
223
|
### Step 3.1: 작은 단위로 코드 수정
|
|
192
224
|
|
|
193
225
|
필수 원칙:
|