@su-record/vibe 2.7.12 → 2.7.14

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