@su-record/vibe 2.9.18 → 2.9.20

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 (459) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +6 -2
  3. package/LICENSE +21 -21
  4. package/agents/architect-low.md +41 -41
  5. package/agents/architect-medium.md +59 -59
  6. package/agents/architect.md +80 -80
  7. package/agents/build-error-resolver.md +115 -115
  8. package/agents/compounder.md +261 -261
  9. package/agents/diagrammer.md +178 -178
  10. package/agents/docs/api-documenter.md +99 -99
  11. package/agents/docs/changelog-writer.md +93 -93
  12. package/agents/e2e-tester.md +294 -294
  13. package/agents/event/event-comms.md +78 -78
  14. package/agents/event/event-content.md +68 -68
  15. package/agents/event/event-image.md +95 -95
  16. package/agents/event/event-ops.md +84 -84
  17. package/agents/event/event-scheduler.md +69 -69
  18. package/agents/event/event-speaker.md +86 -86
  19. package/agents/explorer-low.md +42 -42
  20. package/agents/explorer-medium.md +59 -59
  21. package/agents/explorer.md +48 -48
  22. package/agents/implementer-low.md +43 -43
  23. package/agents/implementer-medium.md +52 -52
  24. package/agents/implementer.md +54 -54
  25. package/agents/junior-mentor.md +141 -141
  26. package/agents/planning/requirements-analyst.md +84 -84
  27. package/agents/planning/ux-advisor.md +83 -83
  28. package/agents/qa/acceptance-tester.md +86 -86
  29. package/agents/qa/edge-case-finder.md +93 -93
  30. package/agents/qa/qa-coordinator.md +131 -131
  31. package/agents/refactor-cleaner.md +143 -143
  32. package/agents/research/best-practices-agent.md +199 -199
  33. package/agents/research/codebase-patterns-agent.md +157 -157
  34. package/agents/research/framework-docs-agent.md +188 -188
  35. package/agents/research/security-advisory-agent.md +213 -213
  36. package/agents/review/architecture-reviewer.md +107 -107
  37. package/agents/review/complexity-reviewer.md +116 -116
  38. package/agents/review/data-integrity-reviewer.md +88 -88
  39. package/agents/review/git-history-reviewer.md +103 -103
  40. package/agents/review/performance-reviewer.md +86 -86
  41. package/agents/review/python-reviewer.md +150 -150
  42. package/agents/review/rails-reviewer.md +139 -139
  43. package/agents/review/react-reviewer.md +144 -144
  44. package/agents/review/security-reviewer.md +80 -80
  45. package/agents/review/simplicity-reviewer.md +140 -140
  46. package/agents/review/test-coverage-reviewer.md +116 -116
  47. package/agents/review/typescript-reviewer.md +127 -127
  48. package/agents/searcher.md +54 -54
  49. package/agents/simplifier.md +120 -120
  50. package/agents/teams/debug-team.md +70 -70
  51. package/agents/teams/dev-team.md +88 -88
  52. package/agents/teams/docs-team.md +80 -80
  53. package/agents/teams/figma/figma-analyst.md +52 -52
  54. package/agents/teams/figma/figma-architect.md +112 -112
  55. package/agents/teams/figma/figma-auditor.md +82 -82
  56. package/agents/teams/figma/figma-builder.md +100 -100
  57. package/agents/teams/figma-team.md +85 -85
  58. package/agents/teams/fullstack-team.md +83 -83
  59. package/agents/teams/lite-team.md +69 -69
  60. package/agents/teams/migration-team.md +78 -78
  61. package/agents/teams/refactor-team.md +94 -94
  62. package/agents/teams/research-team.md +86 -86
  63. package/agents/teams/review-debate-team.md +125 -125
  64. package/agents/teams/security-team.md +81 -81
  65. package/agents/tester.md +49 -49
  66. package/agents/ui/ui-a11y-auditor.md +93 -93
  67. package/agents/ui/ui-antipattern-detector.md +102 -102
  68. package/agents/ui/ui-dataviz-advisor.md +69 -69
  69. package/agents/ui/ui-design-system-gen.md +57 -57
  70. package/agents/ui/ui-industry-analyzer.md +49 -49
  71. package/agents/ui/ui-layout-architect.md +65 -65
  72. package/agents/ui/ui-stack-implementer.md +68 -68
  73. package/agents/ui/ux-compliance-reviewer.md +81 -81
  74. package/agents/ui-previewer.md +258 -258
  75. package/commands/vibe.analyze.md +533 -533
  76. package/commands/vibe.contract.md +105 -0
  77. package/commands/vibe.docs.md +33 -33
  78. package/commands/vibe.event.md +163 -163
  79. package/commands/vibe.figma.md +584 -584
  80. package/commands/vibe.harness.md +177 -177
  81. package/commands/vibe.regress.md +73 -0
  82. package/commands/vibe.review.md +624 -624
  83. package/commands/vibe.run.md +1940 -1925
  84. package/commands/vibe.scaffold.md +195 -195
  85. package/commands/vibe.spec.md +577 -565
  86. package/commands/vibe.trace.md +276 -276
  87. package/commands/vibe.utils.md +413 -413
  88. package/commands/vibe.verify.md +550 -519
  89. package/dist/cli/collaborator.js +52 -52
  90. package/dist/cli/commands/codex-proxy.js +15 -15
  91. package/dist/cli/commands/config.js +9 -9
  92. package/dist/cli/commands/evolution.js +12 -12
  93. package/dist/cli/commands/figma.js +20 -20
  94. package/dist/cli/commands/info.js +52 -52
  95. package/dist/cli/commands/init.js +5 -5
  96. package/dist/cli/commands/remove.js +14 -14
  97. package/dist/cli/commands/sentinel.js +27 -27
  98. package/dist/cli/commands/skills.js +5 -5
  99. package/dist/cli/commands/slack.js +10 -10
  100. package/dist/cli/commands/stats.js +6 -6
  101. package/dist/cli/commands/telegram.js +12 -12
  102. package/dist/cli/detect.js +32 -32
  103. package/dist/cli/index.js +33 -33
  104. package/dist/cli/llm/claude-commands.js +16 -16
  105. package/dist/cli/llm/config.js +18 -18
  106. package/dist/cli/llm/gemini-commands.js +16 -16
  107. package/dist/cli/llm/gpt-commands.js +19 -19
  108. package/dist/cli/llm/help.js +21 -21
  109. package/dist/cli/postinstall/cursor-agents.js +32 -32
  110. package/dist/cli/postinstall/cursor-rules.js +83 -83
  111. package/dist/cli/postinstall/cursor-skills.js +743 -743
  112. package/dist/cli/setup/GlobalInstaller.d.ts.map +1 -1
  113. package/dist/cli/setup/GlobalInstaller.js +9 -0
  114. package/dist/cli/setup/GlobalInstaller.js.map +1 -1
  115. package/dist/cli/setup/Provisioner.js +42 -42
  116. package/dist/infra/lib/DeepInit.js +24 -24
  117. package/dist/infra/lib/IterationTracker.js +11 -11
  118. package/dist/infra/lib/PythonParser.js +108 -108
  119. package/dist/infra/lib/ReviewRace.js +96 -96
  120. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  121. package/dist/infra/lib/SkillQualityGate.js +9 -9
  122. package/dist/infra/lib/SkillRepository.js +159 -159
  123. package/dist/infra/lib/UltraQA.js +99 -99
  124. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  125. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  126. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  127. package/dist/infra/lib/autonomy/PolicyEngine.d.ts +3 -3
  128. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  129. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  130. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  131. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  132. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  133. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  134. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  135. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  136. package/dist/infra/lib/evolution/ParityTester.js +57 -57
  137. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  138. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  139. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  140. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  141. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  142. package/dist/infra/lib/gemini/orchestration.js +5 -5
  143. package/dist/infra/lib/gpt/orchestration.js +4 -4
  144. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  145. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  146. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  147. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  148. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  149. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  150. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  151. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  152. package/dist/infra/orchestrator/AgentManager.js +12 -12
  153. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  154. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  155. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  156. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  157. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  158. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  159. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  160. package/dist/tools/memory/getMemoryGraph.js +12 -12
  161. package/dist/tools/memory/getSessionContext.js +9 -9
  162. package/dist/tools/memory/linkMemories.js +14 -14
  163. package/dist/tools/memory/listMemories.js +4 -4
  164. package/dist/tools/memory/recallMemory.js +4 -4
  165. package/dist/tools/memory/saveMemory.js +4 -4
  166. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  167. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  168. package/dist/tools/semantic/astGrep.test.js +6 -6
  169. package/dist/tools/spec/prdParser.test.js +171 -171
  170. package/dist/tools/spec/specGenerator.js +169 -169
  171. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  172. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  173. package/hooks/gemini-hooks.json +73 -73
  174. package/hooks/hooks.json +126 -126
  175. package/hooks/scripts/__tests__/keyword-detector.test.js +199 -199
  176. package/hooks/scripts/__tests__/pre-tool-guard.test.js +287 -287
  177. package/hooks/scripts/__tests__/sentinel-guard.test.js +208 -208
  178. package/hooks/scripts/auto-commit.js +97 -97
  179. package/hooks/scripts/auto-format.js +64 -64
  180. package/hooks/scripts/auto-test.js +81 -81
  181. package/hooks/scripts/code-check.js +268 -268
  182. package/hooks/scripts/codex-detect.js +46 -46
  183. package/hooks/scripts/codex-review-gate.js +80 -80
  184. package/hooks/scripts/command-log.js +32 -32
  185. package/hooks/scripts/context-save.js +353 -353
  186. package/hooks/scripts/evolution-engine.js +91 -91
  187. package/hooks/scripts/figma-extract.js +635 -635
  188. package/hooks/scripts/figma-guard.js +219 -219
  189. package/hooks/scripts/figma-refine.js +315 -315
  190. package/hooks/scripts/figma-to-scss.js +394 -394
  191. package/hooks/scripts/figma-validate.js +353 -353
  192. package/hooks/scripts/hud-status.js +321 -321
  193. package/hooks/scripts/keyword-detector.js +214 -214
  194. package/hooks/scripts/llm-orchestrate.js +645 -645
  195. package/hooks/scripts/post-edit.js +32 -32
  196. package/hooks/scripts/pr-test-gate.js +52 -52
  197. package/hooks/scripts/pre-tool-guard.js +213 -213
  198. package/hooks/scripts/prompt-dispatcher.js +190 -190
  199. package/hooks/scripts/sentinel-guard.js +130 -130
  200. package/hooks/scripts/session-start.js +177 -177
  201. package/hooks/scripts/skill-injector.js +83 -83
  202. package/hooks/scripts/stop-notify.js +209 -209
  203. package/hooks/scripts/utils.js +257 -243
  204. package/languages/csharp-unity.md +515 -515
  205. package/languages/gdscript-godot.md +470 -470
  206. package/languages/ruby-rails.md +489 -489
  207. package/languages/typescript-angular.md +433 -433
  208. package/languages/typescript-astro.md +416 -416
  209. package/languages/typescript-electron.md +406 -406
  210. package/languages/typescript-nestjs.md +524 -524
  211. package/languages/typescript-svelte.md +407 -407
  212. package/languages/typescript-tauri.md +365 -365
  213. package/package.json +101 -101
  214. package/skills/agents-md/SKILL.md +121 -121
  215. package/skills/agents-md/rubrics/what-to-keep.md +49 -49
  216. package/skills/agents-md/templates/agents-md.md +36 -36
  217. package/skills/arch-guard/SKILL.md +181 -181
  218. package/skills/arch-guard/agents/detector.md +48 -48
  219. package/skills/arch-guard/agents/reporter.md +48 -48
  220. package/skills/arch-guard/agents/rule-generator.md +49 -49
  221. package/skills/arch-guard/agents/violation-checker.md +51 -51
  222. package/skills/arch-guard/frameworks/clean-architecture.md +108 -108
  223. package/skills/arch-guard/frameworks/solid.md +102 -102
  224. package/skills/arch-guard/scripts/check-boundaries.js +90 -90
  225. package/skills/arch-guard/templates/arch-rules.json +47 -47
  226. package/skills/arch-guard/templates/violation-report.md +53 -53
  227. package/skills/brand-assets/SKILL.md +147 -147
  228. package/skills/brand-assets/rubrics/asset-checklist.md +98 -98
  229. package/skills/brand-assets/templates/brand-guide.md +161 -161
  230. package/skills/capability-loop/SKILL.md +272 -272
  231. package/skills/capability-loop/agents/capability-designer.md +61 -61
  232. package/skills/capability-loop/agents/failure-analyst.md +55 -55
  233. package/skills/capability-loop/agents/implementer.md +50 -50
  234. package/skills/capability-loop/agents/tester.md +53 -53
  235. package/skills/capability-loop/templates/capability-spec.md +118 -118
  236. package/skills/capability-loop/templates/failure-analysis.md +118 -118
  237. package/skills/characterization-test/SKILL.md +207 -207
  238. package/skills/characterization-test/agents/behavior-capturer.md +50 -50
  239. package/skills/characterization-test/agents/coverage-checker.md +54 -54
  240. package/skills/characterization-test/agents/reporter.md +50 -50
  241. package/skills/characterization-test/agents/test-writer.md +49 -49
  242. package/skills/characterization-test/rubrics/coverage-criteria.md +53 -53
  243. package/skills/characterization-test/templates/test-template.ts +101 -101
  244. package/skills/chub-usage/SKILL.md +139 -139
  245. package/skills/claude-md-guide/SKILL.md +351 -351
  246. package/skills/claude-md-guide/rubrics/anti-patterns.md +88 -88
  247. package/skills/claude-md-guide/templates/claude-md.md +54 -54
  248. package/skills/commerce-patterns/SKILL.md +64 -64
  249. package/skills/commerce-patterns/rubrics/checkout-flow.md +48 -48
  250. package/skills/commerce-patterns/templates/product-schema.md +85 -85
  251. package/skills/commit-push-pr/SKILL.md +77 -77
  252. package/skills/commit-push-pr/agents/change-analyzer.md +55 -55
  253. package/skills/commit-push-pr/agents/message-writer.md +50 -50
  254. package/skills/commit-push-pr/agents/pr-writer.md +58 -58
  255. package/skills/commit-push-pr/agents/reviewer.md +52 -52
  256. package/skills/commit-push-pr/rubrics/commit-message.md +73 -73
  257. package/skills/commit-push-pr/templates/pr-body.md +63 -63
  258. package/skills/context7-usage/SKILL.md +106 -106
  259. package/skills/context7-usage/rubrics/when-to-use.md +50 -50
  260. package/skills/create-prd/SKILL.md +90 -90
  261. package/skills/create-prd/agents/edge-case-finder.md +48 -48
  262. package/skills/create-prd/agents/prioritizer.md +60 -60
  263. package/skills/create-prd/agents/requirements-writer.md +48 -48
  264. package/skills/create-prd/agents/researcher.md +55 -55
  265. package/skills/create-prd/agents/reviewer.md +54 -54
  266. package/skills/create-prd/frameworks/jobs-to-be-done.md +96 -96
  267. package/skills/create-prd/frameworks/rice-scoring.md +97 -97
  268. package/skills/create-prd/orchestrator.md +70 -70
  269. package/skills/create-prd/rubrics/completeness.md +58 -58
  270. package/skills/create-prd/templates/prd.md +139 -139
  271. package/skills/design-audit/SKILL.md +152 -152
  272. package/skills/design-audit/agents/a11y-auditor.md +43 -43
  273. package/skills/design-audit/agents/performance-auditor.md +46 -46
  274. package/skills/design-audit/agents/responsive-auditor.md +46 -46
  275. package/skills/design-audit/agents/scorer.md +47 -47
  276. package/skills/design-audit/agents/slop-detector.md +47 -47
  277. package/skills/design-audit/frameworks/core-web-vitals.md +107 -107
  278. package/skills/design-audit/frameworks/wcag-checklist.md +64 -64
  279. package/skills/design-audit/orchestrator.md +64 -64
  280. package/skills/design-audit/rubrics/ai-slop-patterns.md +83 -83
  281. package/skills/design-audit/rubrics/scoring.md +63 -63
  282. package/skills/design-audit/templates/report.md +88 -88
  283. package/skills/design-critique/SKILL.md +139 -139
  284. package/skills/design-critique/rubrics/ux-heuristics.md +143 -143
  285. package/skills/design-critique/templates/critique-report.md +86 -86
  286. package/skills/design-distill/SKILL.md +130 -130
  287. package/skills/design-distill/templates/design-system.md +132 -132
  288. package/skills/design-normalize/SKILL.md +133 -133
  289. package/skills/design-normalize/rubrics/token-naming.md +117 -117
  290. package/skills/design-normalize/templates/token-audit.md +89 -89
  291. package/skills/design-polish/SKILL.md +131 -131
  292. package/skills/design-polish/rubrics/polish-checklist.md +68 -68
  293. package/skills/design-polish/templates/polish-report.md +64 -64
  294. package/skills/design-teach/SKILL.md +182 -182
  295. package/skills/design-teach/rubrics/brand-personality.md +73 -73
  296. package/skills/design-teach/templates/design-context.json +36 -36
  297. package/skills/devlog/SKILL.md +143 -143
  298. package/skills/e2e-commerce/SKILL.md +62 -62
  299. package/skills/e2e-commerce/templates/test-scenarios.md +170 -170
  300. package/skills/event-comms/SKILL.md +172 -172
  301. package/skills/event-comms/templates/email-invite.md +99 -99
  302. package/skills/event-comms/templates/sns-post.md +133 -133
  303. package/skills/event-ops/SKILL.md +207 -207
  304. package/skills/event-ops/rubrics/contingency.md +85 -85
  305. package/skills/event-ops/templates/d-day-checklist.md +65 -65
  306. package/skills/event-planning/SKILL.md +144 -144
  307. package/skills/event-planning/rubrics/timeline.md +70 -70
  308. package/skills/event-planning/templates/event-plan.md +91 -91
  309. package/skills/exec-plan/SKILL.md +149 -149
  310. package/skills/exec-plan/agents/decomposer.md +47 -47
  311. package/skills/exec-plan/agents/dependency-mapper.md +44 -44
  312. package/skills/exec-plan/agents/estimator.md +43 -43
  313. package/skills/exec-plan/agents/validator.md +55 -55
  314. package/skills/exec-plan/orchestrator.md +70 -70
  315. package/skills/exec-plan/rubrics/complexity-scoring.md +75 -75
  316. package/skills/exec-plan/templates/plan.md +147 -147
  317. package/skills/git-worktree/SKILL.md +73 -73
  318. package/skills/git-worktree/rubrics/when-to-use.md +55 -55
  319. package/skills/handoff/SKILL.md +110 -110
  320. package/skills/handoff/agents/context-summarizer.md +51 -51
  321. package/skills/handoff/agents/document-writer.md +63 -63
  322. package/skills/handoff/agents/state-collector.md +53 -53
  323. package/skills/handoff/agents/verifier.md +48 -48
  324. package/skills/handoff/rubrics/completeness.md +62 -62
  325. package/skills/handoff/templates/handoff.md +107 -107
  326. package/skills/parallel-research/SKILL.md +104 -89
  327. package/skills/parallel-research/agents/best-practices.md +43 -43
  328. package/skills/parallel-research/agents/codebase-patterns.md +46 -46
  329. package/skills/parallel-research/agents/framework-docs.md +45 -45
  330. package/skills/parallel-research/agents/security-advisory.md +46 -46
  331. package/skills/parallel-research/agents/synthesizer.md +57 -52
  332. package/skills/parallel-research/experts/best-practices.md +50 -50
  333. package/skills/parallel-research/experts/codebase-patterns.md +70 -70
  334. package/skills/parallel-research/experts/framework-docs.md +65 -65
  335. package/skills/parallel-research/experts/security-advisory.md +69 -69
  336. package/skills/parallel-research/orchestrator.md +79 -65
  337. package/skills/parallel-research/templates/awesome-list.md +32 -0
  338. package/skills/parallel-research/templates/paper.md +88 -0
  339. package/skills/parallel-research/templates/synthesis.md +101 -101
  340. package/skills/prioritization-frameworks/SKILL.md +87 -87
  341. package/skills/prioritization-frameworks/rubrics/frameworks.md +79 -79
  342. package/skills/prioritization-frameworks/templates/scoring-matrix.md +69 -69
  343. package/skills/priority-todos/SKILL.md +64 -64
  344. package/skills/priority-todos/rubrics/prioritization.md +70 -70
  345. package/skills/priority-todos/templates/todo-board.md +59 -59
  346. package/skills/seo-checklist/SKILL.md +58 -58
  347. package/skills/seo-checklist/frameworks/structured-data.md +153 -153
  348. package/skills/seo-checklist/rubrics/content-seo.md +42 -42
  349. package/skills/seo-checklist/rubrics/technical-seo.md +48 -48
  350. package/skills/techdebt/SKILL.md +124 -124
  351. package/skills/techdebt/agents/analyzer.md +50 -50
  352. package/skills/techdebt/agents/fixer.md +41 -41
  353. package/skills/techdebt/agents/reviewer.md +47 -47
  354. package/skills/techdebt/agents/scanner.md +44 -44
  355. package/skills/techdebt/orchestrator.md +70 -70
  356. package/skills/techdebt/rubrics/severity.md +51 -51
  357. package/skills/techdebt/scripts/scan.js +90 -90
  358. package/skills/techdebt/templates/report.md +86 -86
  359. package/skills/tool-fallback/SKILL.md +104 -104
  360. package/skills/tool-fallback/rubrics/fallback-chain.md +58 -58
  361. package/skills/typescript-advanced-types/SKILL.md +67 -67
  362. package/skills/typescript-advanced-types/rubrics/type-patterns.md +109 -109
  363. package/skills/ui-ux-pro-max/SKILL.md +236 -236
  364. package/skills/ui-ux-pro-max/reference/color-and-contrast.md +517 -517
  365. package/skills/ui-ux-pro-max/reference/interaction-design.md +544 -544
  366. package/skills/ui-ux-pro-max/reference/motion-design.md +591 -591
  367. package/skills/ui-ux-pro-max/reference/responsive-design.md +463 -463
  368. package/skills/ui-ux-pro-max/reference/spatial-design.md +390 -390
  369. package/skills/ui-ux-pro-max/reference/typography.md +455 -455
  370. package/skills/ui-ux-pro-max/reference/ux-writing.md +469 -469
  371. package/skills/ui-ux-pro-max/rubrics/interaction-states.md +83 -83
  372. package/skills/ui-ux-pro-max/rubrics/responsive-breakpoints.md +99 -99
  373. package/skills/user-personas/SKILL.md +75 -75
  374. package/skills/user-personas/rubrics/research-methods.md +56 -56
  375. package/skills/user-personas/templates/persona.md +89 -89
  376. package/skills/vercel-react-best-practices/SKILL.md +60 -60
  377. package/skills/vercel-react-best-practices/rubrics/performance.md +82 -82
  378. package/skills/vercel-react-best-practices/rubrics/server-components.md +86 -86
  379. package/skills/vibe-contract/SKILL.md +166 -0
  380. package/skills/vibe-docs/templates/architecture.md +80 -80
  381. package/skills/vibe-docs/templates/readme.md +84 -84
  382. package/skills/vibe-docs/templates/release-notes.md +74 -74
  383. package/skills/vibe-figma/SKILL.md +363 -363
  384. package/skills/vibe-figma/rubrics/extraction-checklist.md +51 -51
  385. package/skills/vibe-figma/templates/component-index.md +126 -126
  386. package/skills/vibe-figma/templates/component-spec.md +168 -168
  387. package/skills/vibe-figma/templates/figma-handoff.md +100 -100
  388. package/skills/vibe-figma/templates/remapped-tree.md +277 -277
  389. package/skills/vibe-figma-convert/SKILL.md +235 -235
  390. package/skills/vibe-figma-convert/rubrics/conversion-rules.md +141 -141
  391. package/skills/vibe-figma-convert/templates/component.md +140 -140
  392. package/skills/vibe-figma-extract/SKILL.md +219 -219
  393. package/skills/vibe-figma-extract/rubrics/image-rules.md +157 -157
  394. package/skills/vibe-interview/SKILL.md +358 -358
  395. package/skills/vibe-interview/checklists/api.md +101 -101
  396. package/skills/vibe-interview/checklists/feature.md +88 -88
  397. package/skills/vibe-interview/checklists/library.md +95 -95
  398. package/skills/vibe-interview/checklists/mobile.md +89 -89
  399. package/skills/vibe-interview/checklists/webapp.md +97 -97
  400. package/skills/vibe-interview/checklists/website.md +99 -99
  401. package/skills/vibe-plan/SKILL.md +254 -254
  402. package/skills/vibe-regress/SKILL.md +174 -0
  403. package/skills/vibe-regress/templates/bug.md +44 -0
  404. package/skills/vibe-regress/templates/test-jest.md +29 -0
  405. package/skills/vibe-regress/templates/test-vitest.md +30 -0
  406. package/skills/vibe-spec/SKILL.md +1195 -1155
  407. package/skills/vibe-spec-review/SKILL.md +726 -726
  408. package/skills/video-production/SKILL.md +52 -52
  409. package/skills/video-production/rubrics/quality-checklist.md +58 -58
  410. package/skills/video-production/templates/production-plan.md +104 -104
  411. package/vibe/config.json +29 -29
  412. package/vibe/constitution.md +227 -227
  413. package/vibe/rules/principles/communication-guide.md +98 -98
  414. package/vibe/rules/principles/development-philosophy.md +52 -52
  415. package/vibe/rules/principles/quick-start.md +102 -102
  416. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  417. package/vibe/rules/quality/checklist.md +276 -276
  418. package/vibe/rules/quality/performance.md +236 -236
  419. package/vibe/rules/quality/testing-strategy.md +440 -440
  420. package/vibe/rules/standards/anti-patterns.md +541 -541
  421. package/vibe/rules/standards/code-structure.md +291 -291
  422. package/vibe/rules/standards/complexity-metrics.md +313 -313
  423. package/vibe/rules/standards/git-workflow.md +237 -237
  424. package/vibe/rules/standards/naming-conventions.md +198 -198
  425. package/vibe/rules/standards/security.md +305 -305
  426. package/vibe/rules/writing/document-style.md +74 -74
  427. package/vibe/setup.sh +31 -31
  428. package/vibe/templates/claudemd-template.md +74 -74
  429. package/vibe/templates/constitution-template.md +267 -267
  430. package/vibe/templates/contract-backend-template.md +526 -526
  431. package/vibe/templates/contract-frontend-template.md +599 -599
  432. package/vibe/templates/feature-template.md +96 -96
  433. package/vibe/templates/plan-template.md +194 -194
  434. package/vibe/templates/spec-template.md +221 -221
  435. package/vibe/ui-ux-data/charts.csv +26 -26
  436. package/vibe/ui-ux-data/colors.csv +97 -97
  437. package/vibe/ui-ux-data/icons.csv +101 -101
  438. package/vibe/ui-ux-data/landing.csv +31 -31
  439. package/vibe/ui-ux-data/products.csv +96 -96
  440. package/vibe/ui-ux-data/react-performance.csv +45 -45
  441. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  442. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  443. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  444. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  445. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  446. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  447. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  448. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  449. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  450. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  451. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  452. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  453. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  454. package/vibe/ui-ux-data/styles.csv +68 -68
  455. package/vibe/ui-ux-data/typography.csv +57 -57
  456. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  457. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  458. package/vibe/ui-ux-data/version.json +31 -31
  459. package/vibe/ui-ux-data/web-interface.csv +31 -31
@@ -0,0 +1,88 @@
1
+ ---
2
+ topic: {{RESEARCH_TOPIC}}
3
+ slug: {{SLUG}}
4
+ date: {{DATE}}
5
+ stack: [{{TECHNOLOGY_STACK_CSV}}]
6
+ question: {{RESEARCH_QUESTION}}
7
+ ---
8
+
9
+ # {{RESEARCH_TOPIC}}: A Structured Survey for Implementation
10
+
11
+ **Date**: {{DATE}}
12
+ **Stack**: {{TECHNOLOGY_STACK}}
13
+ **Research question**: {{RESEARCH_QUESTION}}
14
+
15
+ ---
16
+
17
+ ## Abstract
18
+
19
+ {{ONE_PARAGRAPH_ABSTRACT}}
20
+
21
+ **TL;DR recommendation**: {{RECOMMENDATION}}
22
+
23
+ ## 1. Background
24
+
25
+ {{PROBLEM_CONTEXT — why this matters now, what forced the investigation}}
26
+
27
+ ### 1.1 Prior art in this codebase
28
+
29
+ {{EXISTING_PATTERNS — what's already here, at what file paths}}
30
+
31
+ ### 1.2 Scope
32
+
33
+ - In scope: {{IN_SCOPE}}
34
+ - Out of scope: {{OUT_OF_SCOPE}}
35
+
36
+ ## 2. Method
37
+
38
+ Parallel research across four specialized agents (best-practices, framework-docs, codebase-patterns, security-advisory). Findings weighted by source priority: **security > official docs > codebase consistency > community consensus > blog posts**.
39
+
40
+ ## 3. Findings
41
+
42
+ ### 3.1 Approach A — {{APPROACH_A}}
43
+ - Pro: {{A_PRO}}
44
+ - Con: {{A_CON}}
45
+ - Evidence: {{A_EVIDENCE}}
46
+
47
+ ### 3.2 Approach B — {{APPROACH_B}}
48
+ - Pro: {{B_PRO}}
49
+ - Con: {{B_CON}}
50
+ - Evidence: {{B_EVIDENCE}}
51
+
52
+ ### 3.3 Conflicts and resolutions
53
+
54
+ | Conflict | Position A | Position B | Resolution | Rationale |
55
+ |----------|-----------|-----------|------------|-----------|
56
+ | {{C_1}} | {{A_1}} | {{B_1}} | {{R_1}} | {{WHY_1}} |
57
+
58
+ ## 4. Security considerations
59
+
60
+ | Risk | Severity | Mitigation | Blocker? |
61
+ |------|----------|------------|----------|
62
+ | {{RISK_1}} | {{SEV_1}} | {{MIT_1}} | {{YN}} |
63
+
64
+ ## 5. Recommendation
65
+
66
+ **Primary**: {{PRIMARY_APPROACH}}
67
+ **Acceptable fallback**: {{FALLBACK}}
68
+ **Reject**: {{REJECTED}} — reason: {{REJECT_REASON}}
69
+
70
+ ### 5.1 Implementation starting point
71
+
72
+ {{CONCRETE_FIRST_STEP — file to touch, function to add, snippet}}
73
+
74
+ ## 6. Open questions
75
+
76
+ - [ ] {{OPEN_Q_1}} — resolve before {{PHASE}}
77
+ - [ ] {{OPEN_Q_2}} — can proceed without
78
+
79
+ ## 7. References
80
+
81
+ | # | Source | Agent | Confidence |
82
+ |---|--------|-------|------------|
83
+ | 1 | {{SRC_1}} | {{AGENT_1}} | {{CONF_1}} |
84
+ | 2 | {{SRC_2}} | {{AGENT_2}} | {{CONF_2}} |
85
+
86
+ ---
87
+
88
+ **Reuse**: cite this file by path (`.claude/vibe/research/{{SLUG}}/paper.md`) when writing a SPEC — paste the Findings and Recommendation sections into the SPEC's Context block.
@@ -1,101 +1,101 @@
1
- # Research Synthesis: {{RESEARCH_TOPIC}}
2
-
3
- **Date**: {{DATE}}
4
- **Technology**: {{TECHNOLOGY_STACK}}
5
- **Question**: {{RESEARCH_QUESTION}}
6
-
7
- ---
8
-
9
- ## Executive Summary
10
-
11
- {{ONE_PARAGRAPH_SUMMARY}}
12
-
13
- **Recommended approach**: {{RECOMMENDATION}}
14
-
15
- ---
16
-
17
- ## Findings by Agent
18
-
19
- ### 1. Best Practices
20
-
21
- {{BEST_PRACTICES_SUMMARY}}
22
-
23
- Key insight: {{BEST_PRACTICES_KEY_INSIGHT}}
24
-
25
- ### 2. Framework Documentation
26
-
27
- {{FRAMEWORK_DOCS_SUMMARY}}
28
-
29
- Key constraint: {{FRAMEWORK_CONSTRAINT}}
30
- Relevant API: `{{RELEVANT_API}}`
31
-
32
- ### 3. Codebase Patterns
33
-
34
- {{CODEBASE_PATTERNS_SUMMARY}}
35
-
36
- Follow this existing pattern: `{{PATTERN_FILE}}:{{PATTERN_LINE}}`
37
-
38
- ### 4. Security Advisory
39
-
40
- Risk level: **{{RISK_LEVEL}}**
41
-
42
- {{SECURITY_SUMMARY}}
43
-
44
- Required mitigations: {{REQUIRED_MITIGATIONS_COUNT}}
45
-
46
- ---
47
-
48
- ## Conflicts and Resolutions
49
-
50
- | Conflict | Agent A says | Agent B says | Resolution |
51
- |----------|-------------|-------------|------------|
52
- | {{CONFLICT_1}} | {{A_POSITION}} | {{B_POSITION}} | {{RESOLUTION}} |
53
-
54
- ---
55
-
56
- ## Actionable Recommendations
57
-
58
- ### Must Do (before implementation)
59
- 1. {{MUST_DO_1}}
60
- 2. {{MUST_DO_2}}
61
-
62
- ### Should Do (best practice)
63
- 1. {{SHOULD_DO_1}}
64
- 2. {{SHOULD_DO_2}}
65
-
66
- ### Avoid
67
- 1. {{AVOID_1}} — reason: {{AVOID_REASON_1}}
68
- 2. {{AVOID_2}} — reason: {{AVOID_REASON_2}}
69
-
70
- ---
71
-
72
- ## Impact on SPEC / Implementation Plan
73
-
74
- Add to SPEC Context section:
75
-
76
- ```markdown
77
- ## Context (from parallel research)
78
-
79
- - Best practice: {{SPEC_BEST_PRACTICE_NOTE}}
80
- - Framework constraint: {{SPEC_CONSTRAINT_NOTE}}
81
- - Security requirement: {{SPEC_SECURITY_NOTE}}
82
- - Existing pattern to follow: {{SPEC_PATTERN_NOTE}}
83
- ```
84
-
85
- ---
86
-
87
- ## Unanswered Questions
88
-
89
- - [ ] {{OPEN_QUESTION_1}} — investigate before Phase {{PHASE}}
90
- - [ ] {{OPEN_QUESTION_2}} — can proceed without answer
91
-
92
- ---
93
-
94
- ## Sources
95
-
96
- | Agent | Source | Confidence |
97
- |-------|--------|-----------|
98
- | Best Practices | {{SOURCE_1}} | {{CONFIDENCE_1}} |
99
- | Framework Docs | {{SOURCE_2}} | {{CONFIDENCE_2}} |
100
- | Codebase | `{{SOURCE_3}}` | High |
101
- | Security | {{SOURCE_4}} | {{CONFIDENCE_4}} |
1
+ # Research Synthesis: {{RESEARCH_TOPIC}}
2
+
3
+ **Date**: {{DATE}}
4
+ **Technology**: {{TECHNOLOGY_STACK}}
5
+ **Question**: {{RESEARCH_QUESTION}}
6
+
7
+ ---
8
+
9
+ ## Executive Summary
10
+
11
+ {{ONE_PARAGRAPH_SUMMARY}}
12
+
13
+ **Recommended approach**: {{RECOMMENDATION}}
14
+
15
+ ---
16
+
17
+ ## Findings by Agent
18
+
19
+ ### 1. Best Practices
20
+
21
+ {{BEST_PRACTICES_SUMMARY}}
22
+
23
+ Key insight: {{BEST_PRACTICES_KEY_INSIGHT}}
24
+
25
+ ### 2. Framework Documentation
26
+
27
+ {{FRAMEWORK_DOCS_SUMMARY}}
28
+
29
+ Key constraint: {{FRAMEWORK_CONSTRAINT}}
30
+ Relevant API: `{{RELEVANT_API}}`
31
+
32
+ ### 3. Codebase Patterns
33
+
34
+ {{CODEBASE_PATTERNS_SUMMARY}}
35
+
36
+ Follow this existing pattern: `{{PATTERN_FILE}}:{{PATTERN_LINE}}`
37
+
38
+ ### 4. Security Advisory
39
+
40
+ Risk level: **{{RISK_LEVEL}}**
41
+
42
+ {{SECURITY_SUMMARY}}
43
+
44
+ Required mitigations: {{REQUIRED_MITIGATIONS_COUNT}}
45
+
46
+ ---
47
+
48
+ ## Conflicts and Resolutions
49
+
50
+ | Conflict | Agent A says | Agent B says | Resolution |
51
+ |----------|-------------|-------------|------------|
52
+ | {{CONFLICT_1}} | {{A_POSITION}} | {{B_POSITION}} | {{RESOLUTION}} |
53
+
54
+ ---
55
+
56
+ ## Actionable Recommendations
57
+
58
+ ### Must Do (before implementation)
59
+ 1. {{MUST_DO_1}}
60
+ 2. {{MUST_DO_2}}
61
+
62
+ ### Should Do (best practice)
63
+ 1. {{SHOULD_DO_1}}
64
+ 2. {{SHOULD_DO_2}}
65
+
66
+ ### Avoid
67
+ 1. {{AVOID_1}} — reason: {{AVOID_REASON_1}}
68
+ 2. {{AVOID_2}} — reason: {{AVOID_REASON_2}}
69
+
70
+ ---
71
+
72
+ ## Impact on SPEC / Implementation Plan
73
+
74
+ Add to SPEC Context section:
75
+
76
+ ```markdown
77
+ ## Context (from parallel research)
78
+
79
+ - Best practice: {{SPEC_BEST_PRACTICE_NOTE}}
80
+ - Framework constraint: {{SPEC_CONSTRAINT_NOTE}}
81
+ - Security requirement: {{SPEC_SECURITY_NOTE}}
82
+ - Existing pattern to follow: {{SPEC_PATTERN_NOTE}}
83
+ ```
84
+
85
+ ---
86
+
87
+ ## Unanswered Questions
88
+
89
+ - [ ] {{OPEN_QUESTION_1}} — investigate before Phase {{PHASE}}
90
+ - [ ] {{OPEN_QUESTION_2}} — can proceed without answer
91
+
92
+ ---
93
+
94
+ ## Sources
95
+
96
+ | Agent | Source | Confidence |
97
+ |-------|--------|-----------|
98
+ | Best Practices | {{SOURCE_1}} | {{CONFIDENCE_1}} |
99
+ | Framework Docs | {{SOURCE_2}} | {{CONFIDENCE_2}} |
100
+ | Codebase | `{{SOURCE_3}}` | High |
101
+ | Security | {{SOURCE_4}} | {{CONFIDENCE_4}} |
@@ -1,87 +1,87 @@
1
- ---
2
- name: prioritization-frameworks
3
- tier: standard
4
- description: "Reference guide to 9 prioritization frameworks with formulas, when-to-use guidance, and templates — RICE, ICE, Kano, MoSCoW, Opportunity Score, and more."
5
- triggers: [prioritize, prioritization, rice, ice, kano, moscow, opportunity score]
6
- priority: 50
7
- chain-next: [create-prd]
8
- ---
9
-
10
- # Prioritization Frameworks Reference
11
-
12
- > Based on the Product Frameworks Compendium from [Product Compass](https://www.productcompass.pm/p/the-product-frameworks-compendium) by Pawel Huryn (MIT License).
13
-
14
- A reference guide to help you select and apply the right prioritization framework for your context.
15
-
16
- ## Core Principle
17
-
18
- Never allow customers to design solutions. Prioritize **problems (opportunities)**, not features.
19
-
20
- ## Opportunity Score (Dan Olsen, *The Lean Product Playbook*)
21
-
22
- The recommended framework for prioritizing customer problems.
23
-
24
- Survey customers on **Importance** and **Satisfaction** for each need (normalize to 0-1 scale).
25
-
26
- Three related formulas:
27
- - **Current value** = Importance x Satisfaction
28
- - **Opportunity Score** = Importance x (1 - Satisfaction)
29
- - **Customer value created** = Importance x (S2 - S1), where S1 = satisfaction before, S2 = satisfaction after
30
-
31
- High Importance + low Satisfaction = highest Opportunity Score = best opportunities. Plot on an Importance vs Satisfaction chart — upper-left quadrant is the sweet spot.
32
-
33
- ## ICE Framework
34
-
35
- Useful for prioritizing initiatives and ideas. Considers not only value but also risk and economic factors.
36
-
37
- - **I** (Impact) = Opportunity Score x Number of Customers affected
38
- - **C** (Confidence) = How confident are we? (1-10). Accounts for risk.
39
- - **E** (Ease) = How easy is it to implement? (1-10). Accounts for economic factors.
40
-
41
- **Score** = I x C x E. Higher = prioritize first.
42
-
43
- ## RICE Framework
44
-
45
- Splits ICE's Impact into two separate factors. Useful for larger teams that need more granularity.
46
-
47
- - **R** (Reach) = Number of customers affected
48
- - **I** (Impact) = Opportunity Score (value per customer)
49
- - **C** (Confidence) = How confident are we? (0-100%)
50
- - **E** (Effort) = How much effort to implement? (person-months)
51
-
52
- **Score** = (R x I x C) / E
53
-
54
- ## 9 Frameworks Overview
55
-
56
- | Framework | Best For | Key Insight |
57
- |-----------|----------|-------------|
58
- | Eisenhower Matrix | Personal tasks | Urgent vs Important — for individual PM task management |
59
- | Impact vs Effort | Tasks/initiatives | Simple 2x2 — quick triage, not rigorous for strategic decisions |
60
- | Risk vs Reward | Initiatives | Like Impact vs Effort but accounts for uncertainty |
61
- | **Opportunity Score** | Customer problems | **Recommended.** Importance x (1 - Satisfaction). Normalize to 0-1. |
62
- | Kano Model | Understanding expectations | Must-be, Performance, Attractive, Indifferent, Reverse. For understanding, not prioritizing. |
63
- | Weighted Decision Matrix | Multi-factor decisions | Assign weights to criteria, score each option. Useful for stakeholder buy-in. |
64
- | **ICE** | Ideas/initiatives | Impact x Confidence x Ease. Recommended for quick prioritization. |
65
- | **RICE** | Ideas at scale | (Reach x Impact x Confidence) / Effort. Adds Reach to ICE. |
66
- | MoSCoW | Requirements | Must/Should/Could/Won't. Caution: project management origin. |
67
-
68
- ## How to Choose
69
-
70
- 1. **Prioritizing customer problems?** → Opportunity Score
71
- 2. **Quick initiative ranking?** → ICE
72
- 3. **Large team with data?** → RICE
73
- 4. **Understanding user expectations?** → Kano Model
74
- 5. **Stakeholder alignment needed?** → Weighted Decision Matrix
75
- 6. **Requirements scoping?** → MoSCoW (with caution)
76
-
77
- ## Templates
78
-
79
- - [Opportunity Score intro (PDF)](https://drive.google.com/file/d/1ENbYPmk1i1AKO7UnfyTuULL5GucTVufW/view)
80
- - [Importance vs Satisfaction Template (Google Slides)](https://docs.google.com/presentation/d/1jg-LuF_3QHsf6f1nE1f98i4C0aulnRNMOO1jftgti8M/edit#slide=id.g796641d975_0_3)
81
- - [ICE Template (Google Sheets)](https://docs.google.com/spreadsheets/d/1LUfnsPolhZgm7X2oij-7EUe0CJT-Dwr-/edit?usp=share_link)
82
- - [RICE Template (Google Sheets)](https://docs.google.com/spreadsheets/d/1S-6QpyOz5MCrV7B67LUWdZkAzn38Eahv/edit?usp=sharing)
83
-
84
- ## Further Reading
85
-
86
- - [The Product Management Frameworks Compendium + Templates](https://www.productcompass.pm/p/the-product-frameworks-compendium)
87
- - [Kano Model: How to Delight Your Customers Without Becoming a Feature Factory](https://www.productcompass.pm/p/kano-model-how-to-delight-your-customers)
1
+ ---
2
+ name: prioritization-frameworks
3
+ tier: standard
4
+ description: "Reference guide to 9 prioritization frameworks with formulas, when-to-use guidance, and templates — RICE, ICE, Kano, MoSCoW, Opportunity Score, and more."
5
+ triggers: [prioritize, prioritization, rice, ice, kano, moscow, opportunity score]
6
+ priority: 50
7
+ chain-next: [create-prd]
8
+ ---
9
+
10
+ # Prioritization Frameworks Reference
11
+
12
+ > Based on the Product Frameworks Compendium from [Product Compass](https://www.productcompass.pm/p/the-product-frameworks-compendium) by Pawel Huryn (MIT License).
13
+
14
+ A reference guide to help you select and apply the right prioritization framework for your context.
15
+
16
+ ## Core Principle
17
+
18
+ Never allow customers to design solutions. Prioritize **problems (opportunities)**, not features.
19
+
20
+ ## Opportunity Score (Dan Olsen, *The Lean Product Playbook*)
21
+
22
+ The recommended framework for prioritizing customer problems.
23
+
24
+ Survey customers on **Importance** and **Satisfaction** for each need (normalize to 0-1 scale).
25
+
26
+ Three related formulas:
27
+ - **Current value** = Importance x Satisfaction
28
+ - **Opportunity Score** = Importance x (1 - Satisfaction)
29
+ - **Customer value created** = Importance x (S2 - S1), where S1 = satisfaction before, S2 = satisfaction after
30
+
31
+ High Importance + low Satisfaction = highest Opportunity Score = best opportunities. Plot on an Importance vs Satisfaction chart — upper-left quadrant is the sweet spot.
32
+
33
+ ## ICE Framework
34
+
35
+ Useful for prioritizing initiatives and ideas. Considers not only value but also risk and economic factors.
36
+
37
+ - **I** (Impact) = Opportunity Score x Number of Customers affected
38
+ - **C** (Confidence) = How confident are we? (1-10). Accounts for risk.
39
+ - **E** (Ease) = How easy is it to implement? (1-10). Accounts for economic factors.
40
+
41
+ **Score** = I x C x E. Higher = prioritize first.
42
+
43
+ ## RICE Framework
44
+
45
+ Splits ICE's Impact into two separate factors. Useful for larger teams that need more granularity.
46
+
47
+ - **R** (Reach) = Number of customers affected
48
+ - **I** (Impact) = Opportunity Score (value per customer)
49
+ - **C** (Confidence) = How confident are we? (0-100%)
50
+ - **E** (Effort) = How much effort to implement? (person-months)
51
+
52
+ **Score** = (R x I x C) / E
53
+
54
+ ## 9 Frameworks Overview
55
+
56
+ | Framework | Best For | Key Insight |
57
+ |-----------|----------|-------------|
58
+ | Eisenhower Matrix | Personal tasks | Urgent vs Important — for individual PM task management |
59
+ | Impact vs Effort | Tasks/initiatives | Simple 2x2 — quick triage, not rigorous for strategic decisions |
60
+ | Risk vs Reward | Initiatives | Like Impact vs Effort but accounts for uncertainty |
61
+ | **Opportunity Score** | Customer problems | **Recommended.** Importance x (1 - Satisfaction). Normalize to 0-1. |
62
+ | Kano Model | Understanding expectations | Must-be, Performance, Attractive, Indifferent, Reverse. For understanding, not prioritizing. |
63
+ | Weighted Decision Matrix | Multi-factor decisions | Assign weights to criteria, score each option. Useful for stakeholder buy-in. |
64
+ | **ICE** | Ideas/initiatives | Impact x Confidence x Ease. Recommended for quick prioritization. |
65
+ | **RICE** | Ideas at scale | (Reach x Impact x Confidence) / Effort. Adds Reach to ICE. |
66
+ | MoSCoW | Requirements | Must/Should/Could/Won't. Caution: project management origin. |
67
+
68
+ ## How to Choose
69
+
70
+ 1. **Prioritizing customer problems?** → Opportunity Score
71
+ 2. **Quick initiative ranking?** → ICE
72
+ 3. **Large team with data?** → RICE
73
+ 4. **Understanding user expectations?** → Kano Model
74
+ 5. **Stakeholder alignment needed?** → Weighted Decision Matrix
75
+ 6. **Requirements scoping?** → MoSCoW (with caution)
76
+
77
+ ## Templates
78
+
79
+ - [Opportunity Score intro (PDF)](https://drive.google.com/file/d/1ENbYPmk1i1AKO7UnfyTuULL5GucTVufW/view)
80
+ - [Importance vs Satisfaction Template (Google Slides)](https://docs.google.com/presentation/d/1jg-LuF_3QHsf6f1nE1f98i4C0aulnRNMOO1jftgti8M/edit#slide=id.g796641d975_0_3)
81
+ - [ICE Template (Google Sheets)](https://docs.google.com/spreadsheets/d/1LUfnsPolhZgm7X2oij-7EUe0CJT-Dwr-/edit?usp=share_link)
82
+ - [RICE Template (Google Sheets)](https://docs.google.com/spreadsheets/d/1S-6QpyOz5MCrV7B67LUWdZkAzn38Eahv/edit?usp=sharing)
83
+
84
+ ## Further Reading
85
+
86
+ - [The Product Management Frameworks Compendium + Templates](https://www.productcompass.pm/p/the-product-frameworks-compendium)
87
+ - [Kano Model: How to Delight Your Customers Without Becoming a Feature Factory](https://www.productcompass.pm/p/kano-model-how-to-delight-your-customers)
@@ -1,79 +1,79 @@
1
- # Prioritization Frameworks Rubric
2
-
3
- ## RICE
4
-
5
- **Formula**: `(Reach × Impact × Confidence) / Effort`
6
-
7
- | Factor | Scale | Example |
8
- |--------|-------|---------|
9
- | Reach | Users/month (absolute) | 5,000 users |
10
- | Impact | Opportunity Score 0.0–1.0 | 0.7 |
11
- | Confidence | 0–100% | 80% = 0.8 |
12
- | Effort | Person-months | 2 |
13
-
14
- **Example**: `(5000 × 0.7 × 0.8) / 2 = 1400` — higher score = prioritize first.
15
-
16
- **When to use**: Large teams with data. Separates audience size (Reach) from value per user (Impact).
17
-
18
- **Watch out for**: Effort estimates are often optimistic — apply a 1.5x buffer.
19
-
20
- ---
21
-
22
- ## ICE
23
-
24
- **Formula**: `Impact × Confidence × Ease`
25
-
26
- | Factor | Scale | Example |
27
- |--------|-------|---------|
28
- | Impact | 1–10 (or Opportunity Score × Users) | 8 |
29
- | Confidence | 1–10 | 7 |
30
- | Ease | 1–10 (inverse of effort) | 5 |
31
-
32
- **Example**: `8 × 7 × 5 = 280` — higher score = prioritize first.
33
-
34
- **When to use**: Quick ranking of ideas/initiatives. Faster than RICE, good for early-stage decisions.
35
-
36
- **Watch out for**: "Ease" is subjective — calibrate across team before scoring.
37
-
38
- ---
39
-
40
- ## MoSCoW
41
-
42
- **Categories**:
43
-
44
- | Category | Meaning | Guideline |
45
- |----------|---------|-----------|
46
- | **Must** | Cannot launch without | Max 60% of scope |
47
- | **Should** | High value, not critical | Next priority after Must |
48
- | **Could** | Nice to have | Include only if capacity allows |
49
- | **Won't** | Explicitly deferred | Documents what is NOT in scope |
50
-
51
- **When to use**: Scoping a release. Good for stakeholder alignment conversations.
52
-
53
- **Watch out for**: Stakeholders inflate "Must" — challenge each Must with "What happens if we skip this for V1?". MoSCoW is a scoping tool, not a discovery tool.
54
-
55
- ---
56
-
57
- ## Opportunity Score
58
-
59
- **Formula**: `Importance × (1 − Satisfaction)` (normalize both to 0–1 scale)
60
-
61
- **Example**:
62
- - Importance: 0.9, Satisfaction: 0.3 → Score: `0.9 × 0.7 = 0.63` (high opportunity)
63
- - Importance: 0.9, Satisfaction: 0.9 → Score: `0.9 × 0.1 = 0.09` (already solved)
64
-
65
- **When to use**: Prioritizing customer problems before deciding on solutions. Prevents building features customers already find satisfactory.
66
-
67
- **Watch out for**: Survey sample must be representative. Low sample size inflates confidence.
68
-
69
- ---
70
-
71
- ## Choosing the Right Framework
72
-
73
- | Situation | Recommended Framework |
74
- |-----------|----------------------|
75
- | "Which customer problems matter most?" | Opportunity Score |
76
- | "Which features should we build this sprint?" | ICE |
77
- | "How do we rank initiatives across a large team?" | RICE |
78
- | "What goes into V1 vs. later?" | MoSCoW |
79
- | "Stakeholders disagree on priorities?" | Weighted Decision Matrix |
1
+ # Prioritization Frameworks Rubric
2
+
3
+ ## RICE
4
+
5
+ **Formula**: `(Reach × Impact × Confidence) / Effort`
6
+
7
+ | Factor | Scale | Example |
8
+ |--------|-------|---------|
9
+ | Reach | Users/month (absolute) | 5,000 users |
10
+ | Impact | Opportunity Score 0.0–1.0 | 0.7 |
11
+ | Confidence | 0–100% | 80% = 0.8 |
12
+ | Effort | Person-months | 2 |
13
+
14
+ **Example**: `(5000 × 0.7 × 0.8) / 2 = 1400` — higher score = prioritize first.
15
+
16
+ **When to use**: Large teams with data. Separates audience size (Reach) from value per user (Impact).
17
+
18
+ **Watch out for**: Effort estimates are often optimistic — apply a 1.5x buffer.
19
+
20
+ ---
21
+
22
+ ## ICE
23
+
24
+ **Formula**: `Impact × Confidence × Ease`
25
+
26
+ | Factor | Scale | Example |
27
+ |--------|-------|---------|
28
+ | Impact | 1–10 (or Opportunity Score × Users) | 8 |
29
+ | Confidence | 1–10 | 7 |
30
+ | Ease | 1–10 (inverse of effort) | 5 |
31
+
32
+ **Example**: `8 × 7 × 5 = 280` — higher score = prioritize first.
33
+
34
+ **When to use**: Quick ranking of ideas/initiatives. Faster than RICE, good for early-stage decisions.
35
+
36
+ **Watch out for**: "Ease" is subjective — calibrate across team before scoring.
37
+
38
+ ---
39
+
40
+ ## MoSCoW
41
+
42
+ **Categories**:
43
+
44
+ | Category | Meaning | Guideline |
45
+ |----------|---------|-----------|
46
+ | **Must** | Cannot launch without | Max 60% of scope |
47
+ | **Should** | High value, not critical | Next priority after Must |
48
+ | **Could** | Nice to have | Include only if capacity allows |
49
+ | **Won't** | Explicitly deferred | Documents what is NOT in scope |
50
+
51
+ **When to use**: Scoping a release. Good for stakeholder alignment conversations.
52
+
53
+ **Watch out for**: Stakeholders inflate "Must" — challenge each Must with "What happens if we skip this for V1?". MoSCoW is a scoping tool, not a discovery tool.
54
+
55
+ ---
56
+
57
+ ## Opportunity Score
58
+
59
+ **Formula**: `Importance × (1 − Satisfaction)` (normalize both to 0–1 scale)
60
+
61
+ **Example**:
62
+ - Importance: 0.9, Satisfaction: 0.3 → Score: `0.9 × 0.7 = 0.63` (high opportunity)
63
+ - Importance: 0.9, Satisfaction: 0.9 → Score: `0.9 × 0.1 = 0.09` (already solved)
64
+
65
+ **When to use**: Prioritizing customer problems before deciding on solutions. Prevents building features customers already find satisfactory.
66
+
67
+ **Watch out for**: Survey sample must be representative. Low sample size inflates confidence.
68
+
69
+ ---
70
+
71
+ ## Choosing the Right Framework
72
+
73
+ | Situation | Recommended Framework |
74
+ |-----------|----------------------|
75
+ | "Which customer problems matter most?" | Opportunity Score |
76
+ | "Which features should we build this sprint?" | ICE |
77
+ | "How do we rank initiatives across a large team?" | RICE |
78
+ | "What goes into V1 vs. later?" | MoSCoW |
79
+ | "Stakeholders disagree on priorities?" | Weighted Decision Matrix |