@su-record/vibe 2.7.17 → 2.7.18

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 (245) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +153 -134
  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 +379 -379
  55. package/commands/vibe.review.md +607 -607
  56. package/commands/vibe.run.md +2124 -2124
  57. package/commands/vibe.spec.md +1195 -1195
  58. package/commands/vibe.spec.review.md +569 -569
  59. package/commands/vibe.utils.md +413 -413
  60. package/commands/vibe.verify.md +484 -484
  61. package/dist/cli/collaborator.js +52 -52
  62. package/dist/cli/commands/evolution.js +12 -12
  63. package/dist/cli/commands/info.js +51 -51
  64. package/dist/cli/commands/init.js +5 -5
  65. package/dist/cli/commands/remove.js +14 -14
  66. package/dist/cli/commands/sentinel.js +27 -27
  67. package/dist/cli/commands/skills.js +5 -5
  68. package/dist/cli/commands/slack.js +10 -10
  69. package/dist/cli/commands/telegram.js +12 -12
  70. package/dist/cli/detect.js +32 -32
  71. package/dist/cli/index.js +51 -51
  72. package/dist/cli/llm/claude-commands.js +16 -16
  73. package/dist/cli/llm/config.js +18 -18
  74. package/dist/cli/llm/gemini-commands.js +16 -16
  75. package/dist/cli/llm/gpt-commands.js +19 -19
  76. package/dist/cli/llm/help.js +21 -21
  77. package/dist/cli/postinstall/cursor-agents.js +32 -32
  78. package/dist/cli/postinstall/cursor-rules.js +83 -83
  79. package/dist/cli/postinstall/cursor-skills.js +743 -743
  80. package/dist/cli/setup/Provisioner.js +42 -42
  81. package/dist/infra/lib/DeepInit.js +24 -24
  82. package/dist/infra/lib/IterationTracker.js +11 -11
  83. package/dist/infra/lib/PythonParser.js +108 -108
  84. package/dist/infra/lib/ReviewRace.js +96 -96
  85. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  86. package/dist/infra/lib/SkillQualityGate.js +9 -9
  87. package/dist/infra/lib/SkillRepository.js +159 -159
  88. package/dist/infra/lib/UltraQA.js +99 -99
  89. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  90. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  91. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  92. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  93. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  94. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  95. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  96. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  97. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  98. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  99. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  100. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  101. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  102. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  103. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  104. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  105. package/dist/infra/lib/gemini/orchestration.js +5 -5
  106. package/dist/infra/lib/gpt/orchestration.js +4 -4
  107. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  108. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  109. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  110. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  111. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  112. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  113. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  114. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  115. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts +52 -0
  116. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts.map +1 -0
  117. package/dist/infra/lib/telemetry/SkillTelemetry.js +117 -0
  118. package/dist/infra/lib/telemetry/SkillTelemetry.js.map +1 -0
  119. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts +2 -0
  120. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts.map +1 -0
  121. package/dist/infra/lib/telemetry/SkillTelemetry.test.js +91 -0
  122. package/dist/infra/lib/telemetry/SkillTelemetry.test.js.map +1 -0
  123. package/dist/infra/orchestrator/AgentManager.js +12 -12
  124. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  125. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  126. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  127. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  128. package/dist/test-helpers/index.d.ts +36 -0
  129. package/dist/test-helpers/index.d.ts.map +1 -0
  130. package/dist/test-helpers/index.js +85 -0
  131. package/dist/test-helpers/index.js.map +1 -0
  132. package/dist/test-helpers/index.test.d.ts +2 -0
  133. package/dist/test-helpers/index.test.d.ts.map +1 -0
  134. package/dist/test-helpers/index.test.js +92 -0
  135. package/dist/test-helpers/index.test.js.map +1 -0
  136. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  137. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  138. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  139. package/dist/tools/memory/getMemoryGraph.js +12 -12
  140. package/dist/tools/memory/getSessionContext.js +9 -9
  141. package/dist/tools/memory/linkMemories.js +14 -14
  142. package/dist/tools/memory/listMemories.js +4 -4
  143. package/dist/tools/memory/recallMemory.js +4 -4
  144. package/dist/tools/memory/saveMemory.js +4 -4
  145. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  146. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  147. package/dist/tools/semantic/astGrep.test.js +6 -6
  148. package/dist/tools/spec/prdParser.test.js +171 -171
  149. package/dist/tools/spec/specGenerator.js +169 -169
  150. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  151. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  152. package/hooks/gemini-hooks.json +73 -73
  153. package/hooks/hooks.json +137 -137
  154. package/hooks/scripts/code-check.js +77 -77
  155. package/hooks/scripts/context-save.js +212 -212
  156. package/hooks/scripts/hud-status.js +291 -291
  157. package/hooks/scripts/keyword-detector.js +214 -214
  158. package/hooks/scripts/llm-orchestrate.js +475 -475
  159. package/hooks/scripts/post-edit.js +32 -32
  160. package/hooks/scripts/pre-tool-guard.js +125 -125
  161. package/hooks/scripts/prompt-dispatcher.js +185 -185
  162. package/hooks/scripts/sentinel-guard.js +104 -104
  163. package/hooks/scripts/session-start.js +106 -106
  164. package/hooks/scripts/stop-notify.js +209 -209
  165. package/hooks/scripts/utils.js +100 -100
  166. package/languages/csharp-unity.md +515 -515
  167. package/languages/gdscript-godot.md +470 -470
  168. package/languages/ruby-rails.md +489 -489
  169. package/languages/typescript-angular.md +433 -433
  170. package/languages/typescript-astro.md +416 -416
  171. package/languages/typescript-electron.md +406 -406
  172. package/languages/typescript-nestjs.md +524 -524
  173. package/languages/typescript-svelte.md +407 -407
  174. package/languages/typescript-tauri.md +365 -365
  175. package/package.json +123 -121
  176. package/skills/agents-md/SKILL.md +120 -120
  177. package/skills/arch-guard/SKILL.md +180 -180
  178. package/skills/brand-assets/SKILL.md +146 -146
  179. package/skills/capability-loop/SKILL.md +167 -167
  180. package/skills/characterization-test/SKILL.md +206 -206
  181. package/skills/commerce-patterns/SKILL.md +63 -63
  182. package/skills/commit-push-pr/SKILL.md +75 -75
  183. package/skills/context7-usage/SKILL.md +105 -105
  184. package/skills/core-capabilities/SKILL.md +13 -13
  185. package/skills/e2e-commerce/SKILL.md +61 -61
  186. package/skills/exec-plan/SKILL.md +147 -147
  187. package/skills/frontend-design/SKILL.md +12 -12
  188. package/skills/git-worktree/SKILL.md +72 -72
  189. package/skills/handoff/SKILL.md +109 -109
  190. package/skills/parallel-research/SKILL.md +87 -87
  191. package/skills/priority-todos/SKILL.md +63 -63
  192. package/skills/seo-checklist/SKILL.md +57 -57
  193. package/skills/techdebt/SKILL.md +122 -122
  194. package/skills/tool-fallback/SKILL.md +103 -103
  195. package/skills/typescript-advanced-types/SKILL.md +66 -66
  196. package/skills/ui-ux-pro-max/SKILL.md +221 -221
  197. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  198. package/skills/video-production/SKILL.md +51 -51
  199. package/vibe/config.json +29 -29
  200. package/vibe/constitution.md +227 -227
  201. package/vibe/rules/principles/communication-guide.md +98 -98
  202. package/vibe/rules/principles/development-philosophy.md +52 -52
  203. package/vibe/rules/principles/quick-start.md +102 -102
  204. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  205. package/vibe/rules/quality/checklist.md +276 -276
  206. package/vibe/rules/quality/performance.md +236 -236
  207. package/vibe/rules/quality/testing-strategy.md +440 -440
  208. package/vibe/rules/standards/anti-patterns.md +541 -541
  209. package/vibe/rules/standards/code-structure.md +291 -291
  210. package/vibe/rules/standards/complexity-metrics.md +313 -313
  211. package/vibe/rules/standards/git-workflow.md +237 -237
  212. package/vibe/rules/standards/naming-conventions.md +198 -198
  213. package/vibe/rules/standards/security.md +305 -305
  214. package/vibe/rules/writing/document-style.md +74 -74
  215. package/vibe/setup.sh +31 -31
  216. package/vibe/templates/constitution-template.md +252 -252
  217. package/vibe/templates/contract-backend-template.md +526 -526
  218. package/vibe/templates/contract-frontend-template.md +599 -599
  219. package/vibe/templates/feature-template.md +96 -96
  220. package/vibe/templates/spec-template.md +221 -221
  221. package/vibe/ui-ux-data/charts.csv +26 -26
  222. package/vibe/ui-ux-data/colors.csv +97 -97
  223. package/vibe/ui-ux-data/icons.csv +101 -101
  224. package/vibe/ui-ux-data/landing.csv +31 -31
  225. package/vibe/ui-ux-data/products.csv +96 -96
  226. package/vibe/ui-ux-data/react-performance.csv +45 -45
  227. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  228. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  229. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  230. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  231. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  232. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  233. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  234. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  235. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  236. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  237. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  238. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  239. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  240. package/vibe/ui-ux-data/styles.csv +68 -68
  241. package/vibe/ui-ux-data/typography.csv +57 -57
  242. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  243. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  244. package/vibe/ui-ux-data/version.json +31 -31
  245. 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