@su-record/vibe 2.7.14 → 2.7.16

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 (234) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +134 -126
  3. package/LICENSE +21 -21
  4. package/README.md +449 -449
  5. package/agents/architect-low.md +41 -41
  6. package/agents/architect-medium.md +59 -59
  7. package/agents/architect.md +80 -80
  8. package/agents/build-error-resolver.md +115 -115
  9. package/agents/compounder.md +261 -261
  10. package/agents/diagrammer.md +178 -178
  11. package/agents/docs/api-documenter.md +99 -99
  12. package/agents/docs/changelog-writer.md +93 -93
  13. package/agents/e2e-tester.md +294 -294
  14. package/agents/explorer-low.md +42 -42
  15. package/agents/explorer-medium.md +59 -59
  16. package/agents/explorer.md +48 -48
  17. package/agents/implementer-low.md +43 -43
  18. package/agents/implementer-medium.md +52 -52
  19. package/agents/implementer.md +54 -54
  20. package/agents/junior-mentor.md +141 -141
  21. package/agents/planning/requirements-analyst.md +84 -84
  22. package/agents/planning/ux-advisor.md +83 -83
  23. package/agents/qa/acceptance-tester.md +86 -86
  24. package/agents/qa/edge-case-finder.md +93 -93
  25. package/agents/refactor-cleaner.md +143 -143
  26. package/agents/research/best-practices-agent.md +199 -199
  27. package/agents/research/codebase-patterns-agent.md +157 -157
  28. package/agents/research/framework-docs-agent.md +188 -188
  29. package/agents/research/security-advisory-agent.md +213 -213
  30. package/agents/review/architecture-reviewer.md +107 -107
  31. package/agents/review/complexity-reviewer.md +116 -116
  32. package/agents/review/data-integrity-reviewer.md +88 -88
  33. package/agents/review/git-history-reviewer.md +103 -103
  34. package/agents/review/performance-reviewer.md +86 -86
  35. package/agents/review/python-reviewer.md +150 -150
  36. package/agents/review/rails-reviewer.md +139 -139
  37. package/agents/review/react-reviewer.md +144 -144
  38. package/agents/review/security-reviewer.md +80 -80
  39. package/agents/review/simplicity-reviewer.md +140 -140
  40. package/agents/review/test-coverage-reviewer.md +116 -116
  41. package/agents/review/typescript-reviewer.md +127 -127
  42. package/agents/searcher.md +54 -54
  43. package/agents/simplifier.md +120 -120
  44. package/agents/tester.md +49 -49
  45. package/agents/ui/ui-a11y-auditor.md +93 -93
  46. package/agents/ui/ui-antipattern-detector.md +94 -94
  47. package/agents/ui/ui-dataviz-advisor.md +69 -69
  48. package/agents/ui/ui-design-system-gen.md +57 -57
  49. package/agents/ui/ui-industry-analyzer.md +49 -49
  50. package/agents/ui/ui-layout-architect.md +65 -65
  51. package/agents/ui/ui-stack-implementer.md +68 -68
  52. package/agents/ui/ux-compliance-reviewer.md +81 -81
  53. package/agents/ui-previewer.md +258 -258
  54. package/commands/vibe.analyze.md +11 -13
  55. package/commands/vibe.review.md +43 -1
  56. package/commands/vibe.run.md +2124 -2078
  57. package/commands/vibe.spec.md +9 -4
  58. package/commands/vibe.spec.review.md +569 -565
  59. package/commands/vibe.utils.md +413 -413
  60. package/commands/vibe.verify.md +33 -8
  61. package/dist/cli/collaborator.js +52 -52
  62. package/dist/cli/commands/evolution.js +12 -12
  63. package/dist/cli/commands/info.d.ts.map +1 -1
  64. package/dist/cli/commands/info.js +51 -55
  65. package/dist/cli/commands/info.js.map +1 -1
  66. package/dist/cli/commands/init.js +5 -5
  67. package/dist/cli/commands/remove.js +14 -14
  68. package/dist/cli/commands/sentinel.js +27 -27
  69. package/dist/cli/commands/skills.js +5 -5
  70. package/dist/cli/commands/slack.js +10 -10
  71. package/dist/cli/commands/telegram.js +12 -12
  72. package/dist/cli/detect.js +32 -32
  73. package/dist/cli/index.js +51 -51
  74. package/dist/cli/llm/claude-commands.js +16 -16
  75. package/dist/cli/llm/config.js +18 -18
  76. package/dist/cli/llm/gemini-commands.js +16 -16
  77. package/dist/cli/llm/gpt-commands.js +19 -19
  78. package/dist/cli/llm/help.js +21 -21
  79. package/dist/cli/postinstall/constants.d.ts.map +1 -1
  80. package/dist/cli/postinstall/constants.js +7 -8
  81. package/dist/cli/postinstall/constants.js.map +1 -1
  82. package/dist/cli/postinstall/cursor-agents.js +32 -32
  83. package/dist/cli/postinstall/cursor-rules.js +83 -83
  84. package/dist/cli/postinstall/cursor-skills.js +743 -743
  85. package/dist/cli/setup/Provisioner.js +42 -42
  86. package/dist/infra/lib/DeepInit.js +24 -24
  87. package/dist/infra/lib/IterationTracker.js +11 -11
  88. package/dist/infra/lib/PythonParser.js +108 -108
  89. package/dist/infra/lib/ReviewRace.js +96 -96
  90. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  91. package/dist/infra/lib/SkillQualityGate.js +9 -9
  92. package/dist/infra/lib/SkillRepository.js +159 -159
  93. package/dist/infra/lib/UltraQA.js +99 -99
  94. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  95. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  96. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  97. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  98. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  99. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  100. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  101. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  102. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  103. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  104. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  105. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  106. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  107. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  108. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  109. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  110. package/dist/infra/lib/gemini/orchestration.js +5 -5
  111. package/dist/infra/lib/gpt/orchestration.js +4 -4
  112. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  113. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  114. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  115. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  116. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  117. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  118. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  119. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  120. package/dist/infra/orchestrator/AgentManager.js +12 -12
  121. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  122. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  123. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  124. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  125. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  126. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  127. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  128. package/dist/tools/memory/getMemoryGraph.js +12 -12
  129. package/dist/tools/memory/getSessionContext.js +9 -9
  130. package/dist/tools/memory/linkMemories.js +14 -14
  131. package/dist/tools/memory/listMemories.js +4 -4
  132. package/dist/tools/memory/recallMemory.js +4 -4
  133. package/dist/tools/memory/saveMemory.js +4 -4
  134. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  135. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  136. package/dist/tools/semantic/astGrep.test.js +6 -6
  137. package/dist/tools/spec/prdParser.test.js +171 -171
  138. package/dist/tools/spec/specGenerator.js +169 -169
  139. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  140. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  141. package/hooks/gemini-hooks.json +73 -73
  142. package/hooks/hooks.json +137 -137
  143. package/hooks/scripts/code-check.js +77 -70
  144. package/hooks/scripts/context-save.js +212 -212
  145. package/hooks/scripts/hud-status.js +291 -291
  146. package/hooks/scripts/keyword-detector.js +214 -214
  147. package/hooks/scripts/llm-orchestrate.js +475 -475
  148. package/hooks/scripts/post-edit.js +32 -32
  149. package/hooks/scripts/pre-tool-guard.js +125 -125
  150. package/hooks/scripts/prompt-dispatcher.js +185 -185
  151. package/hooks/scripts/sentinel-guard.js +104 -104
  152. package/hooks/scripts/session-start.js +106 -106
  153. package/hooks/scripts/stop-notify.js +209 -209
  154. package/hooks/scripts/utils.js +100 -100
  155. package/languages/csharp-unity.md +515 -515
  156. package/languages/gdscript-godot.md +470 -470
  157. package/languages/ruby-rails.md +489 -489
  158. package/languages/typescript-angular.md +433 -433
  159. package/languages/typescript-astro.md +416 -416
  160. package/languages/typescript-electron.md +406 -406
  161. package/languages/typescript-nestjs.md +524 -524
  162. package/languages/typescript-svelte.md +407 -407
  163. package/languages/typescript-tauri.md +365 -365
  164. package/package.json +121 -121
  165. package/skills/agents-md/SKILL.md +120 -120
  166. package/skills/arch-guard/SKILL.md +180 -180
  167. package/skills/brand-assets/SKILL.md +146 -146
  168. package/skills/capability-loop/SKILL.md +167 -167
  169. package/skills/characterization-test/SKILL.md +206 -206
  170. package/skills/commerce-patterns/SKILL.md +63 -59
  171. package/skills/commit-push-pr/SKILL.md +75 -75
  172. package/skills/context7-usage/SKILL.md +105 -105
  173. package/skills/core-capabilities/SKILL.md +13 -48
  174. package/skills/e2e-commerce/SKILL.md +61 -57
  175. package/skills/exec-plan/SKILL.md +147 -147
  176. package/skills/frontend-design/SKILL.md +12 -73
  177. package/skills/git-worktree/SKILL.md +72 -72
  178. package/skills/handoff/SKILL.md +109 -109
  179. package/skills/parallel-research/SKILL.md +87 -87
  180. package/skills/priority-todos/SKILL.md +63 -63
  181. package/skills/seo-checklist/SKILL.md +57 -57
  182. package/skills/techdebt/SKILL.md +122 -122
  183. package/skills/tool-fallback/SKILL.md +103 -103
  184. package/skills/typescript-advanced-types/SKILL.md +66 -66
  185. package/skills/ui-ux-pro-max/SKILL.md +221 -206
  186. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  187. package/skills/video-production/SKILL.md +51 -51
  188. package/vibe/config.json +29 -29
  189. package/vibe/constitution.md +227 -227
  190. package/vibe/rules/principles/communication-guide.md +98 -98
  191. package/vibe/rules/principles/development-philosophy.md +52 -52
  192. package/vibe/rules/principles/quick-start.md +102 -102
  193. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  194. package/vibe/rules/quality/checklist.md +276 -276
  195. package/vibe/rules/quality/performance.md +236 -236
  196. package/vibe/rules/quality/testing-strategy.md +440 -440
  197. package/vibe/rules/standards/anti-patterns.md +541 -541
  198. package/vibe/rules/standards/code-structure.md +291 -291
  199. package/vibe/rules/standards/complexity-metrics.md +313 -313
  200. package/vibe/rules/standards/git-workflow.md +237 -237
  201. package/vibe/rules/standards/naming-conventions.md +198 -198
  202. package/vibe/rules/standards/security.md +305 -305
  203. package/vibe/rules/writing/document-style.md +74 -74
  204. package/vibe/setup.sh +31 -31
  205. package/vibe/templates/constitution-template.md +252 -252
  206. package/vibe/templates/contract-backend-template.md +526 -526
  207. package/vibe/templates/contract-frontend-template.md +599 -599
  208. package/vibe/templates/feature-template.md +96 -96
  209. package/vibe/templates/spec-template.md +221 -221
  210. package/vibe/ui-ux-data/charts.csv +26 -26
  211. package/vibe/ui-ux-data/colors.csv +97 -97
  212. package/vibe/ui-ux-data/icons.csv +101 -101
  213. package/vibe/ui-ux-data/landing.csv +31 -31
  214. package/vibe/ui-ux-data/products.csv +96 -96
  215. package/vibe/ui-ux-data/react-performance.csv +45 -45
  216. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  217. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  218. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  219. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  220. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  221. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  222. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  223. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  224. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  225. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  226. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  227. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  228. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  229. package/vibe/ui-ux-data/styles.csv +68 -68
  230. package/vibe/ui-ux-data/typography.csv +57 -57
  231. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  232. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  233. package/vibe/ui-ux-data/version.json +31 -31
  234. package/vibe/ui-ux-data/web-interface.csv +31 -31
package/vibe/config.json CHANGED
@@ -1,30 +1,30 @@
1
- {
2
- "models": {
3
- "gpt": {
4
- "enabled": false,
5
- "authType": "codex-cli",
6
- "role": "architecture",
7
- "description": "Architecture/Debugging/Coding (GPT 5.4)"
8
- },
9
- "gemini": {
10
- "enabled": false,
11
- "authType": "apikey",
12
- "role": "exploration",
13
- "description": "Gemini 3.1 Pro / 3.1 Flash-Lite (Exploration, UI/UX)"
14
- }
15
- },
16
- "stacks": [
17
- {
18
- "type": "typescript-node",
19
- "path": ""
20
- }
21
- ],
22
- "details": {
23
- "databases": [
24
- "SQLite"
25
- ],
26
- "stateManagement": [],
27
- "hosting": [],
28
- "cicd": []
29
- }
1
+ {
2
+ "models": {
3
+ "gpt": {
4
+ "enabled": false,
5
+ "authType": "codex-cli",
6
+ "role": "architecture",
7
+ "description": "Architecture/Debugging/Coding (GPT 5.4)"
8
+ },
9
+ "gemini": {
10
+ "enabled": false,
11
+ "authType": "apikey",
12
+ "role": "exploration",
13
+ "description": "Gemini 3.1 Pro / 3.1 Flash-Lite (Exploration, UI/UX)"
14
+ }
15
+ },
16
+ "stacks": [
17
+ {
18
+ "type": "typescript-node",
19
+ "path": ""
20
+ }
21
+ ],
22
+ "details": {
23
+ "databases": [
24
+ "SQLite"
25
+ ],
26
+ "stateManagement": [],
27
+ "hosting": [],
28
+ "cicd": []
29
+ }
30
30
  }
@@ -1,227 +1,227 @@
1
- # Project Constitution
2
-
3
- This document defines the core principles and coding standards for the project.
4
-
5
- ---
6
-
7
- ## Conversation Language
8
-
9
- **Response Language**: Auto-detected from OS (en/ko)
10
-
11
- This setting controls **conversation language with user only**.
12
- All generated documents (SPEC, Feature, etc.) are **always in English**.
13
-
14
- To change, modify in `.claude/vibe/config.json`:
15
-
16
- ```json
17
- {
18
- "language": "ko" // "en" | "ko" - conversation language only
19
- }
20
- ```
21
-
22
- ---
23
-
24
- ## Document References
25
-
26
- All reference documents are stored globally and specified in `.claude/vibe/config.json`:
27
-
28
- ```json
29
- {
30
- "references": {
31
- "rules": [
32
- "~/.claude/vibe/rules/principles/quick-start.md",
33
- "~/.claude/vibe/rules/principles/development-philosophy.md",
34
- "~/.claude/vibe/rules/principles/communication-guide.md",
35
- "~/.claude/vibe/rules/quality/checklist.md",
36
- "~/.claude/vibe/rules/quality/bdd-contract-testing.md",
37
- "~/.claude/vibe/rules/quality/testing-strategy.md",
38
- "~/.claude/vibe/rules/standards/anti-patterns.md",
39
- "~/.claude/vibe/rules/standards/code-structure.md",
40
- "~/.claude/vibe/rules/standards/complexity-metrics.md",
41
- "~/.claude/vibe/rules/standards/naming-conventions.md"
42
- ],
43
- "languages": [
44
- "~/.claude/vibe/languages/{detected-stack}.md"
45
- ],
46
- "templates": [
47
- "~/.claude/vibe/templates/spec-template.md",
48
- "~/.claude/vibe/templates/feature-template.md",
49
- "~/.claude/vibe/templates/constitution-template.md",
50
- "~/.claude/vibe/templates/contract-backend-template.md",
51
- "~/.claude/vibe/templates/contract-frontend-template.md"
52
- ]
53
- }
54
- }
55
- ```
56
-
57
- - **rules**: Core principles, quality standards, coding conventions (10 documents)
58
- - **languages**: Stack-specific coding standards (auto-detected from package.json)
59
- - **templates**: Document templates for SPEC, Feature, Contract tests (5 documents)
60
-
61
- ---
62
-
63
- ## 1. Project Principles
64
-
65
- ### Values
66
- 1. **User-Centric**: User experience first
67
- 2. **Quality**: Correct over fast
68
- 3. **Simplicity**: Simple over complex
69
- 4. **Collaboration**: Team over individual
70
-
71
- ### Decision Criteria
72
- 1. Security > Performance > Convenience
73
- 2. Clarity > Cleverness
74
- 3. Testable > Abstract Design
75
-
76
- ---
77
-
78
- ## 2. Coding Standards
79
-
80
- ### Common Principles
81
- - **DRY**: Don't Repeat Yourself
82
- - **SRP**: Single Responsibility Principle
83
- - **YAGNI**: You Aren't Gonna Need It
84
- - **Functions ≤30 lines** (recommended), ≤50 lines (allowed)
85
- - **Cyclomatic Complexity ≤10**
86
- - **Cognitive Complexity ≤15**
87
-
88
- ### Naming Rules
89
- - Variables: nouns (`userData`, `userList`)
90
- - Functions: verb+noun (`fetchData`, `updateUser`)
91
- - Boolean: `is/has/can` (`isLoading`, `hasError`)
92
- - Constants: `UPPER_SNAKE_CASE` (`MAX_RETRY_COUNT`)
93
-
94
- ---
95
-
96
- ## 3. Quality Standards (TRUST 5)
97
-
98
- ### T - Test-first
99
- - ✅ Contract Testing (highest priority)
100
- - ✅ Integration Testing (70%+ coverage)
101
- - 🔵 Unit Testing (pure functions only)
102
-
103
- ### R - Readable
104
- - Clear comments and docstrings
105
- - Descriptive variable names
106
- - Comments for complex logic
107
-
108
- ### U - Unified
109
- - Consistent coding style
110
- - Same patterns across project
111
-
112
- ### S - Secured
113
- - SQL Injection prevention
114
- - XSS prevention
115
- - Sensitive info via environment variables
116
-
117
- ### T - Trackable
118
- - Clear git commit messages
119
- - Use TODO/FIXME comments
120
- - Document important decisions
121
-
122
- ---
123
-
124
- ## 4. Tech Stack
125
-
126
- ### Backend
127
- - Language: TypeScript/Node.js
128
- - Framework: Express/Fastify
129
- - Database: SQLite
130
-
131
- ### Frontend
132
- - Framework: {Flutter / React / etc.}
133
- - State Management: (configure per project)
134
-
135
- ### Infrastructure
136
- - Hosting: (configure per project)
137
- - CI/CD: (configure per project)
138
-
139
- ---
140
-
141
- ## 5. Git Workflow
142
-
143
- ### Branch Strategy
144
- - `main`: Production
145
- - `develop`: Development (default branch)
146
- - `feature/{feature-name}`: New features
147
- - `fix/{bug-name}`: Bug fixes
148
-
149
- ### Commit Message Rules
150
- ```
151
- feat: Add new feature
152
- fix: Fix bug
153
- docs: Update documentation
154
- refactor: Refactoring
155
- test: Add/modify tests
156
- chore: Build, config changes
157
- ```
158
-
159
- ### PR Rules
160
- 1. SPEC-based development
161
- 2. Code review required
162
- 3. Tests must pass
163
- 4. SPEC verification complete
164
-
165
- ---
166
-
167
- ## 6. Code Review Criteria
168
-
169
- ### Required Checks
170
- - [ ] SPEC requirements met
171
- - [ ] TRUST 5 compliant
172
- - [ ] Tests written and passing
173
- - [ ] Documentation complete
174
- - [ ] No security issues
175
-
176
- ### Recommendations
177
- - [ ] Performance optimization considered
178
- - [ ] Scalability considered
179
- - [ ] Error handling complete
180
-
181
- ---
182
-
183
- ## 7. Documentation Rules
184
-
185
- ### Code Comments
186
- - All functions: docstrings
187
- - Complex logic: inline comments
188
- - TODO/FIXME: include issue number
189
-
190
- ### API Documentation
191
- - OpenAPI (Swagger) auto-generated
192
- - Include example Request/Response
193
-
194
- ### README
195
- - Project overview
196
- - Installation and run instructions
197
- - Main features description
198
-
199
- ---
200
-
201
- ## 8. Security Policy
202
-
203
- ### Authentication
204
- - JWT-based authentication
205
- - Refresh token usage
206
-
207
- ### Authorization
208
- - Role-based Access Control
209
- - Least privilege principle
210
-
211
- ### Data Protection
212
- - Encrypt personal information
213
- - HTTPS required
214
- - Manage secrets via environment variables
215
-
216
- ---
217
-
218
- ## 9. Performance Goals
219
-
220
- ### Response Time
221
- - API: P95 < 500ms
222
- - Web page: FCP < 1.5s
223
-
224
- ### Availability
225
- - Uptime: 99.9%
226
- - RTO: 1 hour
227
- - RPO: 15 minutes
1
+ # Project Constitution
2
+
3
+ This document defines the core principles and coding standards for the project.
4
+
5
+ ---
6
+
7
+ ## Conversation Language
8
+
9
+ **Response Language**: Auto-detected from OS (en/ko)
10
+
11
+ This setting controls **conversation language with user only**.
12
+ All generated documents (SPEC, Feature, etc.) are **always in English**.
13
+
14
+ To change, modify in `.claude/vibe/config.json`:
15
+
16
+ ```json
17
+ {
18
+ "language": "ko" // "en" | "ko" - conversation language only
19
+ }
20
+ ```
21
+
22
+ ---
23
+
24
+ ## Document References
25
+
26
+ All reference documents are stored globally and specified in `.claude/vibe/config.json`:
27
+
28
+ ```json
29
+ {
30
+ "references": {
31
+ "rules": [
32
+ "~/.claude/vibe/rules/principles/quick-start.md",
33
+ "~/.claude/vibe/rules/principles/development-philosophy.md",
34
+ "~/.claude/vibe/rules/principles/communication-guide.md",
35
+ "~/.claude/vibe/rules/quality/checklist.md",
36
+ "~/.claude/vibe/rules/quality/bdd-contract-testing.md",
37
+ "~/.claude/vibe/rules/quality/testing-strategy.md",
38
+ "~/.claude/vibe/rules/standards/anti-patterns.md",
39
+ "~/.claude/vibe/rules/standards/code-structure.md",
40
+ "~/.claude/vibe/rules/standards/complexity-metrics.md",
41
+ "~/.claude/vibe/rules/standards/naming-conventions.md"
42
+ ],
43
+ "languages": [
44
+ "~/.claude/vibe/languages/{detected-stack}.md"
45
+ ],
46
+ "templates": [
47
+ "~/.claude/vibe/templates/spec-template.md",
48
+ "~/.claude/vibe/templates/feature-template.md",
49
+ "~/.claude/vibe/templates/constitution-template.md",
50
+ "~/.claude/vibe/templates/contract-backend-template.md",
51
+ "~/.claude/vibe/templates/contract-frontend-template.md"
52
+ ]
53
+ }
54
+ }
55
+ ```
56
+
57
+ - **rules**: Core principles, quality standards, coding conventions (10 documents)
58
+ - **languages**: Stack-specific coding standards (auto-detected from package.json)
59
+ - **templates**: Document templates for SPEC, Feature, Contract tests (5 documents)
60
+
61
+ ---
62
+
63
+ ## 1. Project Principles
64
+
65
+ ### Values
66
+ 1. **User-Centric**: User experience first
67
+ 2. **Quality**: Correct over fast
68
+ 3. **Simplicity**: Simple over complex
69
+ 4. **Collaboration**: Team over individual
70
+
71
+ ### Decision Criteria
72
+ 1. Security > Performance > Convenience
73
+ 2. Clarity > Cleverness
74
+ 3. Testable > Abstract Design
75
+
76
+ ---
77
+
78
+ ## 2. Coding Standards
79
+
80
+ ### Common Principles
81
+ - **DRY**: Don't Repeat Yourself
82
+ - **SRP**: Single Responsibility Principle
83
+ - **YAGNI**: You Aren't Gonna Need It
84
+ - **Functions ≤30 lines** (recommended), ≤50 lines (allowed)
85
+ - **Cyclomatic Complexity ≤10**
86
+ - **Cognitive Complexity ≤15**
87
+
88
+ ### Naming Rules
89
+ - Variables: nouns (`userData`, `userList`)
90
+ - Functions: verb+noun (`fetchData`, `updateUser`)
91
+ - Boolean: `is/has/can` (`isLoading`, `hasError`)
92
+ - Constants: `UPPER_SNAKE_CASE` (`MAX_RETRY_COUNT`)
93
+
94
+ ---
95
+
96
+ ## 3. Quality Standards (TRUST 5)
97
+
98
+ ### T - Test-first
99
+ - ✅ Contract Testing (highest priority)
100
+ - ✅ Integration Testing (70%+ coverage)
101
+ - 🔵 Unit Testing (pure functions only)
102
+
103
+ ### R - Readable
104
+ - Clear comments and docstrings
105
+ - Descriptive variable names
106
+ - Comments for complex logic
107
+
108
+ ### U - Unified
109
+ - Consistent coding style
110
+ - Same patterns across project
111
+
112
+ ### S - Secured
113
+ - SQL Injection prevention
114
+ - XSS prevention
115
+ - Sensitive info via environment variables
116
+
117
+ ### T - Trackable
118
+ - Clear git commit messages
119
+ - Use TODO/FIXME comments
120
+ - Document important decisions
121
+
122
+ ---
123
+
124
+ ## 4. Tech Stack
125
+
126
+ ### Backend
127
+ - Language: TypeScript/Node.js
128
+ - Framework: Express/Fastify
129
+ - Database: SQLite
130
+
131
+ ### Frontend
132
+ - Framework: {Flutter / React / etc.}
133
+ - State Management: (configure per project)
134
+
135
+ ### Infrastructure
136
+ - Hosting: (configure per project)
137
+ - CI/CD: (configure per project)
138
+
139
+ ---
140
+
141
+ ## 5. Git Workflow
142
+
143
+ ### Branch Strategy
144
+ - `main`: Production
145
+ - `develop`: Development (default branch)
146
+ - `feature/{feature-name}`: New features
147
+ - `fix/{bug-name}`: Bug fixes
148
+
149
+ ### Commit Message Rules
150
+ ```
151
+ feat: Add new feature
152
+ fix: Fix bug
153
+ docs: Update documentation
154
+ refactor: Refactoring
155
+ test: Add/modify tests
156
+ chore: Build, config changes
157
+ ```
158
+
159
+ ### PR Rules
160
+ 1. SPEC-based development
161
+ 2. Code review required
162
+ 3. Tests must pass
163
+ 4. SPEC verification complete
164
+
165
+ ---
166
+
167
+ ## 6. Code Review Criteria
168
+
169
+ ### Required Checks
170
+ - [ ] SPEC requirements met
171
+ - [ ] TRUST 5 compliant
172
+ - [ ] Tests written and passing
173
+ - [ ] Documentation complete
174
+ - [ ] No security issues
175
+
176
+ ### Recommendations
177
+ - [ ] Performance optimization considered
178
+ - [ ] Scalability considered
179
+ - [ ] Error handling complete
180
+
181
+ ---
182
+
183
+ ## 7. Documentation Rules
184
+
185
+ ### Code Comments
186
+ - All functions: docstrings
187
+ - Complex logic: inline comments
188
+ - TODO/FIXME: include issue number
189
+
190
+ ### API Documentation
191
+ - OpenAPI (Swagger) auto-generated
192
+ - Include example Request/Response
193
+
194
+ ### README
195
+ - Project overview
196
+ - Installation and run instructions
197
+ - Main features description
198
+
199
+ ---
200
+
201
+ ## 8. Security Policy
202
+
203
+ ### Authentication
204
+ - JWT-based authentication
205
+ - Refresh token usage
206
+
207
+ ### Authorization
208
+ - Role-based Access Control
209
+ - Least privilege principle
210
+
211
+ ### Data Protection
212
+ - Encrypt personal information
213
+ - HTTPS required
214
+ - Manage secrets via environment variables
215
+
216
+ ---
217
+
218
+ ## 9. Performance Goals
219
+
220
+ ### Response Time
221
+ - API: P95 < 500ms
222
+ - Web page: FCP < 1.5s
223
+
224
+ ### Availability
225
+ - Uptime: 99.9%
226
+ - RTO: 1 hour
227
+ - RPO: 15 minutes