@su-record/vibe 2.0.8 → 2.0.9
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.md +34 -0
- package/package.json +1 -1
package/CLAUDE.md
CHANGED
|
@@ -2,6 +2,40 @@
|
|
|
2
2
|
|
|
3
3
|
SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
|
|
4
4
|
|
|
5
|
+
## 코드 품질 기준 (필수)
|
|
6
|
+
|
|
7
|
+
모든 코드 작성 시 아래 기준을 준수합니다. 상세 규칙은 `.vibe/rules/` 참조.
|
|
8
|
+
|
|
9
|
+
### 핵심 원칙
|
|
10
|
+
- **요청 범위만 수정** - 관련 없는 코드 건드리지 않음
|
|
11
|
+
- **기존 스타일 유지** - 프로젝트 컨벤션 따름
|
|
12
|
+
- **작동하는 코드 보존** - 불필요한 리팩토링 금지
|
|
13
|
+
|
|
14
|
+
### 코드 복잡도 제한
|
|
15
|
+
| 메트릭 | 제한 |
|
|
16
|
+
|--------|------|
|
|
17
|
+
| 함수 길이 | 20줄 이하 |
|
|
18
|
+
| 중첩 깊이 | 3단계 이하 |
|
|
19
|
+
| 매개변수 | 5개 이하 |
|
|
20
|
+
| 순환 복잡도 | 10 이하 |
|
|
21
|
+
|
|
22
|
+
### TypeScript 필수 규칙
|
|
23
|
+
- `any` 타입 사용 금지 → `unknown` + 타입 가드 사용
|
|
24
|
+
- `as any` 캐스팅 금지 → 적절한 인터페이스 정의
|
|
25
|
+
- `@ts-ignore` 금지 → 타입 문제 근본 해결
|
|
26
|
+
- 모든 함수에 반환 타입 명시
|
|
27
|
+
|
|
28
|
+
### 에러 처리 필수
|
|
29
|
+
- try-catch 또는 error state 필수
|
|
30
|
+
- 로딩 상태 처리
|
|
31
|
+
- 사용자 친화적 에러 메시지
|
|
32
|
+
|
|
33
|
+
### 금지 패턴
|
|
34
|
+
- console.log 커밋 금지 (디버깅 후 제거)
|
|
35
|
+
- 하드코딩된 문자열/숫자 → 상수로 추출
|
|
36
|
+
- 주석 처리된 코드 커밋 금지
|
|
37
|
+
- TODO 없이 미완성 코드 커밋 금지
|
|
38
|
+
|
|
5
39
|
## Workflow
|
|
6
40
|
|
|
7
41
|
```
|