@su-record/vibe 2.8.51 → 2.8.53

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 (428) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +169 -169
  3. package/LICENSE +21 -21
  4. package/README.ko.md +5 -5
  5. package/README.md +5 -5
  6. package/agents/architect-low.md +41 -41
  7. package/agents/architect-medium.md +59 -59
  8. package/agents/architect.md +80 -80
  9. package/agents/build-error-resolver.md +115 -115
  10. package/agents/compounder.md +261 -261
  11. package/agents/diagrammer.md +178 -178
  12. package/agents/docs/api-documenter.md +99 -99
  13. package/agents/docs/changelog-writer.md +93 -93
  14. package/agents/e2e-tester.md +294 -294
  15. package/agents/event/event-comms.md +78 -78
  16. package/agents/event/event-content.md +68 -68
  17. package/agents/event/event-image.md +95 -95
  18. package/agents/event/event-ops.md +84 -84
  19. package/agents/event/event-scheduler.md +69 -69
  20. package/agents/event/event-speaker.md +86 -86
  21. package/agents/explorer-low.md +42 -42
  22. package/agents/explorer-medium.md +59 -59
  23. package/agents/explorer.md +48 -48
  24. package/agents/implementer-low.md +43 -43
  25. package/agents/implementer-medium.md +52 -52
  26. package/agents/implementer.md +54 -54
  27. package/agents/junior-mentor.md +141 -141
  28. package/agents/planning/requirements-analyst.md +84 -84
  29. package/agents/planning/ux-advisor.md +83 -83
  30. package/agents/qa/acceptance-tester.md +86 -86
  31. package/agents/qa/edge-case-finder.md +93 -93
  32. package/agents/qa/qa-coordinator.md +131 -131
  33. package/agents/refactor-cleaner.md +143 -143
  34. package/agents/research/best-practices-agent.md +199 -199
  35. package/agents/research/codebase-patterns-agent.md +157 -157
  36. package/agents/research/framework-docs-agent.md +188 -188
  37. package/agents/research/security-advisory-agent.md +213 -213
  38. package/agents/review/architecture-reviewer.md +107 -107
  39. package/agents/review/complexity-reviewer.md +116 -116
  40. package/agents/review/data-integrity-reviewer.md +88 -88
  41. package/agents/review/git-history-reviewer.md +103 -103
  42. package/agents/review/performance-reviewer.md +86 -86
  43. package/agents/review/python-reviewer.md +150 -150
  44. package/agents/review/rails-reviewer.md +139 -139
  45. package/agents/review/react-reviewer.md +144 -144
  46. package/agents/review/security-reviewer.md +80 -80
  47. package/agents/review/simplicity-reviewer.md +140 -140
  48. package/agents/review/test-coverage-reviewer.md +116 -116
  49. package/agents/review/typescript-reviewer.md +127 -127
  50. package/agents/searcher.md +54 -54
  51. package/agents/simplifier.md +120 -120
  52. package/agents/tester.md +49 -49
  53. package/agents/ui/ui-a11y-auditor.md +93 -93
  54. package/agents/ui/ui-antipattern-detector.md +102 -102
  55. package/agents/ui/ui-dataviz-advisor.md +69 -69
  56. package/agents/ui/ui-design-system-gen.md +57 -57
  57. package/agents/ui/ui-industry-analyzer.md +49 -49
  58. package/agents/ui/ui-layout-architect.md +65 -65
  59. package/agents/ui/ui-stack-implementer.md +68 -68
  60. package/agents/ui/ux-compliance-reviewer.md +81 -81
  61. package/agents/ui-previewer.md +258 -258
  62. package/commands/vibe.analyze.md +379 -379
  63. package/commands/vibe.docs.md +32 -32
  64. package/commands/vibe.event.md +163 -163
  65. package/commands/vibe.figma.md +69 -69
  66. package/commands/vibe.review.md +686 -686
  67. package/commands/vibe.run.md +2276 -2276
  68. package/commands/vibe.spec.md +1195 -1195
  69. package/commands/vibe.spec.review.md +609 -609
  70. package/commands/vibe.trace.md +259 -259
  71. package/commands/vibe.utils.md +413 -413
  72. package/commands/vibe.verify.md +510 -510
  73. package/dist/cli/collaborator.js +52 -52
  74. package/dist/cli/commands/config.js +9 -9
  75. package/dist/cli/commands/evolution.js +12 -12
  76. package/dist/cli/commands/figma.js +20 -20
  77. package/dist/cli/commands/info.js +53 -53
  78. package/dist/cli/commands/init.d.ts.map +1 -1
  79. package/dist/cli/commands/init.js +82 -15
  80. package/dist/cli/commands/init.js.map +1 -1
  81. package/dist/cli/commands/remove.js +14 -14
  82. package/dist/cli/commands/sentinel.js +27 -27
  83. package/dist/cli/commands/skills.js +5 -5
  84. package/dist/cli/commands/slack.js +10 -10
  85. package/dist/cli/commands/stats.js +6 -6
  86. package/dist/cli/commands/telegram.js +12 -12
  87. package/dist/cli/detect.js +32 -32
  88. package/dist/cli/index.js +51 -51
  89. package/dist/cli/llm/claude-commands.js +16 -16
  90. package/dist/cli/llm/config.js +18 -18
  91. package/dist/cli/llm/gemini-commands.js +16 -16
  92. package/dist/cli/llm/gpt-commands.js +19 -19
  93. package/dist/cli/llm/help.js +21 -21
  94. package/dist/cli/postinstall/constants.d.ts.map +1 -1
  95. package/dist/cli/postinstall/constants.js +2 -0
  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/setup/Provisioner.js +42 -42
  101. package/dist/cli/types.d.ts +12 -0
  102. package/dist/cli/types.d.ts.map +1 -1
  103. package/dist/infra/lib/DeepInit.js +24 -24
  104. package/dist/infra/lib/IterationTracker.js +11 -11
  105. package/dist/infra/lib/PythonParser.js +108 -108
  106. package/dist/infra/lib/ReviewRace.js +96 -96
  107. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  108. package/dist/infra/lib/SkillQualityGate.js +9 -9
  109. package/dist/infra/lib/SkillRepository.js +159 -159
  110. package/dist/infra/lib/TokenBudgetTracker.d.ts +13 -0
  111. package/dist/infra/lib/TokenBudgetTracker.d.ts.map +1 -1
  112. package/dist/infra/lib/TokenBudgetTracker.js +44 -3
  113. package/dist/infra/lib/TokenBudgetTracker.js.map +1 -1
  114. package/dist/infra/lib/UltraQA.js +99 -99
  115. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  116. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  117. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  118. package/dist/infra/lib/autonomy/PolicyEngine.d.ts +3 -3
  119. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  120. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  121. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  122. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  123. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  124. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  125. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  126. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  127. package/dist/infra/lib/evolution/ParityTester.js +57 -57
  128. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  129. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  130. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  131. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  132. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  133. package/dist/infra/lib/gemini/orchestration.js +5 -5
  134. package/dist/infra/lib/gpt/orchestration.js +4 -4
  135. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  136. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  137. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  138. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  139. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  140. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  141. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  142. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  143. package/dist/infra/orchestrator/AgentManager.js +12 -12
  144. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  145. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  146. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  147. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  148. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  149. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  150. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  151. package/dist/tools/memory/getMemoryGraph.js +12 -12
  152. package/dist/tools/memory/getSessionContext.js +9 -9
  153. package/dist/tools/memory/linkMemories.js +14 -14
  154. package/dist/tools/memory/listMemories.js +4 -4
  155. package/dist/tools/memory/recallMemory.js +4 -4
  156. package/dist/tools/memory/saveMemory.js +4 -4
  157. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  158. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  159. package/dist/tools/semantic/astGrep.test.js +6 -6
  160. package/dist/tools/spec/prdParser.test.js +171 -171
  161. package/dist/tools/spec/specGenerator.js +169 -169
  162. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  163. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  164. package/hooks/gemini-hooks.json +73 -73
  165. package/hooks/hooks.json +174 -170
  166. package/hooks/scripts/__tests__/keyword-detector.test.js +199 -199
  167. package/hooks/scripts/__tests__/pre-tool-guard.test.js +286 -286
  168. package/hooks/scripts/__tests__/sentinel-guard.test.js +210 -210
  169. package/hooks/scripts/auto-commit.js +97 -97
  170. package/hooks/scripts/auto-format.js +64 -64
  171. package/hooks/scripts/auto-test.js +81 -81
  172. package/hooks/scripts/code-check.js +268 -268
  173. package/hooks/scripts/codex-detect.js +46 -46
  174. package/hooks/scripts/codex-review-gate.js +80 -80
  175. package/hooks/scripts/command-log.js +32 -32
  176. package/hooks/scripts/context-save.js +353 -353
  177. package/hooks/scripts/devlog-gen.js +230 -0
  178. package/hooks/scripts/evolution-engine.js +91 -91
  179. package/hooks/scripts/figma-extract.js +635 -477
  180. package/hooks/scripts/hud-status.js +321 -321
  181. package/hooks/scripts/keyword-detector.js +214 -214
  182. package/hooks/scripts/llm-orchestrate.js +572 -572
  183. package/hooks/scripts/post-edit.js +32 -32
  184. package/hooks/scripts/pr-test-gate.js +52 -52
  185. package/hooks/scripts/pre-tool-guard.js +214 -159
  186. package/hooks/scripts/prompt-dispatcher.js +185 -185
  187. package/hooks/scripts/sentinel-guard.js +131 -131
  188. package/hooks/scripts/session-start.js +177 -177
  189. package/hooks/scripts/skill-injector.js +83 -83
  190. package/hooks/scripts/stop-notify.js +209 -209
  191. package/hooks/scripts/utils.js +243 -243
  192. package/languages/csharp-unity.md +515 -515
  193. package/languages/gdscript-godot.md +470 -470
  194. package/languages/ruby-rails.md +489 -489
  195. package/languages/typescript-angular.md +433 -433
  196. package/languages/typescript-astro.md +416 -416
  197. package/languages/typescript-electron.md +406 -406
  198. package/languages/typescript-nestjs.md +524 -524
  199. package/languages/typescript-svelte.md +407 -407
  200. package/languages/typescript-tauri.md +365 -365
  201. package/package.json +101 -101
  202. package/skills/agents-md/SKILL.md +121 -121
  203. package/skills/agents-md/rubrics/what-to-keep.md +49 -49
  204. package/skills/agents-md/templates/agents-md.md +36 -36
  205. package/skills/arch-guard/SKILL.md +181 -181
  206. package/skills/arch-guard/agents/detector.md +48 -48
  207. package/skills/arch-guard/agents/reporter.md +48 -48
  208. package/skills/arch-guard/agents/rule-generator.md +49 -49
  209. package/skills/arch-guard/agents/violation-checker.md +51 -51
  210. package/skills/arch-guard/frameworks/clean-architecture.md +108 -108
  211. package/skills/arch-guard/frameworks/solid.md +102 -102
  212. package/skills/arch-guard/scripts/check-boundaries.js +90 -90
  213. package/skills/arch-guard/templates/arch-rules.json +47 -47
  214. package/skills/arch-guard/templates/violation-report.md +53 -53
  215. package/skills/brand-assets/SKILL.md +147 -147
  216. package/skills/brand-assets/rubrics/asset-checklist.md +98 -98
  217. package/skills/brand-assets/templates/brand-guide.md +161 -161
  218. package/skills/capability-loop/SKILL.md +168 -168
  219. package/skills/capability-loop/agents/capability-designer.md +61 -61
  220. package/skills/capability-loop/agents/failure-analyst.md +55 -55
  221. package/skills/capability-loop/agents/implementer.md +50 -50
  222. package/skills/capability-loop/agents/tester.md +53 -53
  223. package/skills/capability-loop/templates/capability-spec.md +118 -118
  224. package/skills/capability-loop/templates/failure-analysis.md +118 -118
  225. package/skills/characterization-test/SKILL.md +207 -207
  226. package/skills/characterization-test/agents/behavior-capturer.md +50 -50
  227. package/skills/characterization-test/agents/coverage-checker.md +54 -54
  228. package/skills/characterization-test/agents/reporter.md +50 -50
  229. package/skills/characterization-test/agents/test-writer.md +49 -49
  230. package/skills/characterization-test/rubrics/coverage-criteria.md +53 -53
  231. package/skills/characterization-test/templates/test-template.ts +101 -101
  232. package/skills/chub-usage/SKILL.md +139 -139
  233. package/skills/claude-md-guide/SKILL.md +351 -351
  234. package/skills/claude-md-guide/rubrics/anti-patterns.md +88 -88
  235. package/skills/claude-md-guide/templates/claude-md.md +54 -54
  236. package/skills/commerce-patterns/SKILL.md +64 -64
  237. package/skills/commerce-patterns/rubrics/checkout-flow.md +48 -48
  238. package/skills/commerce-patterns/templates/product-schema.md +85 -85
  239. package/skills/commit-push-pr/SKILL.md +77 -77
  240. package/skills/commit-push-pr/agents/change-analyzer.md +55 -55
  241. package/skills/commit-push-pr/agents/message-writer.md +50 -50
  242. package/skills/commit-push-pr/agents/pr-writer.md +58 -58
  243. package/skills/commit-push-pr/agents/reviewer.md +52 -52
  244. package/skills/commit-push-pr/rubrics/commit-message.md +73 -73
  245. package/skills/commit-push-pr/templates/pr-body.md +63 -63
  246. package/skills/context7-usage/SKILL.md +106 -106
  247. package/skills/context7-usage/rubrics/when-to-use.md +50 -50
  248. package/skills/create-prd/SKILL.md +90 -90
  249. package/skills/create-prd/agents/edge-case-finder.md +48 -48
  250. package/skills/create-prd/agents/prioritizer.md +60 -60
  251. package/skills/create-prd/agents/requirements-writer.md +48 -48
  252. package/skills/create-prd/agents/researcher.md +55 -55
  253. package/skills/create-prd/agents/reviewer.md +54 -54
  254. package/skills/create-prd/frameworks/jobs-to-be-done.md +96 -96
  255. package/skills/create-prd/frameworks/rice-scoring.md +97 -97
  256. package/skills/create-prd/orchestrator.md +70 -70
  257. package/skills/create-prd/rubrics/completeness.md +58 -58
  258. package/skills/create-prd/templates/prd.md +139 -139
  259. package/skills/design-audit/SKILL.md +152 -152
  260. package/skills/design-audit/agents/a11y-auditor.md +43 -43
  261. package/skills/design-audit/agents/performance-auditor.md +46 -46
  262. package/skills/design-audit/agents/responsive-auditor.md +46 -46
  263. package/skills/design-audit/agents/scorer.md +47 -47
  264. package/skills/design-audit/agents/slop-detector.md +47 -47
  265. package/skills/design-audit/frameworks/core-web-vitals.md +107 -107
  266. package/skills/design-audit/frameworks/wcag-checklist.md +64 -64
  267. package/skills/design-audit/orchestrator.md +64 -64
  268. package/skills/design-audit/rubrics/ai-slop-patterns.md +83 -83
  269. package/skills/design-audit/rubrics/scoring.md +63 -63
  270. package/skills/design-audit/templates/report.md +88 -88
  271. package/skills/design-critique/SKILL.md +139 -139
  272. package/skills/design-critique/rubrics/ux-heuristics.md +143 -143
  273. package/skills/design-critique/templates/critique-report.md +86 -86
  274. package/skills/design-distill/SKILL.md +130 -130
  275. package/skills/design-distill/templates/design-system.md +132 -132
  276. package/skills/design-normalize/SKILL.md +133 -133
  277. package/skills/design-normalize/rubrics/token-naming.md +117 -117
  278. package/skills/design-normalize/templates/token-audit.md +89 -89
  279. package/skills/design-polish/SKILL.md +131 -131
  280. package/skills/design-polish/rubrics/polish-checklist.md +68 -68
  281. package/skills/design-polish/templates/polish-report.md +64 -64
  282. package/skills/design-teach/SKILL.md +182 -182
  283. package/skills/design-teach/rubrics/brand-personality.md +73 -73
  284. package/skills/design-teach/templates/design-context.json +36 -36
  285. package/skills/devlog/SKILL.md +143 -0
  286. package/skills/e2e-commerce/SKILL.md +62 -62
  287. package/skills/e2e-commerce/templates/test-scenarios.md +170 -170
  288. package/skills/event-comms/SKILL.md +162 -162
  289. package/skills/event-comms/templates/email-invite.md +99 -99
  290. package/skills/event-comms/templates/sns-post.md +133 -133
  291. package/skills/event-ops/SKILL.md +198 -198
  292. package/skills/event-ops/rubrics/contingency.md +85 -85
  293. package/skills/event-ops/templates/d-day-checklist.md +65 -65
  294. package/skills/event-planning/SKILL.md +132 -132
  295. package/skills/event-planning/rubrics/timeline.md +70 -70
  296. package/skills/event-planning/templates/event-plan.md +91 -91
  297. package/skills/exec-plan/SKILL.md +149 -149
  298. package/skills/exec-plan/agents/decomposer.md +47 -47
  299. package/skills/exec-plan/agents/dependency-mapper.md +44 -44
  300. package/skills/exec-plan/agents/estimator.md +43 -43
  301. package/skills/exec-plan/agents/validator.md +55 -55
  302. package/skills/exec-plan/orchestrator.md +70 -70
  303. package/skills/exec-plan/rubrics/complexity-scoring.md +75 -75
  304. package/skills/exec-plan/templates/plan.md +147 -147
  305. package/skills/git-worktree/SKILL.md +73 -73
  306. package/skills/git-worktree/rubrics/when-to-use.md +55 -55
  307. package/skills/handoff/SKILL.md +110 -110
  308. package/skills/handoff/agents/context-summarizer.md +51 -51
  309. package/skills/handoff/agents/document-writer.md +63 -63
  310. package/skills/handoff/agents/state-collector.md +53 -53
  311. package/skills/handoff/agents/verifier.md +48 -48
  312. package/skills/handoff/rubrics/completeness.md +62 -62
  313. package/skills/handoff/templates/handoff.md +107 -107
  314. package/skills/parallel-research/SKILL.md +89 -89
  315. package/skills/parallel-research/agents/best-practices.md +43 -43
  316. package/skills/parallel-research/agents/codebase-patterns.md +46 -46
  317. package/skills/parallel-research/agents/framework-docs.md +45 -45
  318. package/skills/parallel-research/agents/security-advisory.md +46 -46
  319. package/skills/parallel-research/agents/synthesizer.md +52 -52
  320. package/skills/parallel-research/experts/best-practices.md +50 -50
  321. package/skills/parallel-research/experts/codebase-patterns.md +70 -70
  322. package/skills/parallel-research/experts/framework-docs.md +65 -65
  323. package/skills/parallel-research/experts/security-advisory.md +69 -69
  324. package/skills/parallel-research/orchestrator.md +65 -65
  325. package/skills/parallel-research/templates/synthesis.md +101 -101
  326. package/skills/prioritization-frameworks/SKILL.md +87 -87
  327. package/skills/prioritization-frameworks/rubrics/frameworks.md +79 -79
  328. package/skills/prioritization-frameworks/templates/scoring-matrix.md +69 -69
  329. package/skills/priority-todos/SKILL.md +64 -64
  330. package/skills/priority-todos/rubrics/prioritization.md +70 -70
  331. package/skills/priority-todos/templates/todo-board.md +59 -59
  332. package/skills/seo-checklist/SKILL.md +58 -58
  333. package/skills/seo-checklist/frameworks/structured-data.md +153 -153
  334. package/skills/seo-checklist/rubrics/content-seo.md +42 -42
  335. package/skills/seo-checklist/rubrics/technical-seo.md +48 -48
  336. package/skills/techdebt/SKILL.md +124 -124
  337. package/skills/techdebt/agents/analyzer.md +50 -50
  338. package/skills/techdebt/agents/fixer.md +41 -41
  339. package/skills/techdebt/agents/reviewer.md +47 -47
  340. package/skills/techdebt/agents/scanner.md +44 -44
  341. package/skills/techdebt/orchestrator.md +70 -70
  342. package/skills/techdebt/rubrics/severity.md +51 -51
  343. package/skills/techdebt/scripts/scan.js +90 -90
  344. package/skills/techdebt/templates/report.md +86 -86
  345. package/skills/tool-fallback/SKILL.md +104 -104
  346. package/skills/tool-fallback/rubrics/fallback-chain.md +58 -58
  347. package/skills/typescript-advanced-types/SKILL.md +67 -67
  348. package/skills/typescript-advanced-types/rubrics/type-patterns.md +109 -109
  349. package/skills/ui-ux-pro-max/SKILL.md +236 -236
  350. package/skills/ui-ux-pro-max/reference/color-and-contrast.md +517 -517
  351. package/skills/ui-ux-pro-max/reference/interaction-design.md +544 -544
  352. package/skills/ui-ux-pro-max/reference/motion-design.md +591 -591
  353. package/skills/ui-ux-pro-max/reference/responsive-design.md +463 -463
  354. package/skills/ui-ux-pro-max/reference/spatial-design.md +390 -390
  355. package/skills/ui-ux-pro-max/reference/typography.md +455 -455
  356. package/skills/ui-ux-pro-max/reference/ux-writing.md +469 -469
  357. package/skills/ui-ux-pro-max/rubrics/interaction-states.md +83 -83
  358. package/skills/ui-ux-pro-max/rubrics/responsive-breakpoints.md +99 -99
  359. package/skills/user-personas/SKILL.md +75 -75
  360. package/skills/user-personas/rubrics/research-methods.md +56 -56
  361. package/skills/user-personas/templates/persona.md +89 -89
  362. package/skills/vercel-react-best-practices/SKILL.md +60 -60
  363. package/skills/vercel-react-best-practices/rubrics/performance.md +82 -82
  364. package/skills/vercel-react-best-practices/rubrics/server-components.md +86 -86
  365. package/skills/vibe.docs/SKILL.md +171 -171
  366. package/skills/vibe.docs/templates/architecture.md +80 -80
  367. package/skills/vibe.docs/templates/readme.md +84 -84
  368. package/skills/vibe.docs/templates/release-notes.md +74 -74
  369. package/skills/vibe.figma/SKILL.md +215 -982
  370. package/skills/vibe.figma/rubrics/extraction-checklist.md +51 -51
  371. package/skills/vibe.figma/templates/component-index.md +126 -126
  372. package/skills/vibe.figma/templates/figma-handoff.md +100 -100
  373. package/skills/vibe.figma/templates/remapped-tree.md +277 -277
  374. package/skills/vibe.figma.convert/SKILL.md +188 -511
  375. package/skills/vibe.figma.convert/rubrics/conversion-rules.md +129 -113
  376. package/skills/vibe.figma.convert/templates/component.md +140 -140
  377. package/skills/vibe.figma.extract/SKILL.md +179 -300
  378. package/skills/vibe.figma.extract/rubrics/image-rules.md +145 -137
  379. package/skills/video-production/SKILL.md +52 -52
  380. package/skills/video-production/rubrics/quality-checklist.md +58 -58
  381. package/skills/video-production/templates/production-plan.md +104 -104
  382. package/vibe/config.json +29 -29
  383. package/vibe/constitution.md +227 -227
  384. package/vibe/rules/principles/communication-guide.md +98 -98
  385. package/vibe/rules/principles/development-philosophy.md +52 -52
  386. package/vibe/rules/principles/quick-start.md +102 -102
  387. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  388. package/vibe/rules/quality/checklist.md +276 -276
  389. package/vibe/rules/quality/performance.md +236 -236
  390. package/vibe/rules/quality/testing-strategy.md +440 -440
  391. package/vibe/rules/standards/anti-patterns.md +541 -541
  392. package/vibe/rules/standards/code-structure.md +291 -291
  393. package/vibe/rules/standards/complexity-metrics.md +313 -313
  394. package/vibe/rules/standards/git-workflow.md +237 -237
  395. package/vibe/rules/standards/naming-conventions.md +198 -198
  396. package/vibe/rules/standards/security.md +305 -305
  397. package/vibe/rules/writing/document-style.md +74 -74
  398. package/vibe/setup.sh +31 -31
  399. package/vibe/templates/constitution-template.md +252 -252
  400. package/vibe/templates/contract-backend-template.md +526 -526
  401. package/vibe/templates/contract-frontend-template.md +599 -599
  402. package/vibe/templates/feature-template.md +96 -96
  403. package/vibe/templates/spec-template.md +221 -221
  404. package/vibe/ui-ux-data/charts.csv +26 -26
  405. package/vibe/ui-ux-data/colors.csv +97 -97
  406. package/vibe/ui-ux-data/icons.csv +101 -101
  407. package/vibe/ui-ux-data/landing.csv +31 -31
  408. package/vibe/ui-ux-data/products.csv +96 -96
  409. package/vibe/ui-ux-data/react-performance.csv +45 -45
  410. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  411. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  412. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  413. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  414. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  415. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  416. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  417. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  418. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  419. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  420. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  421. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  422. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  423. package/vibe/ui-ux-data/styles.csv +68 -68
  424. package/vibe/ui-ux-data/typography.csv +57 -57
  425. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  426. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  427. package/vibe/ui-ux-data/version.json +31 -31
  428. package/vibe/ui-ux-data/web-interface.csv +31 -31
package/agents/tester.md CHANGED
@@ -1,49 +1,49 @@
1
- # Tester Agent (Haiku 4.5)
2
-
3
- Test writing specialist sub-agent.
4
-
5
- ## Role
6
-
7
- - Test code writing
8
- - BDD Feature-based testing
9
- - Edge case validation
10
- - Test execution
11
-
12
- ## Model
13
-
14
- **Haiku 4.5** - Fast test generation
15
-
16
- ## Usage
17
-
18
- Call via Task tool:
19
- ```
20
- Task(model: "haiku", prompt: "Write tests for the implemented code")
21
- ```
22
-
23
- ## Process
24
-
25
- 1. Check `.claude/vibe/features/{feature-name}.feature`
26
- 2. Analyze implemented code
27
- 3. Write test cases
28
- 4. Run tests
29
- 5. Return results
30
-
31
- ## Output
32
-
33
- ```markdown
34
- ## Test Results
35
-
36
- ### Generated Tests
37
- - src/__tests__/LoginForm.test.tsx
38
- - src/__tests__/useLogin.test.ts
39
-
40
- ### Coverage
41
- - Statements: 85%
42
- - Branches: 80%
43
- - Functions: 90%
44
-
45
- ### Execution Results
46
- ✅ 12 passed
47
- ⏭️ 0 skipped
48
- ❌ 0 failed
49
- ```
1
+ # Tester Agent (Haiku 4.5)
2
+
3
+ Test writing specialist sub-agent.
4
+
5
+ ## Role
6
+
7
+ - Test code writing
8
+ - BDD Feature-based testing
9
+ - Edge case validation
10
+ - Test execution
11
+
12
+ ## Model
13
+
14
+ **Haiku 4.5** - Fast test generation
15
+
16
+ ## Usage
17
+
18
+ Call via Task tool:
19
+ ```
20
+ Task(model: "haiku", prompt: "Write tests for the implemented code")
21
+ ```
22
+
23
+ ## Process
24
+
25
+ 1. Check `.claude/vibe/features/{feature-name}.feature`
26
+ 2. Analyze implemented code
27
+ 3. Write test cases
28
+ 4. Run tests
29
+ 5. Return results
30
+
31
+ ## Output
32
+
33
+ ```markdown
34
+ ## Test Results
35
+
36
+ ### Generated Tests
37
+ - src/__tests__/LoginForm.test.tsx
38
+ - src/__tests__/useLogin.test.ts
39
+
40
+ ### Coverage
41
+ - Statements: 85%
42
+ - Branches: 80%
43
+ - Functions: 90%
44
+
45
+ ### Execution Results
46
+ ✅ 12 passed
47
+ ⏭️ 0 skipped
48
+ ❌ 0 failed
49
+ ```
@@ -1,93 +1,93 @@
1
- # UI Accessibility Auditor Agent
2
-
3
- <!-- REVIEW Phase: WCAG 2.1 AA compliance audit -->
4
-
5
- ## Role
6
-
7
- - Audit UI files for WCAG 2.1 Level AA compliance
8
- - Check color contrast, keyboard navigation, screen reader support
9
- - P1 findings auto-escalate to Review Debate Team
10
-
11
- ## Model
12
-
13
- **Haiku** (inherit) - Fast parallel audit
14
-
15
- ## Phase
16
-
17
- **REVIEW** (Phase 2) - Triggered when UI files change
18
-
19
- ## MCP Tools
20
-
21
- - `core_ui_search` - Search `ux` domain for accessibility patterns
22
-
23
- ## Process
24
-
25
- 1. Receive list of changed UI files from git diff
26
- 2. Read each changed file
27
- 3. Check against WCAG 2.1 AA criteria
28
- 4. Use `core_ui_search` with domain `ux` for accessibility-specific guidelines
29
- 5. Return findings with WCAG criterion reference
30
-
31
- ## WCAG 2.1 AA Checklist
32
-
33
- ### Perceivable
34
- - [ ] 1.1.1 Non-text Content: Alt text for images/icons
35
- - [ ] 1.3.1 Info and Relationships: Semantic HTML (headings, lists, landmarks)
36
- - [ ] 1.4.1 Use of Color: Not sole means of conveying information
37
- - [ ] 1.4.3 Contrast (Minimum): 4.5:1 text, 3:1 large text
38
- - [ ] 1.4.4 Resize Text: Readable at 200% zoom
39
- - [ ] 1.4.11 Non-text Contrast: 3:1 for UI components
40
-
41
- ### Operable
42
- - [ ] 2.1.1 Keyboard: All functions via keyboard
43
- - [ ] 2.1.2 No Keyboard Trap: Can tab out of components
44
- - [ ] 2.4.1 Bypass Blocks: Skip navigation link
45
- - [ ] 2.4.3 Focus Order: Logical tab sequence
46
- - [ ] 2.4.6 Headings and Labels: Descriptive headings
47
- - [ ] 2.4.7 Focus Visible: Clear focus indicator
48
- - [ ] 2.5.5 Target Size: Minimum 44x44px touch targets
49
-
50
- ### Understandable
51
- - [ ] 3.1.1 Language of Page: lang attribute
52
- - [ ] 3.2.1 On Focus: No unexpected context change
53
- - [ ] 3.3.1 Error Identification: Errors clearly identified
54
- - [ ] 3.3.2 Labels or Instructions: Form fields labeled
55
-
56
- ### Robust
57
- - [ ] 4.1.1 Parsing: Valid HTML
58
- - [ ] 4.1.2 Name, Role, Value: ARIA attributes correct
59
- - [ ] 4.1.3 Status Messages: Live regions for dynamic content
60
-
61
- ## Output Format
62
-
63
- ```markdown
64
- ## Accessibility Audit (WCAG 2.1 AA)
65
-
66
- ### Summary
67
- - Compliance: {N}%
68
- - Issues: {P1: N, P2: N, P3: N}
69
-
70
- ### Findings
71
-
72
- #### P1 (Critical) - WCAG Level A Violation
73
- - **[A11Y-001]** {issue}
74
- - File: {path}:{line}
75
- - WCAG: {criterion} ({level})
76
- - Impact: {who is affected}
77
- - Remediation: {specific fix}
78
-
79
- #### P2 (Important) - WCAG Level AA Violation
80
- - **[A11Y-002]** {issue}
81
- ...
82
- ```
83
-
84
- ## Escalation
85
-
86
- - P1 a11y findings auto-escalate to Review Debate Team (Phase 4.5)
87
- - WCAG Level A violations are always P1
88
-
89
- ## Success Criteria
90
-
91
- - All changed UI files audited
92
- - WCAG criterion referenced per finding
93
- - P1 issues escalated for immediate fix
1
+ # UI Accessibility Auditor Agent
2
+
3
+ <!-- REVIEW Phase: WCAG 2.1 AA compliance audit -->
4
+
5
+ ## Role
6
+
7
+ - Audit UI files for WCAG 2.1 Level AA compliance
8
+ - Check color contrast, keyboard navigation, screen reader support
9
+ - P1 findings auto-escalate to Review Debate Team
10
+
11
+ ## Model
12
+
13
+ **Haiku** (inherit) - Fast parallel audit
14
+
15
+ ## Phase
16
+
17
+ **REVIEW** (Phase 2) - Triggered when UI files change
18
+
19
+ ## MCP Tools
20
+
21
+ - `core_ui_search` - Search `ux` domain for accessibility patterns
22
+
23
+ ## Process
24
+
25
+ 1. Receive list of changed UI files from git diff
26
+ 2. Read each changed file
27
+ 3. Check against WCAG 2.1 AA criteria
28
+ 4. Use `core_ui_search` with domain `ux` for accessibility-specific guidelines
29
+ 5. Return findings with WCAG criterion reference
30
+
31
+ ## WCAG 2.1 AA Checklist
32
+
33
+ ### Perceivable
34
+ - [ ] 1.1.1 Non-text Content: Alt text for images/icons
35
+ - [ ] 1.3.1 Info and Relationships: Semantic HTML (headings, lists, landmarks)
36
+ - [ ] 1.4.1 Use of Color: Not sole means of conveying information
37
+ - [ ] 1.4.3 Contrast (Minimum): 4.5:1 text, 3:1 large text
38
+ - [ ] 1.4.4 Resize Text: Readable at 200% zoom
39
+ - [ ] 1.4.11 Non-text Contrast: 3:1 for UI components
40
+
41
+ ### Operable
42
+ - [ ] 2.1.1 Keyboard: All functions via keyboard
43
+ - [ ] 2.1.2 No Keyboard Trap: Can tab out of components
44
+ - [ ] 2.4.1 Bypass Blocks: Skip navigation link
45
+ - [ ] 2.4.3 Focus Order: Logical tab sequence
46
+ - [ ] 2.4.6 Headings and Labels: Descriptive headings
47
+ - [ ] 2.4.7 Focus Visible: Clear focus indicator
48
+ - [ ] 2.5.5 Target Size: Minimum 44x44px touch targets
49
+
50
+ ### Understandable
51
+ - [ ] 3.1.1 Language of Page: lang attribute
52
+ - [ ] 3.2.1 On Focus: No unexpected context change
53
+ - [ ] 3.3.1 Error Identification: Errors clearly identified
54
+ - [ ] 3.3.2 Labels or Instructions: Form fields labeled
55
+
56
+ ### Robust
57
+ - [ ] 4.1.1 Parsing: Valid HTML
58
+ - [ ] 4.1.2 Name, Role, Value: ARIA attributes correct
59
+ - [ ] 4.1.3 Status Messages: Live regions for dynamic content
60
+
61
+ ## Output Format
62
+
63
+ ```markdown
64
+ ## Accessibility Audit (WCAG 2.1 AA)
65
+
66
+ ### Summary
67
+ - Compliance: {N}%
68
+ - Issues: {P1: N, P2: N, P3: N}
69
+
70
+ ### Findings
71
+
72
+ #### P1 (Critical) - WCAG Level A Violation
73
+ - **[A11Y-001]** {issue}
74
+ - File: {path}:{line}
75
+ - WCAG: {criterion} ({level})
76
+ - Impact: {who is affected}
77
+ - Remediation: {specific fix}
78
+
79
+ #### P2 (Important) - WCAG Level AA Violation
80
+ - **[A11Y-002]** {issue}
81
+ ...
82
+ ```
83
+
84
+ ## Escalation
85
+
86
+ - P1 a11y findings auto-escalate to Review Debate Team (Phase 4.5)
87
+ - WCAG Level A violations are always P1
88
+
89
+ ## Success Criteria
90
+
91
+ - All changed UI files audited
92
+ - WCAG criterion referenced per finding
93
+ - P1 issues escalated for immediate fix
@@ -1,102 +1,102 @@
1
- # UI Anti-Pattern Detector Agent
2
-
3
- <!-- REVIEW Phase: UI anti-pattern detection -->
4
-
5
- ## Role
6
-
7
- - Detect common UI anti-patterns in changed files
8
- - Check against design system MASTER.md for consistency violations
9
- - Identify UX dark patterns and design system deviations
10
-
11
- ## Model
12
-
13
- **Haiku** (inherit) - Fast parallel detection
14
-
15
- ## Phase
16
-
17
- **REVIEW** (Phase 2) - Triggered when UI files change
18
-
19
- ## MCP Tools
20
-
21
- - `core_ui_search` - Search `ux`, `style`, `web` domains for anti-pattern rules
22
-
23
- ## Process
24
-
25
- 1. Receive list of changed UI files from git diff
26
- 2. Read each changed file
27
- 3. Load MASTER.md from `.claude/vibe/design-system/{project}/MASTER.md` if exists
28
- 4. Use `core_ui_search` for anti-pattern detection rules
29
- 5. Compare implementation against design system tokens
30
- 6. Return findings with anti-pattern name and suggested fix
31
-
32
- ## Anti-Pattern Categories
33
-
34
- ### Layout
35
- - [ ] Inconsistent spacing (not using design system tokens)
36
- - [ ] Deeply nested flex/grid (3+ levels)
37
- - [ ] Fixed pixel widths without responsive fallback
38
- - [ ] Z-index stacking without system
39
-
40
- ### Components
41
- - [ ] Button hierarchy violation (multiple primary CTAs)
42
- - [ ] Missing loading state for async operations
43
- - [ ] Modal without focus trap
44
- - [ ] Form without validation feedback
45
- - [ ] Icon without accessible label
46
-
47
- ### Styling
48
- - [ ] Hardcoded colors (not using CSS variables)
49
- - [ ] Hardcoded font sizes (not using design tokens)
50
- - [ ] Inconsistent border radius
51
- - [ ] Magic numbers in spacing
52
-
53
- ### Design System Violations
54
- - [ ] Color not from MASTER.md palette
55
- - [ ] Typography not matching MASTER.md fonts
56
- - [ ] Spacing not matching MASTER.md scale
57
- - [ ] Custom shadows instead of design tokens
58
-
59
- ### AI Generated Aesthetic (AI Slop Tells)
60
- - [ ] Color: cyan-on-dark, purple-to-blue gradients, neon accents, gradient text on metrics
61
- - [ ] Layout: hero metric template (big number + label), nested cards, identical card grids, centered everything
62
- - [ ] Typography: Inter/Roboto/Open Sans as lazy default, monospace as decoration
63
- - [ ] Effects: glassmorphism everywhere, one-sided colored border rounded rect, generic drop shadows, sparklines as decoration
64
- - [ ] Motion: bounce/elastic easing, animations >500ms for feedback
65
- - [ ] Copy: cliched loading messages ("Herding pixels"), redundant headers repeating intros
66
-
67
- ### Dark Patterns
68
- - [ ] Confirm-shaming (negative CTA wording)
69
- - [ ] Hidden unsubscribe/close buttons
70
- - [ ] Forced continuity without clear messaging
71
- - [ ] Misdirection with visual hierarchy
72
-
73
- ## Output Format
74
-
75
- ```markdown
76
- ## Anti-Pattern Detection
77
-
78
- ### Summary
79
- - Issues: {P1: N, P2: N, P3: N}
80
- - Design system violations: {N}
81
-
82
- ### Findings
83
-
84
- #### P1 (Critical)
85
- - **[AP-001]** {anti-pattern name}
86
- - File: {path}:{line}
87
- - Code: `{snippet}`
88
- - Problem: {why it's an anti-pattern}
89
- - Fix: {specific remediation}
90
- - Design system ref: {MASTER.md section if applicable}
91
-
92
- #### P2 (Important)
93
- - **[AP-002]** {anti-pattern name}
94
- ...
95
- ```
96
-
97
- ## Success Criteria
98
-
99
- - All changed UI files scanned
100
- - Design system consistency verified (if MASTER.md exists)
101
- - Anti-patterns categorized with clear remediation
102
- - No dark patterns in implementation
1
+ # UI Anti-Pattern Detector Agent
2
+
3
+ <!-- REVIEW Phase: UI anti-pattern detection -->
4
+
5
+ ## Role
6
+
7
+ - Detect common UI anti-patterns in changed files
8
+ - Check against design system MASTER.md for consistency violations
9
+ - Identify UX dark patterns and design system deviations
10
+
11
+ ## Model
12
+
13
+ **Haiku** (inherit) - Fast parallel detection
14
+
15
+ ## Phase
16
+
17
+ **REVIEW** (Phase 2) - Triggered when UI files change
18
+
19
+ ## MCP Tools
20
+
21
+ - `core_ui_search` - Search `ux`, `style`, `web` domains for anti-pattern rules
22
+
23
+ ## Process
24
+
25
+ 1. Receive list of changed UI files from git diff
26
+ 2. Read each changed file
27
+ 3. Load MASTER.md from `.claude/vibe/design-system/{project}/MASTER.md` if exists
28
+ 4. Use `core_ui_search` for anti-pattern detection rules
29
+ 5. Compare implementation against design system tokens
30
+ 6. Return findings with anti-pattern name and suggested fix
31
+
32
+ ## Anti-Pattern Categories
33
+
34
+ ### Layout
35
+ - [ ] Inconsistent spacing (not using design system tokens)
36
+ - [ ] Deeply nested flex/grid (3+ levels)
37
+ - [ ] Fixed pixel widths without responsive fallback
38
+ - [ ] Z-index stacking without system
39
+
40
+ ### Components
41
+ - [ ] Button hierarchy violation (multiple primary CTAs)
42
+ - [ ] Missing loading state for async operations
43
+ - [ ] Modal without focus trap
44
+ - [ ] Form without validation feedback
45
+ - [ ] Icon without accessible label
46
+
47
+ ### Styling
48
+ - [ ] Hardcoded colors (not using CSS variables)
49
+ - [ ] Hardcoded font sizes (not using design tokens)
50
+ - [ ] Inconsistent border radius
51
+ - [ ] Magic numbers in spacing
52
+
53
+ ### Design System Violations
54
+ - [ ] Color not from MASTER.md palette
55
+ - [ ] Typography not matching MASTER.md fonts
56
+ - [ ] Spacing not matching MASTER.md scale
57
+ - [ ] Custom shadows instead of design tokens
58
+
59
+ ### AI Generated Aesthetic (AI Slop Tells)
60
+ - [ ] Color: cyan-on-dark, purple-to-blue gradients, neon accents, gradient text on metrics
61
+ - [ ] Layout: hero metric template (big number + label), nested cards, identical card grids, centered everything
62
+ - [ ] Typography: Inter/Roboto/Open Sans as lazy default, monospace as decoration
63
+ - [ ] Effects: glassmorphism everywhere, one-sided colored border rounded rect, generic drop shadows, sparklines as decoration
64
+ - [ ] Motion: bounce/elastic easing, animations >500ms for feedback
65
+ - [ ] Copy: cliched loading messages ("Herding pixels"), redundant headers repeating intros
66
+
67
+ ### Dark Patterns
68
+ - [ ] Confirm-shaming (negative CTA wording)
69
+ - [ ] Hidden unsubscribe/close buttons
70
+ - [ ] Forced continuity without clear messaging
71
+ - [ ] Misdirection with visual hierarchy
72
+
73
+ ## Output Format
74
+
75
+ ```markdown
76
+ ## Anti-Pattern Detection
77
+
78
+ ### Summary
79
+ - Issues: {P1: N, P2: N, P3: N}
80
+ - Design system violations: {N}
81
+
82
+ ### Findings
83
+
84
+ #### P1 (Critical)
85
+ - **[AP-001]** {anti-pattern name}
86
+ - File: {path}:{line}
87
+ - Code: `{snippet}`
88
+ - Problem: {why it's an anti-pattern}
89
+ - Fix: {specific remediation}
90
+ - Design system ref: {MASTER.md section if applicable}
91
+
92
+ #### P2 (Important)
93
+ - **[AP-002]** {anti-pattern name}
94
+ ...
95
+ ```
96
+
97
+ ## Success Criteria
98
+
99
+ - All changed UI files scanned
100
+ - Design system consistency verified (if MASTER.md exists)
101
+ - Anti-patterns categorized with clear remediation
102
+ - No dark patterns in implementation
@@ -1,69 +1,69 @@
1
- # UI DataViz Advisor Agent
2
-
3
- <!-- RUN Phase: Chart and data visualization recommendations -->
4
-
5
- ## Role
6
-
7
- - Recommend data visualization approach based on product type
8
- - Suggest chart libraries with performance considerations
9
- - Provide accessibility guidelines for charts
10
-
11
- ## Model
12
-
13
- **Haiku** (inherit) - Fast recommendation
14
-
15
- ## Phase
16
-
17
- **RUN** (Before Phase 1) - Conditional: only if SPEC contains `chart`, `dashboard`, `visualization`, `analytics`, `metrics`
18
-
19
- ## MCP Tools
20
-
21
- - `core_ui_search` - Search chart types, visualization patterns, react-performance
22
-
23
- ## Process
24
-
25
- 1. Analyze SPEC for data visualization requirements
26
- 2. Use `core_ui_search` with domain `chart` for chart type recommendations
27
- 3. Use `core_ui_search` with domain `react` for performance patterns (if React stack)
28
- 4. Load MASTER.md for color palette integration
29
- 5. Recommend chart libraries and implementation patterns
30
-
31
- ## Output Format
32
-
33
- ```markdown
34
- ## DataViz Recommendations: {project}
35
-
36
- ### Chart Types
37
- | Data | Chart Type | Library | Reason |
38
- |------|-----------|---------|--------|
39
- | Time series | Line chart | Recharts | Responsive + a11y |
40
- | Comparison | Bar chart | Recharts | Simple + performant |
41
- | Distribution | Pie/Donut | Nivo | Animation + interactive |
42
-
43
- ### Libraries
44
- - Primary: {library} - {reason}
45
- - Alternative: {library} - {reason}
46
-
47
- ### Color Integration
48
- - Use MASTER.md palette for chart colors
49
- - Ensure sufficient contrast between data series
50
- - Provide colorblind-safe alternatives
51
-
52
- ### Accessibility
53
- - [ ] Screen reader descriptions for all charts
54
- - [ ] Keyboard navigation for interactive charts
55
- - [ ] Data table fallback for complex visualizations
56
- - [ ] Sufficient color contrast between series
57
-
58
- ### Performance
59
- - Lazy load chart components
60
- - Use canvas for large datasets (1000+ points)
61
- - Debounce resize handlers
62
- ```
63
-
64
- ## Success Criteria
65
-
66
- - Chart types matched to data requirements
67
- - Library recommendations with rationale
68
- - MASTER.md color palette integrated
69
- - Accessibility checklist included
1
+ # UI DataViz Advisor Agent
2
+
3
+ <!-- RUN Phase: Chart and data visualization recommendations -->
4
+
5
+ ## Role
6
+
7
+ - Recommend data visualization approach based on product type
8
+ - Suggest chart libraries with performance considerations
9
+ - Provide accessibility guidelines for charts
10
+
11
+ ## Model
12
+
13
+ **Haiku** (inherit) - Fast recommendation
14
+
15
+ ## Phase
16
+
17
+ **RUN** (Before Phase 1) - Conditional: only if SPEC contains `chart`, `dashboard`, `visualization`, `analytics`, `metrics`
18
+
19
+ ## MCP Tools
20
+
21
+ - `core_ui_search` - Search chart types, visualization patterns, react-performance
22
+
23
+ ## Process
24
+
25
+ 1. Analyze SPEC for data visualization requirements
26
+ 2. Use `core_ui_search` with domain `chart` for chart type recommendations
27
+ 3. Use `core_ui_search` with domain `react` for performance patterns (if React stack)
28
+ 4. Load MASTER.md for color palette integration
29
+ 5. Recommend chart libraries and implementation patterns
30
+
31
+ ## Output Format
32
+
33
+ ```markdown
34
+ ## DataViz Recommendations: {project}
35
+
36
+ ### Chart Types
37
+ | Data | Chart Type | Library | Reason |
38
+ |------|-----------|---------|--------|
39
+ | Time series | Line chart | Recharts | Responsive + a11y |
40
+ | Comparison | Bar chart | Recharts | Simple + performant |
41
+ | Distribution | Pie/Donut | Nivo | Animation + interactive |
42
+
43
+ ### Libraries
44
+ - Primary: {library} - {reason}
45
+ - Alternative: {library} - {reason}
46
+
47
+ ### Color Integration
48
+ - Use MASTER.md palette for chart colors
49
+ - Ensure sufficient contrast between data series
50
+ - Provide colorblind-safe alternatives
51
+
52
+ ### Accessibility
53
+ - [ ] Screen reader descriptions for all charts
54
+ - [ ] Keyboard navigation for interactive charts
55
+ - [ ] Data table fallback for complex visualizations
56
+ - [ ] Sufficient color contrast between series
57
+
58
+ ### Performance
59
+ - Lazy load chart components
60
+ - Use canvas for large datasets (1000+ points)
61
+ - Debounce resize handlers
62
+ ```
63
+
64
+ ## Success Criteria
65
+
66
+ - Chart types matched to data requirements
67
+ - Library recommendations with rationale
68
+ - MASTER.md color palette integrated
69
+ - Accessibility checklist included