@su-record/vibe 2.3.0 → 2.3.2

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.
Files changed (98) hide show
  1. package/.claude/settings.json +35 -35
  2. package/.claude/settings.local.json +24 -25
  3. package/.claude/vibe/constitution.md +184 -184
  4. package/.claude/vibe/rules/core/communication-guide.md +104 -104
  5. package/.claude/vibe/rules/core/development-philosophy.md +52 -52
  6. package/.claude/vibe/rules/core/quick-start.md +120 -120
  7. package/.claude/vibe/rules/languages/dart-flutter.md +509 -509
  8. package/.claude/vibe/rules/languages/go.md +396 -396
  9. package/.claude/vibe/rules/languages/java-spring.md +586 -586
  10. package/.claude/vibe/rules/languages/kotlin-android.md +491 -491
  11. package/.claude/vibe/rules/languages/python-django.md +371 -371
  12. package/.claude/vibe/rules/languages/python-fastapi.md +386 -386
  13. package/.claude/vibe/rules/languages/rust.md +425 -425
  14. package/.claude/vibe/rules/languages/swift-ios.md +516 -516
  15. package/.claude/vibe/rules/languages/typescript-nextjs.md +441 -441
  16. package/.claude/vibe/rules/languages/typescript-node.md +375 -375
  17. package/.claude/vibe/rules/languages/typescript-nuxt.md +521 -521
  18. package/.claude/vibe/rules/languages/typescript-react-native.md +446 -446
  19. package/.claude/vibe/rules/languages/typescript-react.md +525 -525
  20. package/.claude/vibe/rules/languages/typescript-vue.md +353 -353
  21. package/.claude/vibe/rules/quality/bdd-contract-testing.md +388 -388
  22. package/.claude/vibe/rules/quality/checklist.md +276 -276
  23. package/.claude/vibe/rules/quality/testing-strategy.md +437 -437
  24. package/.claude/vibe/rules/standards/anti-patterns.md +369 -369
  25. package/.claude/vibe/rules/standards/code-structure.md +291 -291
  26. package/.claude/vibe/rules/standards/complexity-metrics.md +312 -312
  27. package/.claude/vibe/rules/standards/naming-conventions.md +198 -198
  28. package/.claude/vibe/setup.sh +31 -31
  29. package/.claude/vibe/templates/constitution-template.md +184 -184
  30. package/.claude/vibe/templates/contract-backend-template.md +517 -517
  31. package/.claude/vibe/templates/contract-frontend-template.md +594 -594
  32. package/.claude/vibe/templates/feature-template.md +96 -96
  33. package/.claude/vibe/templates/spec-template.md +199 -199
  34. package/CLAUDE.md +345 -323
  35. package/LICENSE +21 -21
  36. package/README.md +744 -724
  37. package/agents/compounder.md +261 -261
  38. package/agents/diagrammer.md +178 -178
  39. package/agents/e2e-tester.md +266 -266
  40. package/agents/explorer.md +48 -48
  41. package/agents/implementer.md +53 -53
  42. package/agents/research/best-practices-agent.md +139 -139
  43. package/agents/research/codebase-patterns-agent.md +147 -147
  44. package/agents/research/framework-docs-agent.md +181 -181
  45. package/agents/research/security-advisory-agent.md +167 -167
  46. package/agents/review/architecture-reviewer.md +107 -107
  47. package/agents/review/complexity-reviewer.md +116 -116
  48. package/agents/review/data-integrity-reviewer.md +88 -88
  49. package/agents/review/git-history-reviewer.md +103 -103
  50. package/agents/review/performance-reviewer.md +86 -86
  51. package/agents/review/python-reviewer.md +152 -152
  52. package/agents/review/rails-reviewer.md +139 -139
  53. package/agents/review/react-reviewer.md +144 -144
  54. package/agents/review/security-reviewer.md +80 -80
  55. package/agents/review/simplicity-reviewer.md +140 -140
  56. package/agents/review/test-coverage-reviewer.md +116 -116
  57. package/agents/review/typescript-reviewer.md +127 -127
  58. package/agents/searcher.md +54 -54
  59. package/agents/simplifier.md +119 -119
  60. package/agents/tester.md +49 -49
  61. package/agents/ui-previewer.md +137 -137
  62. package/commands/vibe.analyze.md +245 -180
  63. package/commands/vibe.reason.md +223 -183
  64. package/commands/vibe.review.md +200 -136
  65. package/commands/vibe.run.md +838 -836
  66. package/commands/vibe.spec.md +419 -383
  67. package/commands/vibe.utils.md +101 -101
  68. package/commands/vibe.verify.md +282 -241
  69. package/dist/cli/index.js +385 -385
  70. package/dist/lib/MemoryManager.d.ts.map +1 -1
  71. package/dist/lib/MemoryManager.js +119 -114
  72. package/dist/lib/MemoryManager.js.map +1 -1
  73. package/dist/lib/PythonParser.js +108 -108
  74. package/dist/lib/gemini-mcp.js +15 -15
  75. package/dist/lib/gemini-oauth.js +35 -35
  76. package/dist/lib/gpt-mcp.js +17 -17
  77. package/dist/lib/gpt-oauth.js +44 -44
  78. package/dist/tools/analytics/getUsageAnalytics.js +12 -12
  79. package/dist/tools/index.d.ts +50 -0
  80. package/dist/tools/index.d.ts.map +1 -0
  81. package/dist/tools/index.js +61 -0
  82. package/dist/tools/index.js.map +1 -0
  83. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  84. package/dist/tools/memory/getMemoryGraph.js +12 -12
  85. package/dist/tools/memory/getSessionContext.js +9 -9
  86. package/dist/tools/memory/linkMemories.js +14 -14
  87. package/dist/tools/memory/listMemories.js +4 -4
  88. package/dist/tools/memory/recallMemory.js +4 -4
  89. package/dist/tools/memory/saveMemory.js +4 -4
  90. package/dist/tools/memory/searchMemoriesAdvanced.js +22 -22
  91. package/dist/tools/planning/generatePrd.js +46 -46
  92. package/dist/tools/prompt/enhancePromptGemini.js +160 -160
  93. package/dist/tools/reasoning/applyReasoningFramework.js +56 -56
  94. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  95. package/hooks/hooks.json +121 -103
  96. package/package.json +73 -69
  97. package/skills/git-worktree.md +178 -178
  98. package/skills/priority-todos.md +236 -236
package/CLAUDE.md CHANGED
@@ -1,323 +1,345 @@
1
- # VIBE
2
-
3
- SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
4
-
5
- ## 코드 품질 기준 (필수)
6
-
7
- 모든 코드 작성 시 아래 기준을 준수합니다. 상세 규칙은 `.claude/vibe/rules/` 참조.
8
-
9
- ### 핵심 원칙
10
- - **요청 범위만 수정** - 관련 없는 코드 건드리지 않음
11
- - **기존 스타일 유지** - 프로젝트 컨벤션 따름
12
- - **작동하는 코드 보존** - 불필요한 리팩토링 금지
13
-
14
- ### 코드 복잡도 제한
15
- | 메트릭 | 제한 |
16
- |--------|------|
17
- | 함수 길이 | 20줄 이하 |
18
- | 중첩 깊이 | 3단계 이하 |
19
- | 매개변수 | 5개 이하 |
20
- | 순환 복잡도 | 10 이하 |
21
-
22
- ### 에러 처리 필수
23
- - try-catch 또는 error state 필수
24
- - 로딩 상태 처리
25
- - 사용자 친화적 에러 메시지
26
-
27
- ### 금지 패턴
28
- - console.log 커밋 금지 (디버깅 후 제거)
29
- - 하드코딩된 문자열/숫자 → 상수로 추출
30
- - 주석 처리된 코드 커밋 금지
31
- - TODO 없이 미완성 코드 커밋 금지
32
-
33
- ## Workflow
34
-
35
- ```
36
- /vibe.spec → /vibe.run → /vibe.verify → /vibe.compound
37
- ```
38
-
39
- ## ULTRAWORK Mode (권장)
40
-
41
- `ultrawork` 또는 `ulw` 키워드를 포함하면 최대 성능 모드 활성화:
42
-
43
- ```bash
44
- /vibe.run "기능명" ultrawork # 모든 최적화 자동 활성화
45
- /vibe.run "기능명" ulw # 동일 (단축어)
46
- ```
47
-
48
- **활성화 기능:**
49
- - 병렬 서브에이전트 탐색 (3+ 동시)
50
- - **백그라운드 에이전트** - 구현 다음 Phase 준비
51
- - **Phase 파이프라이닝** - Phase 대기 시간 제거
52
- - Boulder Loop (모든 Phase 완료까지 자동 진행)
53
- - 에러 자동 재시도 (최대 3회)
54
- - 컨텍스트 70%+ 자동 압축/저장
55
- - Phase 간 확인 없이 연속 실행
56
-
57
- **속도 비교:**
58
-
59
- | Mode | Phase당 | 5 Phase |
60
- |------|---------|---------|
61
- | Sequential | ~2분 | ~10분 |
62
- | Parallel Exploration | ~1.5분 | ~7.5분 |
63
- | **ULTRAWORK Pipeline** | **~1분** | **~5분** |
64
-
65
- ## Commands
66
-
67
- | 명령어 | 설명 |
68
- |--------|------|
69
- | `/vibe.spec "기능명"` | SPEC 작성 (PTCF 구조) + 병렬 리서치 |
70
- | `/vibe.run "기능명"` | 구현 실행 |
71
- | `/vibe.run "기능명" ultrawork` | **최대 성능 모드** |
72
- | `/vibe.verify "기능명"` | 검증 |
73
- | `/vibe.review` | **병렬 코드 리뷰** (13+ 에이전트) |
74
- | `/vibe.compound` | **지식 문서화** (해결책 아카이브) |
75
- | `/vibe.e2e` | **E2E 테스트** (Playwright) |
76
- | `/vibe.reason "문제"` | 체계적 추론 |
77
- | `/vibe.analyze` | 프로젝트 분석 |
78
- | `/vibe.diagram` | 다이어그램 생성 |
79
- | `/vibe.ui "설명"` | UI 미리보기 |
80
- | `/vibe.continue` | **세션 복원** (이전 컨텍스트 로드) |
81
-
82
- ## 새로운 기능 (v2.1.0)
83
-
84
- ### 병렬 코드 리뷰 (/vibe.review)
85
-
86
- 13+ 전문 에이전트가 동시에 코드 리뷰:
87
-
88
- ```
89
- ┌─────────────────────────────────────────────────────────────────┐
90
- │ 🚀 PARALLEL REVIEW AGENTS │
91
- ├─────────────────────────────────────────────────────────────────┤
92
- │ Security │ security-reviewer, data-integrity-reviewer
93
- │ Performance │ performance-reviewer, complexity-reviewer │
94
- │ Architecture │ architecture-reviewer, simplicity-reviewer
95
- │ Language-Specific python, typescript, rails, react reviewers
96
- │ Context │ git-history, test-coverage reviewers │
97
- └─────────────────────────────────────────────────────────────────┘
98
- ```
99
-
100
- **우선순위 시스템:**
101
- - 🔴 P1 (Critical): 머지 차단
102
- - 🟡 P2 (Important): 수정 권장
103
- - 🔵 P3 (Nice-to-have): 백로그
104
-
105
- ### 지식 복리 (/vibe.compound)
106
-
107
- 해결한 문제를 자동 문서화:
108
-
109
- ```
110
- .claude/vibe/solutions/
111
- ├── security/ # 보안 해결책
112
- ├── performance/ # 성능 최적화
113
- ├── database/ # DB 관련
114
- └── integration/ # 외부 연동
115
- ```
116
-
117
- 트리거: "it's fixed", "해결됨", PR 머지
118
-
119
- ### E2E 테스트 (/vibe.e2e)
120
-
121
- Playwright 기반 자동화 테스트:
122
-
123
- ```bash
124
- /vibe.e2e "login flow" # 시나리오 테스트
125
- /vibe.e2e --visual # 시각적 회귀 테스트
126
- /vibe.e2e --record # 비디오 녹화
127
- ```
128
-
129
- ### 리서치 에이전트 강화
130
-
131
- `/vibe.spec` 실행 시 **요구사항 확정 후** 4개 병렬 리서치:
132
-
133
- ```
134
- 문답으로 요구사항 확정 → 병렬 리서치 실행 → SPEC 작성
135
- ```
136
-
137
- | 에이전트 | 역할 |
138
- |----------|------|
139
- | best-practices-agent | 확정된 기능+스택 베스트 프랙티스 |
140
- | framework-docs-agent | 확정된 스택 최신 문서 (context7) |
141
- | codebase-patterns-agent | 기존 유사 패턴 분석 |
142
- | security-advisory-agent | 확정된 기능 보안 권고 |
143
-
144
- **⚠️ 리서치는 요구사항 확정 후 실행** (VIBE 원칙: 요구사항 먼저)
145
-
146
- ## PTCF Structure
147
-
148
- SPEC 문서는 AI가 바로 실행 가능한 프롬프트 형태:
149
-
150
- ```
151
- <role> AI 역할 정의
152
- <context> 배경, 기술 스택, 관련 코드
153
- <task> Phase별 작업 목록
154
- <constraints> 제약 조건
155
- <output_format> 생성/수정할 파일
156
- <acceptance> 검증 기준
157
- ```
158
-
159
- ## 내장 도구
160
-
161
- ### 시맨틱 코드 분석
162
- | 도구 | 용도 |
163
- |------|------|
164
- | `vibe_find_symbol` | 심볼 정의 찾기 |
165
- | `vibe_find_references` | 참조 찾기 |
166
- | `vibe_analyze_complexity` | 복잡도 분석 |
167
- | `vibe_validate_code_quality` | 품질 검증 |
168
-
169
- ### 컨텍스트 관리
170
- | 도구 | 용도 |
171
- |------|------|
172
- | `vibe_start_session` | 세션 시작 (이전 컨텍스트 복원) |
173
- | `vibe_auto_save_context` | 현재 상태 저장 |
174
- | `vibe_save_memory` | 중요 결정사항 저장 |
175
-
176
- ## 에이전트
177
-
178
- ### Review 에이전트 (12개)
179
- ```
180
- .claude/agents/review/
181
- ├── security-reviewer.md # 보안 취약점
182
- ├── performance-reviewer.md # 성능 병목
183
- ├── architecture-reviewer.md # 아키텍처 위반
184
- ├── complexity-reviewer.md # 복잡도 초과
185
- ├── simplicity-reviewer.md # 과도한 추상화
186
- ├── data-integrity-reviewer.md # 데이터 무결성
187
- ├── test-coverage-reviewer.md # 테스트 누락
188
- ├── git-history-reviewer.md # 위험 패턴
189
- ├── python-reviewer.md # Python 전문
190
- ├── typescript-reviewer.md # TypeScript 전문
191
- ├── rails-reviewer.md # Rails 전문
192
- └── react-reviewer.md # React 전문
193
- ```
194
-
195
- ### Research 에이전트 (4개)
196
- ```
197
- .claude/agents/research/
198
- ├── best-practices-agent.md # 베스트 프랙티스
199
- ├── framework-docs-agent.md # 프레임워크 문서
200
- ├── codebase-patterns-agent.md # 코드 패턴 분석
201
- └── security-advisory-agent.md # 보안 권고
202
- ```
203
-
204
- ## 스킬
205
-
206
- ### Git Worktree
207
- ```bash
208
- # PR 리뷰용 격리 환경
209
- git worktree add ../review-123 origin/pr/123
210
- cd ../review-123 && npm test
211
- git worktree remove ../review-123
212
- ```
213
-
214
- ### Priority Todos
215
- ```
216
- .claude/vibe/todos/
217
- ├── P1-security-sql-injection.md # 🔴 머지 차단
218
- ├── P2-perf-n1-query.md # 🟡 수정 권장
219
- └── P3-style-extract-helper.md # 🔵 백로그
220
- ```
221
-
222
- ## 컨텍스트 관리 전략
223
-
224
- ### 모델 선택
225
- - **탐색/검색**: Haiku (서브에이전트 기본값)
226
- - **구현/디버깅**: Sonnet
227
- - **아키텍처/복잡한 로직**: Opus
228
-
229
- ### 컨텍스트 70%+ 시 (⚠️ 중요)
230
- ```
231
- /compact 사용 금지 (정보 손실/왜곡 위험)
232
- save_memory로 중요 결정사항 저장 → /new로 새 세션
233
- ```
234
-
235
- vibe는 자체 메모리 시스템으로 세션 간 컨텍스트를 유지합니다:
236
- 1. `save_memory` - 중요 결정사항 명시적 저장
237
- 2. `/new` - 새 세션 시작
238
- 3. `start_session` - 이전 세션 자동 복원
239
-
240
- ### 세션 복원
241
- 세션에서 이전 작업을 이어가려면:
242
- ```
243
- /vibe.continue
244
- ```
245
- 이 명령어가 `vibe_start_session`을 호출하여 프로젝트별 메모리에서 이전 컨텍스트를 복원합니다.
246
-
247
- ### 기타 명령어
248
- - `/rewind` - 이전 시점으로 되돌리기
249
- - `/context` - 현재 사용량 확인
250
-
251
- ### context7 활용
252
- 최신 라이브러리 문서가 필요할 때 context7 MCP 사용:
253
- ```
254
- "React 19 use() 훅을 context7으로 검색해줘"
255
- ```
256
-
257
- ## 문서 작성 규칙
258
-
259
- ### 다이어그램/구조 표현
260
- - 아스키 박스 (┌─┐) 사용 금지 → 한글 폭 문제로 정렬 깨짐
261
- - 대안 사용:
262
- - Mermaid 다이어그램 (GitHub/노션 지원)
263
- - 마크다운 테이블
264
- - 들여쓰기 + 구분선
265
-
266
- ### 선호 형식
267
- | 용도 | 권장 방식 |
268
- |------|----------|
269
- | 흐름도 | Mermaid flowchart |
270
- | 구조/계층 | 들여쓰기 리스트 |
271
- | 비교/목록 | 마크다운 테이블 |
272
- | 시퀀스 | Mermaid sequenceDiagram |
273
-
274
- ## Git Commit 규칙
275
-
276
- **반드시 포함:**
277
- - `.claude/` 폴더 전체 (commands, agents, skills, settings.json)
278
- - `.claude/vibe/rules/`, `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/solutions/`, `.claude/vibe/todos/`
279
- - `CLAUDE.md`
280
-
281
- **제외:**
282
- - `.claude/settings.local.json` (개인 설정, 자동 제외)
283
- - `.claude/vibe/mcp/` (node_modules, 자동 제외)
284
-
285
- ## Getting Started
286
-
287
- ```bash
288
- vibe init
289
- /vibe.spec "로그인 기능"
290
- ```
291
-
292
- ## 전체 워크플로우
293
-
294
- ```
295
- ┌─────────────────────────────────────────────────────────────────┐
296
- │ VIBE Complete Workflow │
297
- ├─────────────────────────────────────────────────────────────────┤
298
- │ │
299
- │ 1. /vibe.spec "기능명" │
300
- │ ├── 문답으로 요구사항 수집 │
301
- │ ├── 요구사항 확정 후 4개 병렬 리서치 │
302
- │ └── SPEC 문서 생성 │
303
- │ │
304
- │ 2. /vibe.run "기능명" ultrawork │
305
- │ ├── 구현 │
306
- │ ├── 테스트 │
307
- │ └── 자동 진행 │
308
- │ │
309
- │ 3. /vibe.verify "기능명" │
310
- │ └── BDD 시나리오 검증 │
311
- │ │
312
- │ 4. /vibe.review │
313
- │ ├── 13+ 병렬 리뷰 에이전트 │
314
- │ └── P1/P2/P3 우선순위 분류 │
315
- │ │
316
- │ 5. /vibe.e2e │
317
- │ └── Playwright E2E 테스트 │
318
-
319
- │ 6. /vibe.compound │
320
- └── 해결책 문서화 → .claude/vibe/solutions/
321
-
322
- └─────────────────────────────────────────────────────────────────┘
323
- ```
1
+ # VIBE
2
+
3
+ SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
4
+
5
+ ## 코드 품질 기준 (필수)
6
+
7
+ 모든 코드 작성 시 아래 기준을 준수합니다. 상세 규칙은 `.claude/vibe/rules/` 참조.
8
+
9
+ ### 핵심 원칙
10
+ - **요청 범위만 수정** - 관련 없는 코드 건드리지 않음
11
+ - **기존 스타일 유지** - 프로젝트 컨벤션 따름
12
+ - **작동하는 코드 보존** - 불필요한 리팩토링 금지
13
+
14
+ ### 코드 복잡도 제한
15
+ | 메트릭 | 제한 |
16
+ |--------|------|
17
+ | 함수 길이 | 20줄 이하 |
18
+ | 중첩 깊이 | 3단계 이하 |
19
+ | 매개변수 | 5개 이하 |
20
+ | 순환 복잡도 | 10 이하 |
21
+
22
+ ### 에러 처리 필수
23
+ - try-catch 또는 error state 필수
24
+ - 로딩 상태 처리
25
+ - 사용자 친화적 에러 메시지
26
+
27
+ ### 금지 패턴
28
+ - console.log 커밋 금지 (디버깅 후 제거)
29
+ - 하드코딩된 문자열/숫자 → 상수로 추출
30
+ - 주석 처리된 코드 커밋 금지
31
+ - TODO 없이 미완성 코드 커밋 금지
32
+
33
+ ## Workflow
34
+
35
+ ```
36
+ /vibe.spec → /vibe.run → /vibe.verify → /vibe.compound
37
+ ```
38
+
39
+ ## Plan Mode vs VIBE (워크플로우 선택)
40
+
41
+ **개발 요청 사용자에게 선택권 제공:**
42
+
43
+ | 작업 규모 | 권장 방식 |
44
+ |----------|----------|
45
+ | 간단한 수정 (1-2 파일) | Plan Mode |
46
+ | 복잡한 기능 (3+ 파일, 리서치/검증 필요) | `/vibe.spec` |
47
+
48
+ | 항목 | Plan Mode | VIBE |
49
+ |------|-----------|------|
50
+ | 저장 위치 | `~/.claude/plans/` (전역) | `.claude/vibe/specs/` (프로젝트) |
51
+ | 문서 형식 | 자유 형식 | PTCF 구조 (AI 실행 최적화) |
52
+ | 리서치 | 없음 | 4개 병렬 에이전트 |
53
+ | 검증 | 없음 | `/vibe.verify`로 SPEC 대비 검증 |
54
+ | 히스토리 | 추적 불가 | Git으로 버전 관리 |
55
+
56
+ **규칙:**
57
+ - `/vibe.analyze` 또는 `/vibe.review` 후 개발/수정 요청 시 → **사용자에게 워크플로우 선택 질문**
58
+ - 사용자가 VIBE 선택 → `/vibe.spec` 대기
59
+ - 사용자가 Plan Mode 선택 EnterPlanMode 진행
60
+
61
+ ## ULTRAWORK Mode (권장)
62
+
63
+ `ultrawork` 또는 `ulw` 키워드를 포함하면 최대 성능 모드 활성화:
64
+
65
+ ```bash
66
+ /vibe.run "기능명" ultrawork # 모든 최적화 자동 활성화
67
+ /vibe.run "기능명" ulw # 동일 (단축어)
68
+ ```
69
+
70
+ **활성화 기능:**
71
+ - 병렬 서브에이전트 탐색 (3+ 동시)
72
+ - **백그라운드 에이전트** - 구현 중 다음 Phase 준비
73
+ - **Phase 파이프라이닝** - Phase 대기 시간 제거
74
+ - Boulder Loop (모든 Phase 완료까지 자동 진행)
75
+ - 에러 자동 재시도 (최대 3회)
76
+ - 컨텍스트 70%+ 자동 압축/저장
77
+ - Phase 확인 없이 연속 실행
78
+
79
+ **속도 비교:**
80
+
81
+ | Mode | Phase당 | 5 Phase |
82
+ |------|---------|---------|
83
+ | Sequential | ~2분 | ~10분 |
84
+ | Parallel Exploration | ~1.5분 | ~7.5분 |
85
+ | **ULTRAWORK Pipeline** | **~1분** | **~5분** |
86
+
87
+ ## Commands
88
+
89
+ | 명령어 | 설명 |
90
+ |--------|------|
91
+ | `/vibe.spec "기능명"` | SPEC 작성 (PTCF 구조) + 병렬 리서치 |
92
+ | `/vibe.run "기능명"` | 구현 실행 |
93
+ | `/vibe.run "기능명" ultrawork` | **최대 성능 모드** |
94
+ | `/vibe.verify "기능명"` | 검증 |
95
+ | `/vibe.review` | **병렬 코드 리뷰** (13+ 에이전트) |
96
+ | `/vibe.compound` | **지식 문서화** (해결책 아카이브) |
97
+ | `/vibe.e2e` | **E2E 테스트** (Playwright) |
98
+ | `/vibe.reason "문제"` | 체계적 추론 |
99
+ | `/vibe.analyze` | 프로젝트 분석 |
100
+ | `/vibe.diagram` | 다이어그램 생성 |
101
+ | `/vibe.ui "설명"` | UI 미리보기 |
102
+ | `/vibe.continue` | **세션 복원** (이전 컨텍스트 로드) |
103
+
104
+ ## 새로운 기능 (v2.1.0)
105
+
106
+ ### 병렬 코드 리뷰 (/vibe.review)
107
+
108
+ 13+ 전문 에이전트가 동시에 코드 리뷰:
109
+
110
+ ```
111
+ ┌─────────────────────────────────────────────────────────────────┐
112
+ │ 🚀 PARALLEL REVIEW AGENTS │
113
+ ├─────────────────────────────────────────────────────────────────┤
114
+ │ Security │ security-reviewer, data-integrity-reviewer
115
+ │ Performance │ performance-reviewer, complexity-reviewer │
116
+ │ Architecture │ architecture-reviewer, simplicity-reviewer │
117
+ │ Language-Specific python, typescript, rails, react reviewers │
118
+ │ Context │ git-history, test-coverage reviewers │
119
+ └─────────────────────────────────────────────────────────────────┘
120
+ ```
121
+
122
+ **우선순위 시스템:**
123
+ - 🔴 P1 (Critical): 머지 차단
124
+ - 🟡 P2 (Important): 수정 권장
125
+ - 🔵 P3 (Nice-to-have): 백로그
126
+
127
+ ### 지식 복리 (/vibe.compound)
128
+
129
+ 해결한 문제를 자동 문서화:
130
+
131
+ ```
132
+ .claude/vibe/solutions/
133
+ ├── security/ # 보안 해결책
134
+ ├── performance/ # 성능 최적화
135
+ ├── database/ # DB 관련
136
+ └── integration/ # 외부 연동
137
+ ```
138
+
139
+ 트리거: "it's fixed", "해결됨", PR 머지
140
+
141
+ ### E2E 테스트 (/vibe.e2e)
142
+
143
+ Playwright 기반 자동화 테스트:
144
+
145
+ ```bash
146
+ /vibe.e2e "login flow" # 시나리오 테스트
147
+ /vibe.e2e --visual # 시각적 회귀 테스트
148
+ /vibe.e2e --record # 비디오 녹화
149
+ ```
150
+
151
+ ### 리서치 에이전트 강화
152
+
153
+ `/vibe.spec` 실행 시 **요구사항 확정 후** 4개 병렬 리서치:
154
+
155
+ ```
156
+ 문답으로 요구사항 확정 → 병렬 리서치 실행 → SPEC 작성
157
+ ```
158
+
159
+ | 에이전트 | 역할 |
160
+ |----------|------|
161
+ | best-practices-agent | 확정된 기능+스택 베스트 프랙티스 |
162
+ | framework-docs-agent | 확정된 스택 최신 문서 (context7) |
163
+ | codebase-patterns-agent | 기존 유사 패턴 분석 |
164
+ | security-advisory-agent | 확정된 기능 보안 권고 |
165
+
166
+ **⚠️ 리서치는 요구사항 확정 실행** (VIBE 원칙: 요구사항 먼저)
167
+
168
+ ## PTCF Structure
169
+
170
+ SPEC 문서는 AI가 바로 실행 가능한 프롬프트 형태:
171
+
172
+ ```
173
+ <role> AI 역할 정의
174
+ <context> 배경, 기술 스택, 관련 코드
175
+ <task> Phase별 작업 목록
176
+ <constraints> 제약 조건
177
+ <output_format> 생성/수정할 파일
178
+ <acceptance> 검증 기준
179
+ ```
180
+
181
+ ## 내장 도구
182
+
183
+ ### 시맨틱 코드 분석
184
+ | 도구 | 용도 |
185
+ |------|------|
186
+ | `vibe_find_symbol` | 심볼 정의 찾기 |
187
+ | `vibe_find_references` | 참조 찾기 |
188
+ | `vibe_analyze_complexity` | 복잡도 분석 |
189
+ | `vibe_validate_code_quality` | 품질 검증 |
190
+
191
+ ### 컨텍스트 관리
192
+ | 도구 | 용도 |
193
+ |------|------|
194
+ | `vibe_start_session` | 세션 시작 (이전 컨텍스트 복원) |
195
+ | `vibe_auto_save_context` | 현재 상태 저장 |
196
+ | `vibe_save_memory` | 중요 결정사항 저장 |
197
+
198
+ ## 에이전트
199
+
200
+ ### Review 에이전트 (12개)
201
+ ```
202
+ .claude/agents/review/
203
+ ├── security-reviewer.md # 보안 취약점
204
+ ├── performance-reviewer.md # 성능 병목
205
+ ├── architecture-reviewer.md # 아키텍처 위반
206
+ ├── complexity-reviewer.md # 복잡도 초과
207
+ ├── simplicity-reviewer.md # 과도한 추상화
208
+ ├── data-integrity-reviewer.md # 데이터 무결성
209
+ ├── test-coverage-reviewer.md # 테스트 누락
210
+ ├── git-history-reviewer.md # 위험 패턴
211
+ ├── python-reviewer.md # Python 전문
212
+ ├── typescript-reviewer.md # TypeScript 전문
213
+ ├── rails-reviewer.md # Rails 전문
214
+ └── react-reviewer.md # React 전문
215
+ ```
216
+
217
+ ### Research 에이전트 (4개)
218
+ ```
219
+ .claude/agents/research/
220
+ ├── best-practices-agent.md # 베스트 프랙티스
221
+ ├── framework-docs-agent.md # 프레임워크 문서
222
+ ├── codebase-patterns-agent.md # 코드 패턴 분석
223
+ └── security-advisory-agent.md # 보안 권고
224
+ ```
225
+
226
+ ## 스킬
227
+
228
+ ### Git Worktree
229
+ ```bash
230
+ # PR 리뷰용 격리 환경
231
+ git worktree add ../review-123 origin/pr/123
232
+ cd ../review-123 && npm test
233
+ git worktree remove ../review-123
234
+ ```
235
+
236
+ ### Priority Todos
237
+ ```
238
+ .claude/vibe/todos/
239
+ ├── P1-security-sql-injection.md # 🔴 머지 차단
240
+ ├── P2-perf-n1-query.md # 🟡 수정 권장
241
+ └── P3-style-extract-helper.md # 🔵 백로그
242
+ ```
243
+
244
+ ## 컨텍스트 관리 전략
245
+
246
+ ### 모델 선택
247
+ - **탐색/검색**: Haiku (서브에이전트 기본값)
248
+ - **구현/디버깅**: Sonnet
249
+ - **아키텍처/복잡한 로직**: Opus
250
+
251
+ ### 컨텍스트 70%+ 시 (⚠️ 중요)
252
+ ```
253
+ ❌ /compact 사용 금지 (정보 손실/왜곡 위험)
254
+ save_memory로 중요 결정사항 저장 → /new로 새 세션
255
+ ```
256
+
257
+ vibe는 자체 메모리 시스템으로 세션 간 컨텍스트를 유지합니다:
258
+ 1. `save_memory` - 중요 결정사항 명시적 저장
259
+ 2. `/new` - 새 세션 시작
260
+ 3. `start_session` - 이전 세션 자동 복원
261
+
262
+ ### 세션 복원
263
+ 세션에서 이전 작업을 이어가려면:
264
+ ```
265
+ /vibe.continue
266
+ ```
267
+ 명령어가 `vibe_start_session`을 호출하여 프로젝트별 메모리에서 이전 컨텍스트를 복원합니다.
268
+
269
+ ### 기타 명령어
270
+ - `/rewind` - 이전 시점으로 되돌리기
271
+ - `/context` - 현재 사용량 확인
272
+
273
+ ### context7 활용
274
+ 최신 라이브러리 문서가 필요할 때 context7 MCP 사용:
275
+ ```
276
+ "React 19 use() 훅을 context7으로 검색해줘"
277
+ ```
278
+
279
+ ## 문서 작성 규칙
280
+
281
+ ### 다이어그램/구조 표현
282
+ - 아스키 박스 (┌─┐) 사용 금지 → 한글 폭 문제로 정렬 깨짐
283
+ - 대안 사용:
284
+ - Mermaid 다이어그램 (GitHub/노션 지원)
285
+ - 마크다운 테이블
286
+ - 들여쓰기 + 구분선
287
+
288
+ ### 선호 형식
289
+ | 용도 | 권장 방식 |
290
+ |------|----------|
291
+ | 흐름도 | Mermaid flowchart |
292
+ | 구조/계층 | 들여쓰기 리스트 |
293
+ | 비교/목록 | 마크다운 테이블 |
294
+ | 시퀀스 | Mermaid sequenceDiagram |
295
+
296
+ ## Git Commit 규칙
297
+
298
+ **반드시 포함:**
299
+ - `.claude/` 폴더 전체 (commands, agents, skills, settings.json)
300
+ - `.claude/vibe/rules/`, `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/solutions/`, `.claude/vibe/todos/`
301
+ - `CLAUDE.md`
302
+
303
+ **제외:**
304
+ - `.claude/settings.local.json` (개인 설정, 자동 제외)
305
+ - `.claude/vibe/mcp/` (node_modules, 자동 제외)
306
+
307
+ ## Getting Started
308
+
309
+ ```bash
310
+ vibe init
311
+ /vibe.spec "로그인 기능"
312
+ ```
313
+
314
+ ## 전체 워크플로우
315
+
316
+ ```
317
+ ┌─────────────────────────────────────────────────────────────────┐
318
+ VIBE Complete Workflow
319
+ ├─────────────────────────────────────────────────────────────────┤
320
+
321
+ 1. /vibe.spec "기능명"
322
+ │ ├── 문답으로 요구사항 수집 │
323
+ │ ├── 요구사항 확정 후 4개 병렬 리서치 │
324
+ │ └── SPEC 문서 생성 │
325
+ │ │
326
+ │ 2. /vibe.run "기능명" ultrawork │
327
+ │ ├── 구현 │
328
+ │ ├── 테스트 │
329
+ │ └── 자동 진행 │
330
+ │ │
331
+ │ 3. /vibe.verify "기능명" │
332
+ │ └── BDD 시나리오 검증 │
333
+ │ │
334
+ │ 4. /vibe.review │
335
+ │ ├── 13+ 병렬 리뷰 에이전트 │
336
+ │ └── P1/P2/P3 우선순위 분류 │
337
+ │ │
338
+ │ 5. /vibe.e2e │
339
+ │ └── Playwright E2E 테스트 │
340
+ │ │
341
+ │ 6. /vibe.compound │
342
+ │ └── 해결책 문서화 → .claude/vibe/solutions/ │
343
+ │ │
344
+ └─────────────────────────────────────────────────────────────────┘
345
+ ```