@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
@@ -71,45 +71,45 @@ function generateSplitSpec(prd, featureName, phases, options) {
71
71
  function buildSpecContent(prd, featureName, phases, options) {
72
72
  const { techStack = [], relatedCodePaths = [], designReference, additionalConstraints = [], additionalOutputs = [] } = options;
73
73
  const now = new Date().toISOString();
74
- let content = `---
75
- status: pending
76
- currentPhase: 0
77
- totalPhases: ${phases.length}
78
- createdAt: ${now}
79
- lastUpdated: ${now}
80
- ---
81
-
82
- # SPEC: ${featureName}
83
-
84
- ## Persona
85
- <role>
86
- Senior developer implementing ${featureName}.
87
- - Follow existing code patterns and conventions
88
- - Write testable, maintainable code
89
- - Consider security and performance implications
90
- </role>
91
-
92
- ## Context
93
- <context>
94
- ### Background
95
- ${prd.description || `Implementation of ${prd.title}`}
96
-
97
- ### Tech Stack
98
- ${techStack.length > 0 ? techStack.map(t => `- ${t}`).join('\n') : '- (To be determined based on project)'}
99
-
100
- ### Related Code
101
- ${relatedCodePaths.length > 0 ? relatedCodePaths.map(p => `- \`${p}\``).join('\n') : '- (Analyze existing codebase for patterns)'}
102
-
103
- ### Design Reference
104
- ${designReference || '- (None specified)'}
105
-
106
- ### Requirements Source
107
- - Parsed from PRD: ${prd.requirements.length} requirements
108
- - Format: ${prd.metadata.format}
109
- </context>
110
-
111
- ## Task
112
- <task>
74
+ let content = `---
75
+ status: pending
76
+ currentPhase: 0
77
+ totalPhases: ${phases.length}
78
+ createdAt: ${now}
79
+ lastUpdated: ${now}
80
+ ---
81
+
82
+ # SPEC: ${featureName}
83
+
84
+ ## Persona
85
+ <role>
86
+ Senior developer implementing ${featureName}.
87
+ - Follow existing code patterns and conventions
88
+ - Write testable, maintainable code
89
+ - Consider security and performance implications
90
+ </role>
91
+
92
+ ## Context
93
+ <context>
94
+ ### Background
95
+ ${prd.description || `Implementation of ${prd.title}`}
96
+
97
+ ### Tech Stack
98
+ ${techStack.length > 0 ? techStack.map(t => `- ${t}`).join('\n') : '- (To be determined based on project)'}
99
+
100
+ ### Related Code
101
+ ${relatedCodePaths.length > 0 ? relatedCodePaths.map(p => `- \`${p}\``).join('\n') : '- (Analyze existing codebase for patterns)'}
102
+
103
+ ### Design Reference
104
+ ${designReference || '- (None specified)'}
105
+
106
+ ### Requirements Source
107
+ - Parsed from PRD: ${prd.requirements.length} requirements
108
+ - Format: ${prd.metadata.format}
109
+ </context>
110
+
111
+ ## Task
112
+ <task>
113
113
  `;
114
114
  // Phase별 태스크 추가
115
115
  for (let i = 0; i < phases.length; i++) {
@@ -121,47 +121,47 @@ ${designReference || '- (None specified)'}
121
121
  }
122
122
  content += '\n';
123
123
  }
124
- content += `</task>
125
-
126
- ## Constraints
127
- <constraints>
128
- ### Must Follow
129
- - Follow existing code patterns (ES Module, async/await)
130
- - Maintain backward compatibility
131
- - TypeScript strict mode compliance
132
- - No \`any\` type → Use \`unknown\` + type guards
133
- - Functions ≤30 lines recommended, ≤50 lines max
134
- - Nesting ≤3 levels
135
-
136
- ### Error Handling
137
- - Proper try-catch with meaningful error messages
138
- - Loading state handling for async operations
139
- - User-friendly error messages
140
-
141
- ### Security
142
- - Input validation for all user inputs
143
- - Authentication/authorization checks where needed
144
- - No sensitive data in logs
145
- ${additionalConstraints.map(c => `\n- ${c}`).join('')}
146
- </constraints>
147
-
148
- ## Output Format
149
- <output_format>
150
- ### Files to Create
151
- ${generateFileList(phases, 'create')}
152
-
153
- ### Files to Modify
154
- ${generateFileList(phases, 'modify')}
155
-
156
- ### Verification Commands
157
- - \`npm run build\` (build success)
158
- - \`npm test\` (tests pass)
159
- - \`tsc --noEmit\` (type check)
160
- ${additionalOutputs.map(o => `- ${o}`).join('\n')}
161
- </output_format>
162
-
163
- ## Acceptance Criteria
164
- <acceptance>
124
+ content += `</task>
125
+
126
+ ## Constraints
127
+ <constraints>
128
+ ### Must Follow
129
+ - Follow existing code patterns (ES Module, async/await)
130
+ - Maintain backward compatibility
131
+ - TypeScript strict mode compliance
132
+ - No \`any\` type → Use \`unknown\` + type guards
133
+ - Functions ≤30 lines recommended, ≤50 lines max
134
+ - Nesting ≤3 levels
135
+
136
+ ### Error Handling
137
+ - Proper try-catch with meaningful error messages
138
+ - Loading state handling for async operations
139
+ - User-friendly error messages
140
+
141
+ ### Security
142
+ - Input validation for all user inputs
143
+ - Authentication/authorization checks where needed
144
+ - No sensitive data in logs
145
+ ${additionalConstraints.map(c => `\n- ${c}`).join('')}
146
+ </constraints>
147
+
148
+ ## Output Format
149
+ <output_format>
150
+ ### Files to Create
151
+ ${generateFileList(phases, 'create')}
152
+
153
+ ### Files to Modify
154
+ ${generateFileList(phases, 'modify')}
155
+
156
+ ### Verification Commands
157
+ - \`npm run build\` (build success)
158
+ - \`npm test\` (tests pass)
159
+ - \`tsc --noEmit\` (type check)
160
+ ${additionalOutputs.map(o => `- ${o}`).join('\n')}
161
+ </output_format>
162
+
163
+ ## Acceptance Criteria
164
+ <acceptance>
165
165
  `;
166
166
  // 요구사항별 AC 추가
167
167
  for (const req of prd.requirements) {
@@ -176,11 +176,11 @@ ${additionalOutputs.map(o => `- ${o}`).join('\n')}
176
176
  }
177
177
  content += '\n';
178
178
  }
179
- content += `### Build & Test
180
- - [ ] \`npm run build\` succeeds
181
- - [ ] All tests pass
182
- - [ ] No TypeScript errors
183
- </acceptance>
179
+ content += `### Build & Test
180
+ - [ ] \`npm run build\` succeeds
181
+ - [ ] All tests pass
182
+ - [ ] No TypeScript errors
183
+ </acceptance>
184
184
  `;
185
185
  return content;
186
186
  }
@@ -189,53 +189,53 @@ ${additionalOutputs.map(o => `- ${o}`).join('\n')}
189
189
  */
190
190
  function buildMasterSpecContent(prd, featureName, phases, options) {
191
191
  const now = new Date().toISOString();
192
- let content = `---
193
- status: pending
194
- currentPhase: 0
195
- totalPhases: ${phases.length}
196
- createdAt: ${now}
197
- lastUpdated: ${now}
198
- isMaster: true
199
- ---
200
-
201
- # SPEC: ${featureName} (Master)
202
-
203
- ## Overview
204
- - **Feature**: ${prd.title}
205
- - **Total Phases**: ${phases.length}
206
- - **Total Requirements**: ${prd.requirements.length}
207
- - **Format**: Split SPEC (large scope)
208
-
209
- ## Sub-SPECs
210
-
211
- | Order | SPEC File | Description | Status |
212
- |-------|-----------|-------------|--------|
192
+ let content = `---
193
+ status: pending
194
+ currentPhase: 0
195
+ totalPhases: ${phases.length}
196
+ createdAt: ${now}
197
+ lastUpdated: ${now}
198
+ isMaster: true
199
+ ---
200
+
201
+ # SPEC: ${featureName} (Master)
202
+
203
+ ## Overview
204
+ - **Feature**: ${prd.title}
205
+ - **Total Phases**: ${phases.length}
206
+ - **Total Requirements**: ${prd.requirements.length}
207
+ - **Format**: Split SPEC (large scope)
208
+
209
+ ## Sub-SPECs
210
+
211
+ | Order | SPEC File | Description | Status |
212
+ |-------|-----------|-------------|--------|
213
213
  `;
214
214
  for (let i = 0; i < phases.length; i++) {
215
215
  const phase = phases[i];
216
216
  const fileName = `phase-${i + 1}-${normalizeFileName(phase.name)}.md`;
217
217
  content += `| ${i + 1} | ${fileName} | ${phase.name} | ⬜ |\n`;
218
218
  }
219
- content += `
220
- ## Shared Context
221
-
222
- ### Tech Stack
223
- ${options.techStack?.map(t => `- ${t}`).join('\n') || '- (See project configuration)'}
224
-
225
- ### Constraints (Apply to All Phases)
226
- - Follow existing code patterns
227
- - TypeScript strict mode
228
- - No \`any\` type
229
- - Functions ≤50 lines max
230
- ${options.additionalConstraints?.map(c => `- ${c}`).join('\n') || ''}
231
-
232
- ## Execution Order
233
- \`\`\`
234
- ${phases.map((p, i) => `Phase ${i + 1}: ${p.name}`).join(' → ')}
235
- \`\`\`
236
-
237
- ## Dependencies
238
- ${generateDependencyList(phases)}
219
+ content += `
220
+ ## Shared Context
221
+
222
+ ### Tech Stack
223
+ ${options.techStack?.map(t => `- ${t}`).join('\n') || '- (See project configuration)'}
224
+
225
+ ### Constraints (Apply to All Phases)
226
+ - Follow existing code patterns
227
+ - TypeScript strict mode
228
+ - No \`any\` type
229
+ - Functions ≤50 lines max
230
+ ${options.additionalConstraints?.map(c => `- ${c}`).join('\n') || ''}
231
+
232
+ ## Execution Order
233
+ \`\`\`
234
+ ${phases.map((p, i) => `Phase ${i + 1}: ${p.name}`).join(' → ')}
235
+ \`\`\`
236
+
237
+ ## Dependencies
238
+ ${generateDependencyList(phases)}
239
239
  `;
240
240
  return content;
241
241
  }
@@ -244,54 +244,54 @@ ${generateDependencyList(phases)}
244
244
  */
245
245
  function buildPhaseSpecContent(prd, featureName, phase, phaseNumber, totalPhases, options) {
246
246
  const now = new Date().toISOString();
247
- let content = `---
248
- status: pending
249
- phase: ${phaseNumber}
250
- totalPhases: ${totalPhases}
251
- masterSpec: _index.md
252
- createdAt: ${now}
253
- lastUpdated: ${now}
254
- ---
255
-
256
- # SPEC: ${featureName} - Phase ${phaseNumber}: ${phase.name}
257
-
258
- ## Persona
259
- <role>
260
- Developer implementing Phase ${phaseNumber} of ${featureName}.
261
- - Focus on ${phase.name}
262
- - Follow project conventions
263
- - Write testable code
264
- </role>
265
-
266
- ## Context
267
- <context>
268
- ### Phase Goal
269
- ${getPhaseGoal(phase)}
270
-
271
- ### Requirements (${phase.requirements.length})
272
- ${phase.requirements.map(r => `- ${r.id}: ${truncateText(r.description, 50)}`).join('\n')}
273
-
274
- ### Dependencies
275
- ${phaseNumber > 1 ? `- Requires Phase ${phaseNumber - 1} completion` : '- No dependencies (first phase)'}
276
- </context>
277
-
278
- ## Task
279
- <task>
247
+ let content = `---
248
+ status: pending
249
+ phase: ${phaseNumber}
250
+ totalPhases: ${totalPhases}
251
+ masterSpec: _index.md
252
+ createdAt: ${now}
253
+ lastUpdated: ${now}
254
+ ---
255
+
256
+ # SPEC: ${featureName} - Phase ${phaseNumber}: ${phase.name}
257
+
258
+ ## Persona
259
+ <role>
260
+ Developer implementing Phase ${phaseNumber} of ${featureName}.
261
+ - Focus on ${phase.name}
262
+ - Follow project conventions
263
+ - Write testable code
264
+ </role>
265
+
266
+ ## Context
267
+ <context>
268
+ ### Phase Goal
269
+ ${getPhaseGoal(phase)}
270
+
271
+ ### Requirements (${phase.requirements.length})
272
+ ${phase.requirements.map(r => `- ${r.id}: ${truncateText(r.description, 50)}`).join('\n')}
273
+
274
+ ### Dependencies
275
+ ${phaseNumber > 1 ? `- Requires Phase ${phaseNumber - 1} completion` : '- No dependencies (first phase)'}
276
+ </context>
277
+
278
+ ## Task
279
+ <task>
280
280
  `;
281
281
  for (const task of phase.tasks) {
282
282
  content += `1. [ ] ${task}\n`;
283
283
  }
284
- content += `</task>
285
-
286
- ## Acceptance Criteria
287
- <acceptance>
284
+ content += `</task>
285
+
286
+ ## Acceptance Criteria
287
+ <acceptance>
288
288
  `;
289
289
  for (const req of phase.requirements) {
290
290
  content += `- [ ] ${req.id}: ${truncateText(req.description, 60)}\n`;
291
291
  }
292
- content += `- [ ] Phase ${phaseNumber} build succeeds
293
- - [ ] Phase ${phaseNumber} tests pass
294
- </acceptance>
292
+ content += `- [ ] Phase ${phaseNumber} build succeeds
293
+ - [ ] Phase ${phaseNumber} tests pass
294
+ </acceptance>
295
295
  `;
296
296
  return content;
297
297
  }
@@ -384,11 +384,11 @@ function getPhaseGoal(phase) {
384
384
  function generateFileList(phases, type) {
385
385
  // 실제로는 요구사항을 분석해서 추론해야 하지만, 기본 템플릿 제공
386
386
  if (type === 'create') {
387
- return `- (To be determined based on implementation)
388
- - \`src/[feature]/index.ts\`
387
+ return `- (To be determined based on implementation)
388
+ - \`src/[feature]/index.ts\`
389
389
  - \`src/[feature]/[feature].test.ts\``;
390
390
  }
391
- return `- (Analyze existing codebase)
391
+ return `- (Analyze existing codebase)
392
392
  - Relevant existing files`;
393
393
  }
394
394
  /**
@@ -116,74 +116,74 @@ export function formatMatrixAsMarkdown(matrix) {
116
116
  * 매트릭스를 HTML로 출력
117
117
  */
118
118
  export function formatMatrixAsHtml(matrix) {
119
- let html = `<!DOCTYPE html>
120
- <html>
121
- <head>
122
- <title>RTM: ${matrix.featureName}</title>
123
- <style>
124
- body { font-family: -apple-system, BlinkMacSystemFont, sans-serif; margin: 2rem; }
125
- table { border-collapse: collapse; width: 100%; }
126
- th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
127
- th { background: #f5f5f5; }
128
- .full { background: #d4edda; }
129
- .partial { background: #fff3cd; }
130
- .none { background: #f8d7da; }
131
- .summary { display: grid; grid-template-columns: repeat(4, 1fr); gap: 1rem; margin: 1rem 0; }
132
- .summary-card { padding: 1rem; border-radius: 8px; background: #f5f5f5; }
133
- .coverage-bar { height: 20px; background: #e0e0e0; border-radius: 4px; overflow: hidden; }
134
- .coverage-fill { height: 100%; background: #4caf50; }
135
- </style>
136
- </head>
137
- <body>
138
- <h1>RTM: ${matrix.featureName}</h1>
139
- <p>Generated: ${matrix.generatedAt}</p>
140
-
141
- <div class="summary">
142
- <div class="summary-card">
143
- <strong>Requirements</strong><br>${matrix.summary.totalRequirements}
144
- </div>
145
- <div class="summary-card">
146
- <strong>Feature Coverage</strong><br>${matrix.summary.featureCovered}/${matrix.summary.totalRequirements}
147
- </div>
148
- <div class="summary-card">
149
- <strong>Test Coverage</strong><br>${matrix.summary.testCovered}/${matrix.summary.totalRequirements}
150
- </div>
151
- <div class="summary-card">
152
- <strong>Overall</strong><br>
153
- <div class="coverage-bar">
154
- <div class="coverage-fill" style="width: ${matrix.summary.coveragePercent}%"></div>
155
- </div>
156
- ${matrix.summary.coveragePercent}%
157
- </div>
158
- </div>
159
-
160
- <table>
161
- <thead>
162
- <tr>
163
- <th>Requirement</th>
164
- <th>Description</th>
165
- <th>SPEC</th>
166
- <th>Feature</th>
167
- <th>Test</th>
168
- <th>Coverage</th>
169
- </tr>
170
- </thead>
171
- <tbody>
119
+ let html = `<!DOCTYPE html>
120
+ <html>
121
+ <head>
122
+ <title>RTM: ${matrix.featureName}</title>
123
+ <style>
124
+ body { font-family: -apple-system, BlinkMacSystemFont, sans-serif; margin: 2rem; }
125
+ table { border-collapse: collapse; width: 100%; }
126
+ th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
127
+ th { background: #f5f5f5; }
128
+ .full { background: #d4edda; }
129
+ .partial { background: #fff3cd; }
130
+ .none { background: #f8d7da; }
131
+ .summary { display: grid; grid-template-columns: repeat(4, 1fr); gap: 1rem; margin: 1rem 0; }
132
+ .summary-card { padding: 1rem; border-radius: 8px; background: #f5f5f5; }
133
+ .coverage-bar { height: 20px; background: #e0e0e0; border-radius: 4px; overflow: hidden; }
134
+ .coverage-fill { height: 100%; background: #4caf50; }
135
+ </style>
136
+ </head>
137
+ <body>
138
+ <h1>RTM: ${matrix.featureName}</h1>
139
+ <p>Generated: ${matrix.generatedAt}</p>
140
+
141
+ <div class="summary">
142
+ <div class="summary-card">
143
+ <strong>Requirements</strong><br>${matrix.summary.totalRequirements}
144
+ </div>
145
+ <div class="summary-card">
146
+ <strong>Feature Coverage</strong><br>${matrix.summary.featureCovered}/${matrix.summary.totalRequirements}
147
+ </div>
148
+ <div class="summary-card">
149
+ <strong>Test Coverage</strong><br>${matrix.summary.testCovered}/${matrix.summary.totalRequirements}
150
+ </div>
151
+ <div class="summary-card">
152
+ <strong>Overall</strong><br>
153
+ <div class="coverage-bar">
154
+ <div class="coverage-fill" style="width: ${matrix.summary.coveragePercent}%"></div>
155
+ </div>
156
+ ${matrix.summary.coveragePercent}%
157
+ </div>
158
+ </div>
159
+
160
+ <table>
161
+ <thead>
162
+ <tr>
163
+ <th>Requirement</th>
164
+ <th>Description</th>
165
+ <th>SPEC</th>
166
+ <th>Feature</th>
167
+ <th>Test</th>
168
+ <th>Coverage</th>
169
+ </tr>
170
+ </thead>
171
+ <tbody>
172
172
  `;
173
173
  for (const item of matrix.items) {
174
- html += ` <tr class="${item.coverage}">
175
- <td>${item.requirementId}</td>
176
- <td>${escapeHtml(truncate(item.requirementDesc, 50))}</td>
177
- <td>${item.specSection ? '✅' : '❌'}</td>
178
- <td>${item.featureScenario ? '✅' : '❌'}</td>
179
- <td>${item.testName ? '✅' : '❌'}</td>
180
- <td>${getCoverageIcon(item.coverage)}</td>
181
- </tr>
174
+ html += ` <tr class="${item.coverage}">
175
+ <td>${item.requirementId}</td>
176
+ <td>${escapeHtml(truncate(item.requirementDesc, 50))}</td>
177
+ <td>${item.specSection ? '✅' : '❌'}</td>
178
+ <td>${item.featureScenario ? '✅' : '❌'}</td>
179
+ <td>${item.testName ? '✅' : '❌'}</td>
180
+ <td>${getCoverageIcon(item.coverage)}</td>
181
+ </tr>
182
182
  `;
183
183
  }
184
- html += ` </tbody>
185
- </table>
186
- </body>
184
+ html += ` </tbody>
185
+ </table>
186
+ </body>
187
187
  </html>`;
188
188
  return html;
189
189
  }
@@ -8,37 +8,37 @@ import { generateTraceabilityMatrix, formatMatrixAsMarkdown, formatMatrixAsHtml,
8
8
  vi.mock('fs', () => ({
9
9
  readFileSync: vi.fn((path) => {
10
10
  if (path.includes('test-feature.md')) {
11
- return `# SPEC: test-feature
12
-
13
- ## Task
14
-
15
- ### Phase 1: Setup
16
-
17
- 1. [ ] REQ-test-001: Setup authentication
18
- 2. [ ] REQ-test-002: Create login form
19
- 3. [ ] REQ-test-003: Implement validation
11
+ return `# SPEC: test-feature
12
+
13
+ ## Task
14
+
15
+ ### Phase 1: Setup
16
+
17
+ 1. [ ] REQ-test-001: Setup authentication
18
+ 2. [ ] REQ-test-002: Create login form
19
+ 3. [ ] REQ-test-003: Implement validation
20
20
  `;
21
21
  }
22
22
  if (path.includes('test-feature.feature')) {
23
- return `# Feature: test-feature
24
-
25
- ## Scenarios
26
-
27
- ### Scenario 1: User can login
28
- \`\`\`gherkin
29
- Given user is on login page
30
- When user enters valid credentials
31
- Then user is logged in
32
- \`\`\`
33
- **Verification**: REQ-test-001
34
-
35
- ### Scenario 2: Validation errors
36
- \`\`\`gherkin
37
- Given user is on login page
38
- When user enters invalid email
39
- Then error message is shown
40
- \`\`\`
41
- **Verification**: REQ-test-003
23
+ return `# Feature: test-feature
24
+
25
+ ## Scenarios
26
+
27
+ ### Scenario 1: User can login
28
+ \`\`\`gherkin
29
+ Given user is on login page
30
+ When user enters valid credentials
31
+ Then user is logged in
32
+ \`\`\`
33
+ **Verification**: REQ-test-001
34
+
35
+ ### Scenario 2: Validation errors
36
+ \`\`\`gherkin
37
+ Given user is on login page
38
+ When user enters invalid email
39
+ Then error message is shown
40
+ \`\`\`
41
+ **Verification**: REQ-test-003
42
42
  `;
43
43
  }
44
44
  throw new Error(`File not found: ${path}`);