@su-record/vibe 2.0.0 → 2.0.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 (69) hide show
  1. package/.claude/agents/explorer.md +48 -48
  2. package/.claude/agents/implementer.md +53 -53
  3. package/.claude/agents/searcher.md +54 -54
  4. package/.claude/agents/simplifier.md +119 -119
  5. package/.claude/agents/tester.md +49 -49
  6. package/.claude/commands/vibe.analyze.md +239 -239
  7. package/.claude/commands/vibe.continue.md +88 -88
  8. package/.claude/commands/vibe.diagram.md +178 -178
  9. package/.claude/commands/vibe.reason.md +306 -306
  10. package/.claude/commands/vibe.run.md +760 -760
  11. package/.claude/commands/vibe.spec.md +339 -339
  12. package/.claude/commands/vibe.tool.md +153 -153
  13. package/.claude/commands/vibe.ui.md +137 -137
  14. package/.claude/commands/vibe.verify.md +238 -238
  15. package/.claude/settings.json +152 -152
  16. package/.claude/settings.local.json +4 -57
  17. package/.vibe/config.json +9 -0
  18. package/.vibe/constitution.md +184 -184
  19. package/.vibe/rules/core/communication-guide.md +104 -104
  20. package/.vibe/rules/core/development-philosophy.md +52 -52
  21. package/.vibe/rules/core/quick-start.md +120 -120
  22. package/.vibe/rules/quality/bdd-contract-testing.md +388 -388
  23. package/.vibe/rules/quality/checklist.md +276 -276
  24. package/.vibe/rules/quality/testing-strategy.md +437 -437
  25. package/.vibe/rules/standards/anti-patterns.md +369 -369
  26. package/.vibe/rules/standards/code-structure.md +291 -291
  27. package/.vibe/rules/standards/complexity-metrics.md +312 -312
  28. package/.vibe/rules/standards/naming-conventions.md +198 -198
  29. package/.vibe/rules/tools/mcp-hi-ai-guide.md +665 -665
  30. package/.vibe/rules/tools/mcp-workflow.md +51 -51
  31. package/.vibe/setup.sh +31 -31
  32. package/CLAUDE.md +122 -122
  33. package/LICENSE +21 -21
  34. package/README.md +568 -568
  35. package/dist/cli/index.d.ts.map +1 -1
  36. package/dist/cli/index.js +391 -406
  37. package/dist/cli/index.js.map +1 -1
  38. package/dist/lib/MemoryManager.js +92 -92
  39. package/dist/lib/PythonParser.js +108 -108
  40. package/dist/lib/gemini-mcp.js +15 -15
  41. package/dist/lib/gemini-oauth.d.ts.map +1 -1
  42. package/dist/lib/gemini-oauth.js +41 -38
  43. package/dist/lib/gemini-oauth.js.map +1 -1
  44. package/dist/lib/gpt-mcp.js +17 -17
  45. package/dist/lib/gpt-oauth.d.ts.map +1 -1
  46. package/dist/lib/gpt-oauth.js +50 -45
  47. package/dist/lib/gpt-oauth.js.map +1 -1
  48. package/dist/tools/analytics/getUsageAnalytics.js +12 -12
  49. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  50. package/dist/tools/memory/getMemoryGraph.js +12 -12
  51. package/dist/tools/memory/getSessionContext.js +9 -9
  52. package/dist/tools/memory/linkMemories.js +14 -14
  53. package/dist/tools/memory/listMemories.js +4 -4
  54. package/dist/tools/memory/recallMemory.js +4 -4
  55. package/dist/tools/memory/saveMemory.js +4 -4
  56. package/dist/tools/memory/searchMemoriesAdvanced.js +22 -22
  57. package/dist/tools/planning/generatePrd.js +46 -46
  58. package/dist/tools/prompt/enhancePromptGemini.js +160 -160
  59. package/dist/tools/reasoning/applyReasoningFramework.js +56 -56
  60. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  61. package/package.json +67 -67
  62. package/templates/constitution-template.md +184 -184
  63. package/templates/contract-backend-template.md +517 -517
  64. package/templates/contract-frontend-template.md +594 -594
  65. package/templates/feature-template.md +96 -96
  66. package/templates/hooks-template.json +103 -103
  67. package/templates/spec-template.md +199 -199
  68. package/dist/lib/vibe-mcp.d.ts.map +0 -1
  69. package/dist/lib/vibe-mcp.js.map +0 -1
@@ -1,51 +1,51 @@
1
- # MCP 도구 워크플로우
2
-
3
- 모든 에이전트는 다음 MCP 도구 워크플로우를 따릅니다.
4
-
5
- ## 🔴 필수 단계 (모든 작업 시)
6
-
7
- ### 1. find_symbol - 기존 패턴 파악
8
- ```
9
- 작업 시작 전 항상 실행
10
- → 프로젝트의 기존 코드 패턴을 먼저 파악
11
- ```
12
-
13
- ### 2. save_memory - 중요 결정 저장
14
- ```
15
- 설계 결정이나 중요한 변경사항 발생 시 즉시 저장
16
- → 다음 작업 시 일관성 유지
17
- ```
18
-
19
- ### 3. validate_code_quality - 완성 후 검증
20
- ```
21
- 코드 작성 완료 후 자동 품질 검증
22
- → TRUST 5 기준 충족 확인
23
- ```
24
-
25
- ## 🟡 복잡한 작업 시
26
-
27
- ### 4. step_by_step_analysis
28
- ```
29
- 복잡한 기능 구현 전 단계별 계획 수립
30
- ```
31
-
32
- ### 5. suggest_improvements
33
- ```
34
- 코드 완성 후 최적화 기회 탐색
35
- ```
36
-
37
- ## 🟢 선택적 사용
38
-
39
- ### 6. find_references
40
- ```
41
- 함수/컴포넌트 수정 시 영향 범위 확인
42
- ```
43
-
44
- ### 7. prioritize_memory
45
- ```
46
- 긴 세션 종료 전 핵심 내용 요약
47
- ```
48
-
49
- ---
50
-
51
- **상세 가이드**: `~/.claude/skills/tools/mcp-hi-ai-guide.md`
1
+ # MCP 도구 워크플로우
2
+
3
+ 모든 에이전트는 다음 MCP 도구 워크플로우를 따릅니다.
4
+
5
+ ## 🔴 필수 단계 (모든 작업 시)
6
+
7
+ ### 1. find_symbol - 기존 패턴 파악
8
+ ```
9
+ 작업 시작 전 항상 실행
10
+ → 프로젝트의 기존 코드 패턴을 먼저 파악
11
+ ```
12
+
13
+ ### 2. save_memory - 중요 결정 저장
14
+ ```
15
+ 설계 결정이나 중요한 변경사항 발생 시 즉시 저장
16
+ → 다음 작업 시 일관성 유지
17
+ ```
18
+
19
+ ### 3. validate_code_quality - 완성 후 검증
20
+ ```
21
+ 코드 작성 완료 후 자동 품질 검증
22
+ → TRUST 5 기준 충족 확인
23
+ ```
24
+
25
+ ## 🟡 복잡한 작업 시
26
+
27
+ ### 4. step_by_step_analysis
28
+ ```
29
+ 복잡한 기능 구현 전 단계별 계획 수립
30
+ ```
31
+
32
+ ### 5. suggest_improvements
33
+ ```
34
+ 코드 완성 후 최적화 기회 탐색
35
+ ```
36
+
37
+ ## 🟢 선택적 사용
38
+
39
+ ### 6. find_references
40
+ ```
41
+ 함수/컴포넌트 수정 시 영향 범위 확인
42
+ ```
43
+
44
+ ### 7. prioritize_memory
45
+ ```
46
+ 긴 세션 종료 전 핵심 내용 요약
47
+ ```
48
+
49
+ ---
50
+
51
+ **상세 가이드**: `~/.claude/skills/tools/mcp-hi-ai-guide.md`
package/.vibe/setup.sh CHANGED
@@ -1,31 +1,31 @@
1
- #!/bin/bash
2
- # Vibe 협업자 자동 설치 스크립트
3
- # 사용법: ./.vibe/setup.sh
4
-
5
- set -e
6
-
7
- echo "🔧 Vibe 설치 확인 중..."
8
-
9
- # npm/npx 확인
10
- if ! command -v npx &> /dev/null; then
11
- echo "❌ Node.js/npm이 설치되어 있지 않습니다."
12
- echo " https://nodejs.org 에서 설치해주세요."
13
- exit 1
14
- fi
15
-
16
- # vibe 설치 확인 및 업데이트
17
- if command -v vibe &> /dev/null; then
18
- echo "✅ Vibe가 이미 설치되어 있습니다."
19
- vibe update --silent
20
- echo "✅ Vibe 업데이트 완료!"
21
- else
22
- echo "📦 Vibe 설치 중..."
23
- npm install -g @su-record/vibe
24
- vibe update --silent
25
- echo "✅ Vibe 설치 및 설정 완료!"
26
- fi
27
-
28
- echo ""
29
- echo "다음 명령어로 시작하세요:"
30
- echo " /vibe.spec \"기능명\" SPEC 작성"
31
- echo " /vibe.run \"기능명\" 구현 실행"
1
+ #!/bin/bash
2
+ # Vibe 협업자 자동 설치 스크립트
3
+ # 사용법: ./.vibe/setup.sh
4
+
5
+ set -e
6
+
7
+ echo "🔧 Vibe 설치 확인 중..."
8
+
9
+ # npm/npx 확인
10
+ if ! command -v npx &> /dev/null; then
11
+ echo "❌ Node.js/npm이 설치되어 있지 않습니다."
12
+ echo " https://nodejs.org 에서 설치해주세요."
13
+ exit 1
14
+ fi
15
+
16
+ # vibe 설치 확인 및 업데이트
17
+ if command -v vibe &> /dev/null; then
18
+ echo "✅ Vibe가 이미 설치되어 있습니다."
19
+ vibe update --silent
20
+ echo "✅ Vibe 업데이트 완료!"
21
+ else
22
+ echo "📦 Vibe 설치 중..."
23
+ npm install -g @su-record/vibe
24
+ vibe update --silent
25
+ echo "✅ Vibe 설치 및 설정 완료!"
26
+ fi
27
+
28
+ echo ""
29
+ echo "다음 명령어로 시작하세요:"
30
+ echo " /vibe.spec \"기능명\" SPEC 작성"
31
+ echo " /vibe.run \"기능명\" 구현 실행"
package/CLAUDE.md CHANGED
@@ -1,122 +1,122 @@
1
- # VIBE
2
-
3
- SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
4
-
5
- ## Workflow
6
-
7
- ```
8
- /vibe.spec → /vibe.run → /vibe.verify
9
- ```
10
-
11
- ## ULTRAWORK Mode (권장)
12
-
13
- `ultrawork` 또는 `ulw` 키워드를 포함하면 최대 성능 모드 활성화:
14
-
15
- ```bash
16
- /vibe.run "기능명" ultrawork # 모든 최적화 자동 활성화
17
- /vibe.run "기능명" ulw # 동일 (단축어)
18
- ```
19
-
20
- **활성화 기능:**
21
- - 병렬 서브에이전트 탐색 (3+ 동시)
22
- - Boulder Loop (모든 Phase 완료까지 자동 진행)
23
- - 에러 자동 재시도 (최대 3회)
24
- - 컨텍스트 70%+ 시 자동 압축/저장
25
- - Phase 간 확인 없이 연속 실행
26
-
27
- ## Commands
28
-
29
- | 명령어 | 설명 |
30
- |--------|------|
31
- | `/vibe.spec "기능명"` | SPEC 작성 (PTCF 구조) |
32
- | `/vibe.run "기능명"` | 구현 실행 |
33
- | `/vibe.run "기능명" ultrawork` | **최대 성능 모드** |
34
- | `/vibe.verify "기능명"` | 검증 |
35
- | `/vibe.reason "문제"` | 체계적 추론 |
36
- | `/vibe.analyze` | 프로젝트 분석 |
37
- | `/vibe.diagram` | 다이어그램 생성 |
38
- | `/vibe.ui "설명"` | UI 미리보기 |
39
- | `/vibe.continue` | **세션 복원** (이전 컨텍스트 로드) |
40
-
41
- ## PTCF Structure
42
-
43
- SPEC 문서는 AI가 바로 실행 가능한 프롬프트 형태:
44
-
45
- ```
46
- <role> AI 역할 정의
47
- <context> 배경, 기술 스택, 관련 코드
48
- <task> Phase별 작업 목록
49
- <constraints> 제약 조건
50
- <output_format> 생성/수정할 파일
51
- <acceptance> 검증 기준
52
- ```
53
-
54
- ## 내장 도구
55
-
56
- ### 시맨틱 코드 분석
57
- | 도구 | 용도 |
58
- |------|------|
59
- | `vibe_find_symbol` | 심볼 정의 찾기 |
60
- | `vibe_find_references` | 참조 찾기 |
61
- | `vibe_analyze_complexity` | 복잡도 분석 |
62
- | `vibe_validate_code_quality` | 품질 검증 |
63
-
64
- ### 컨텍스트 관리
65
- | 도구 | 용도 |
66
- |------|------|
67
- | `vibe_start_session` | 세션 시작 (이전 컨텍스트 복원) |
68
- | `vibe_auto_save_context` | 현재 상태 저장 |
69
- | `vibe_save_memory` | 중요 결정사항 저장 |
70
-
71
- ## 컨텍스트 관리 전략
72
-
73
- ### 모델 선택
74
- - **탐색/검색**: Haiku (서브에이전트 기본값)
75
- - **구현/디버깅**: Sonnet
76
- - **아키텍처/복잡한 로직**: Opus
77
-
78
- ### 컨텍스트 70%+ 시 (⚠️ 중요)
79
- ```
80
- ❌ /compact 사용 금지 (정보 손실/왜곡 위험)
81
- ✅ save_memory로 중요 결정사항 저장 → /new로 새 세션
82
- ```
83
-
84
- vibe는 자체 메모리 시스템으로 세션 간 컨텍스트를 유지합니다:
85
- 1. `save_memory` - 중요 결정사항 명시적 저장
86
- 2. `/new` - 새 세션 시작
87
- 3. `start_session` - 이전 세션 자동 복원
88
-
89
- ### 세션 복원
90
- 새 세션에서 이전 작업을 이어가려면:
91
- ```
92
- /vibe.continue
93
- ```
94
- 이 명령어가 `vibe_start_session`을 호출하여 프로젝트별 메모리에서 이전 컨텍스트를 복원합니다.
95
-
96
- ### 기타 명령어
97
- - `/rewind` - 이전 시점으로 되돌리기
98
- - `/context` - 현재 사용량 확인
99
-
100
- ### context7 활용
101
- 최신 라이브러리 문서가 필요할 때 context7 MCP 사용:
102
- ```
103
- "React 19 use() 훅을 context7으로 검색해줘"
104
- ```
105
-
106
- ## Git Commit 규칙
107
-
108
- **반드시 포함:**
109
- - `.claude/` 폴더 전체 (commands, agents, settings.json)
110
- - `.vibe/rules/`, `.vibe/specs/`, `.vibe/features/`
111
- - `CLAUDE.md`
112
-
113
- **제외:**
114
- - `.claude/settings.local.json` (개인 설정, 자동 제외)
115
- - `.vibe/mcp/` (node_modules, 자동 제외)
116
-
117
- ## Getting Started
118
-
119
- ```bash
120
- vibe init
121
- /vibe.spec "로그인 기능"
122
- ```
1
+ # VIBE
2
+
3
+ SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
4
+
5
+ ## Workflow
6
+
7
+ ```
8
+ /vibe.spec → /vibe.run → /vibe.verify
9
+ ```
10
+
11
+ ## ULTRAWORK Mode (권장)
12
+
13
+ `ultrawork` 또는 `ulw` 키워드를 포함하면 최대 성능 모드 활성화:
14
+
15
+ ```bash
16
+ /vibe.run "기능명" ultrawork # 모든 최적화 자동 활성화
17
+ /vibe.run "기능명" ulw # 동일 (단축어)
18
+ ```
19
+
20
+ **활성화 기능:**
21
+ - 병렬 서브에이전트 탐색 (3+ 동시)
22
+ - Boulder Loop (모든 Phase 완료까지 자동 진행)
23
+ - 에러 자동 재시도 (최대 3회)
24
+ - 컨텍스트 70%+ 시 자동 압축/저장
25
+ - Phase 간 확인 없이 연속 실행
26
+
27
+ ## Commands
28
+
29
+ | 명령어 | 설명 |
30
+ |--------|------|
31
+ | `/vibe.spec "기능명"` | SPEC 작성 (PTCF 구조) |
32
+ | `/vibe.run "기능명"` | 구현 실행 |
33
+ | `/vibe.run "기능명" ultrawork` | **최대 성능 모드** |
34
+ | `/vibe.verify "기능명"` | 검증 |
35
+ | `/vibe.reason "문제"` | 체계적 추론 |
36
+ | `/vibe.analyze` | 프로젝트 분석 |
37
+ | `/vibe.diagram` | 다이어그램 생성 |
38
+ | `/vibe.ui "설명"` | UI 미리보기 |
39
+ | `/vibe.continue` | **세션 복원** (이전 컨텍스트 로드) |
40
+
41
+ ## PTCF Structure
42
+
43
+ SPEC 문서는 AI가 바로 실행 가능한 프롬프트 형태:
44
+
45
+ ```
46
+ <role> AI 역할 정의
47
+ <context> 배경, 기술 스택, 관련 코드
48
+ <task> Phase별 작업 목록
49
+ <constraints> 제약 조건
50
+ <output_format> 생성/수정할 파일
51
+ <acceptance> 검증 기준
52
+ ```
53
+
54
+ ## 내장 도구
55
+
56
+ ### 시맨틱 코드 분석
57
+ | 도구 | 용도 |
58
+ |------|------|
59
+ | `vibe_find_symbol` | 심볼 정의 찾기 |
60
+ | `vibe_find_references` | 참조 찾기 |
61
+ | `vibe_analyze_complexity` | 복잡도 분석 |
62
+ | `vibe_validate_code_quality` | 품질 검증 |
63
+
64
+ ### 컨텍스트 관리
65
+ | 도구 | 용도 |
66
+ |------|------|
67
+ | `vibe_start_session` | 세션 시작 (이전 컨텍스트 복원) |
68
+ | `vibe_auto_save_context` | 현재 상태 저장 |
69
+ | `vibe_save_memory` | 중요 결정사항 저장 |
70
+
71
+ ## 컨텍스트 관리 전략
72
+
73
+ ### 모델 선택
74
+ - **탐색/검색**: Haiku (서브에이전트 기본값)
75
+ - **구현/디버깅**: Sonnet
76
+ - **아키텍처/복잡한 로직**: Opus
77
+
78
+ ### 컨텍스트 70%+ 시 (⚠️ 중요)
79
+ ```
80
+ ❌ /compact 사용 금지 (정보 손실/왜곡 위험)
81
+ ✅ save_memory로 중요 결정사항 저장 → /new로 새 세션
82
+ ```
83
+
84
+ vibe는 자체 메모리 시스템으로 세션 간 컨텍스트를 유지합니다:
85
+ 1. `save_memory` - 중요 결정사항 명시적 저장
86
+ 2. `/new` - 새 세션 시작
87
+ 3. `start_session` - 이전 세션 자동 복원
88
+
89
+ ### 세션 복원
90
+ 새 세션에서 이전 작업을 이어가려면:
91
+ ```
92
+ /vibe.continue
93
+ ```
94
+ 이 명령어가 `vibe_start_session`을 호출하여 프로젝트별 메모리에서 이전 컨텍스트를 복원합니다.
95
+
96
+ ### 기타 명령어
97
+ - `/rewind` - 이전 시점으로 되돌리기
98
+ - `/context` - 현재 사용량 확인
99
+
100
+ ### context7 활용
101
+ 최신 라이브러리 문서가 필요할 때 context7 MCP 사용:
102
+ ```
103
+ "React 19 use() 훅을 context7으로 검색해줘"
104
+ ```
105
+
106
+ ## Git Commit 규칙
107
+
108
+ **반드시 포함:**
109
+ - `.claude/` 폴더 전체 (commands, agents, settings.json)
110
+ - `.vibe/rules/`, `.vibe/specs/`, `.vibe/features/`
111
+ - `CLAUDE.md`
112
+
113
+ **제외:**
114
+ - `.claude/settings.local.json` (개인 설정, 자동 제외)
115
+ - `.vibe/mcp/` (node_modules, 자동 제외)
116
+
117
+ ## Getting Started
118
+
119
+ ```bash
120
+ vibe init
121
+ /vibe.spec "로그인 기능"
122
+ ```
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 Su
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Su
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.