@su-record/vibe 2.7.10 → 2.7.12

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