@su-record/vibe 2.8.48 → 2.8.50

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 (414) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +169 -169
  3. package/LICENSE +21 -21
  4. package/README.md +694 -554
  5. package/agents/architect-low.md +41 -41
  6. package/agents/architect-medium.md +59 -59
  7. package/agents/architect.md +80 -80
  8. package/agents/build-error-resolver.md +115 -115
  9. package/agents/compounder.md +261 -261
  10. package/agents/diagrammer.md +178 -178
  11. package/agents/docs/api-documenter.md +99 -99
  12. package/agents/docs/changelog-writer.md +93 -93
  13. package/agents/e2e-tester.md +294 -294
  14. package/agents/event/event-comms.md +78 -78
  15. package/agents/event/event-content.md +68 -68
  16. package/agents/event/event-image.md +95 -95
  17. package/agents/event/event-ops.md +84 -84
  18. package/agents/event/event-scheduler.md +69 -69
  19. package/agents/event/event-speaker.md +86 -86
  20. package/agents/explorer-low.md +42 -42
  21. package/agents/explorer-medium.md +59 -59
  22. package/agents/explorer.md +48 -48
  23. package/agents/implementer-low.md +43 -43
  24. package/agents/implementer-medium.md +52 -52
  25. package/agents/implementer.md +54 -54
  26. package/agents/junior-mentor.md +141 -141
  27. package/agents/planning/requirements-analyst.md +84 -84
  28. package/agents/planning/ux-advisor.md +83 -83
  29. package/agents/qa/acceptance-tester.md +86 -86
  30. package/agents/qa/edge-case-finder.md +93 -93
  31. package/agents/qa/qa-coordinator.md +131 -131
  32. package/agents/refactor-cleaner.md +143 -143
  33. package/agents/research/best-practices-agent.md +199 -199
  34. package/agents/research/codebase-patterns-agent.md +157 -157
  35. package/agents/research/framework-docs-agent.md +188 -188
  36. package/agents/research/security-advisory-agent.md +213 -213
  37. package/agents/review/architecture-reviewer.md +107 -107
  38. package/agents/review/complexity-reviewer.md +116 -116
  39. package/agents/review/data-integrity-reviewer.md +88 -88
  40. package/agents/review/git-history-reviewer.md +103 -103
  41. package/agents/review/performance-reviewer.md +86 -86
  42. package/agents/review/python-reviewer.md +150 -150
  43. package/agents/review/rails-reviewer.md +139 -139
  44. package/agents/review/react-reviewer.md +144 -144
  45. package/agents/review/security-reviewer.md +80 -80
  46. package/agents/review/simplicity-reviewer.md +140 -140
  47. package/agents/review/test-coverage-reviewer.md +116 -116
  48. package/agents/review/typescript-reviewer.md +127 -127
  49. package/agents/searcher.md +54 -54
  50. package/agents/simplifier.md +120 -120
  51. package/agents/tester.md +49 -49
  52. package/agents/ui/ui-a11y-auditor.md +93 -93
  53. package/agents/ui/ui-antipattern-detector.md +102 -102
  54. package/agents/ui/ui-dataviz-advisor.md +69 -69
  55. package/agents/ui/ui-design-system-gen.md +57 -57
  56. package/agents/ui/ui-industry-analyzer.md +49 -49
  57. package/agents/ui/ui-layout-architect.md +65 -65
  58. package/agents/ui/ui-stack-implementer.md +68 -68
  59. package/agents/ui/ux-compliance-reviewer.md +81 -81
  60. package/agents/ui-previewer.md +258 -258
  61. package/commands/vibe.analyze.md +379 -379
  62. package/commands/vibe.docs.md +32 -32
  63. package/commands/vibe.event.md +163 -163
  64. package/commands/vibe.figma.md +69 -69
  65. package/commands/vibe.review.md +686 -686
  66. package/commands/vibe.run.md +2276 -2276
  67. package/commands/vibe.spec.md +1195 -1195
  68. package/commands/vibe.spec.review.md +609 -609
  69. package/commands/vibe.trace.md +259 -259
  70. package/commands/vibe.utils.md +413 -413
  71. package/commands/vibe.verify.md +510 -510
  72. package/dist/cli/collaborator.js +52 -52
  73. package/dist/cli/commands/config.js +9 -9
  74. package/dist/cli/commands/evolution.js +12 -12
  75. package/dist/cli/commands/figma.js +20 -20
  76. package/dist/cli/commands/info.js +53 -53
  77. package/dist/cli/commands/init.js +5 -5
  78. package/dist/cli/commands/remove.js +14 -14
  79. package/dist/cli/commands/sentinel.js +27 -27
  80. package/dist/cli/commands/skills.js +5 -5
  81. package/dist/cli/commands/slack.js +10 -10
  82. package/dist/cli/commands/stats.js +6 -6
  83. package/dist/cli/commands/telegram.js +12 -12
  84. package/dist/cli/detect.js +32 -32
  85. package/dist/cli/index.js +53 -53
  86. package/dist/cli/llm/claude-commands.js +16 -16
  87. package/dist/cli/llm/config.js +18 -18
  88. package/dist/cli/llm/gemini-commands.js +16 -16
  89. package/dist/cli/llm/gpt-commands.js +19 -19
  90. package/dist/cli/llm/help.js +21 -21
  91. package/dist/cli/postinstall/cursor-agents.js +32 -32
  92. package/dist/cli/postinstall/cursor-rules.js +83 -83
  93. package/dist/cli/postinstall/cursor-skills.js +743 -743
  94. package/dist/cli/setup/Provisioner.js +42 -42
  95. package/dist/infra/lib/DeepInit.js +24 -24
  96. package/dist/infra/lib/IterationTracker.js +11 -11
  97. package/dist/infra/lib/PythonParser.js +108 -108
  98. package/dist/infra/lib/ReviewRace.js +96 -96
  99. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  100. package/dist/infra/lib/SkillQualityGate.js +9 -9
  101. package/dist/infra/lib/SkillRepository.js +159 -159
  102. package/dist/infra/lib/UltraQA.js +99 -99
  103. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  104. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  105. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  106. package/dist/infra/lib/autonomy/PolicyEngine.d.ts +3 -3
  107. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  108. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  109. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  110. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  111. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  112. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  113. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  114. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  115. package/dist/infra/lib/evolution/ParityTester.js +57 -57
  116. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  117. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  118. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  119. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  120. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  121. package/dist/infra/lib/gemini/orchestration.js +5 -5
  122. package/dist/infra/lib/gpt/orchestration.js +4 -4
  123. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  124. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  125. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  126. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  127. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  128. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  129. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  130. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  131. package/dist/infra/orchestrator/AgentManager.js +12 -12
  132. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  133. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  134. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  135. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  136. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  137. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  138. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  139. package/dist/tools/memory/getMemoryGraph.js +12 -12
  140. package/dist/tools/memory/getSessionContext.js +9 -9
  141. package/dist/tools/memory/linkMemories.js +14 -14
  142. package/dist/tools/memory/listMemories.js +4 -4
  143. package/dist/tools/memory/recallMemory.js +4 -4
  144. package/dist/tools/memory/saveMemory.js +4 -4
  145. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  146. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  147. package/dist/tools/semantic/astGrep.test.js +6 -6
  148. package/dist/tools/spec/prdParser.test.js +171 -171
  149. package/dist/tools/spec/specGenerator.js +169 -169
  150. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  151. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  152. package/hooks/gemini-hooks.json +73 -73
  153. package/hooks/hooks.json +170 -170
  154. package/hooks/scripts/__tests__/keyword-detector.test.js +199 -199
  155. package/hooks/scripts/__tests__/pre-tool-guard.test.js +286 -286
  156. package/hooks/scripts/__tests__/sentinel-guard.test.js +210 -210
  157. package/hooks/scripts/auto-commit.js +97 -65
  158. package/hooks/scripts/auto-format.js +64 -64
  159. package/hooks/scripts/auto-test.js +81 -81
  160. package/hooks/scripts/code-check.js +268 -216
  161. package/hooks/scripts/codex-detect.js +46 -46
  162. package/hooks/scripts/codex-review-gate.js +80 -80
  163. package/hooks/scripts/command-log.js +32 -32
  164. package/hooks/scripts/context-save.js +353 -353
  165. package/hooks/scripts/evolution-engine.js +91 -91
  166. package/hooks/scripts/figma-extract.js +477 -477
  167. package/hooks/scripts/hud-status.js +321 -321
  168. package/hooks/scripts/keyword-detector.js +214 -214
  169. package/hooks/scripts/llm-orchestrate.js +572 -555
  170. package/hooks/scripts/post-edit.js +32 -32
  171. package/hooks/scripts/pr-test-gate.js +52 -52
  172. package/hooks/scripts/pre-tool-guard.js +159 -159
  173. package/hooks/scripts/prompt-dispatcher.js +185 -185
  174. package/hooks/scripts/sentinel-guard.js +131 -131
  175. package/hooks/scripts/session-start.js +177 -106
  176. package/hooks/scripts/skill-injector.js +83 -83
  177. package/hooks/scripts/stop-notify.js +209 -209
  178. package/hooks/scripts/utils.js +243 -186
  179. package/languages/csharp-unity.md +515 -515
  180. package/languages/gdscript-godot.md +470 -470
  181. package/languages/ruby-rails.md +489 -489
  182. package/languages/typescript-angular.md +433 -433
  183. package/languages/typescript-astro.md +416 -416
  184. package/languages/typescript-electron.md +406 -406
  185. package/languages/typescript-nestjs.md +524 -524
  186. package/languages/typescript-svelte.md +407 -407
  187. package/languages/typescript-tauri.md +365 -365
  188. package/package.json +101 -100
  189. package/skills/agents-md/SKILL.md +121 -121
  190. package/skills/agents-md/rubrics/what-to-keep.md +49 -49
  191. package/skills/agents-md/templates/agents-md.md +36 -36
  192. package/skills/arch-guard/SKILL.md +181 -181
  193. package/skills/arch-guard/agents/detector.md +48 -48
  194. package/skills/arch-guard/agents/reporter.md +48 -48
  195. package/skills/arch-guard/agents/rule-generator.md +49 -49
  196. package/skills/arch-guard/agents/violation-checker.md +51 -51
  197. package/skills/arch-guard/frameworks/clean-architecture.md +108 -108
  198. package/skills/arch-guard/frameworks/solid.md +102 -102
  199. package/skills/arch-guard/scripts/check-boundaries.js +90 -90
  200. package/skills/arch-guard/templates/arch-rules.json +47 -47
  201. package/skills/arch-guard/templates/violation-report.md +53 -53
  202. package/skills/brand-assets/SKILL.md +147 -147
  203. package/skills/brand-assets/rubrics/asset-checklist.md +98 -98
  204. package/skills/brand-assets/templates/brand-guide.md +161 -161
  205. package/skills/capability-loop/SKILL.md +168 -168
  206. package/skills/capability-loop/agents/capability-designer.md +61 -61
  207. package/skills/capability-loop/agents/failure-analyst.md +55 -55
  208. package/skills/capability-loop/agents/implementer.md +50 -50
  209. package/skills/capability-loop/agents/tester.md +53 -53
  210. package/skills/capability-loop/templates/capability-spec.md +118 -118
  211. package/skills/capability-loop/templates/failure-analysis.md +118 -118
  212. package/skills/characterization-test/SKILL.md +207 -207
  213. package/skills/characterization-test/agents/behavior-capturer.md +50 -50
  214. package/skills/characterization-test/agents/coverage-checker.md +54 -54
  215. package/skills/characterization-test/agents/reporter.md +50 -50
  216. package/skills/characterization-test/agents/test-writer.md +49 -49
  217. package/skills/characterization-test/rubrics/coverage-criteria.md +53 -53
  218. package/skills/characterization-test/templates/test-template.ts +101 -101
  219. package/skills/chub-usage/SKILL.md +115 -115
  220. package/skills/claude-md-guide/SKILL.md +351 -351
  221. package/skills/claude-md-guide/rubrics/anti-patterns.md +88 -88
  222. package/skills/claude-md-guide/templates/claude-md.md +54 -54
  223. package/skills/commerce-patterns/SKILL.md +64 -64
  224. package/skills/commerce-patterns/rubrics/checkout-flow.md +48 -48
  225. package/skills/commerce-patterns/templates/product-schema.md +85 -85
  226. package/skills/commit-push-pr/SKILL.md +77 -77
  227. package/skills/commit-push-pr/agents/change-analyzer.md +55 -55
  228. package/skills/commit-push-pr/agents/message-writer.md +50 -50
  229. package/skills/commit-push-pr/agents/pr-writer.md +58 -58
  230. package/skills/commit-push-pr/agents/reviewer.md +52 -52
  231. package/skills/commit-push-pr/rubrics/commit-message.md +73 -73
  232. package/skills/commit-push-pr/templates/pr-body.md +63 -63
  233. package/skills/context7-usage/SKILL.md +106 -106
  234. package/skills/context7-usage/rubrics/when-to-use.md +50 -50
  235. package/skills/create-prd/SKILL.md +90 -90
  236. package/skills/create-prd/agents/edge-case-finder.md +48 -48
  237. package/skills/create-prd/agents/prioritizer.md +60 -60
  238. package/skills/create-prd/agents/requirements-writer.md +48 -48
  239. package/skills/create-prd/agents/researcher.md +55 -55
  240. package/skills/create-prd/agents/reviewer.md +54 -54
  241. package/skills/create-prd/frameworks/jobs-to-be-done.md +96 -96
  242. package/skills/create-prd/frameworks/rice-scoring.md +97 -97
  243. package/skills/create-prd/orchestrator.md +70 -70
  244. package/skills/create-prd/rubrics/completeness.md +58 -58
  245. package/skills/create-prd/templates/prd.md +139 -139
  246. package/skills/design-audit/SKILL.md +152 -152
  247. package/skills/design-audit/agents/a11y-auditor.md +43 -43
  248. package/skills/design-audit/agents/performance-auditor.md +46 -46
  249. package/skills/design-audit/agents/responsive-auditor.md +46 -46
  250. package/skills/design-audit/agents/scorer.md +47 -47
  251. package/skills/design-audit/agents/slop-detector.md +47 -47
  252. package/skills/design-audit/frameworks/core-web-vitals.md +107 -107
  253. package/skills/design-audit/frameworks/wcag-checklist.md +64 -64
  254. package/skills/design-audit/orchestrator.md +64 -64
  255. package/skills/design-audit/rubrics/ai-slop-patterns.md +83 -83
  256. package/skills/design-audit/rubrics/scoring.md +63 -63
  257. package/skills/design-audit/templates/report.md +88 -88
  258. package/skills/design-critique/SKILL.md +139 -139
  259. package/skills/design-critique/rubrics/ux-heuristics.md +143 -143
  260. package/skills/design-critique/templates/critique-report.md +86 -86
  261. package/skills/design-distill/SKILL.md +130 -130
  262. package/skills/design-distill/templates/design-system.md +132 -132
  263. package/skills/design-normalize/SKILL.md +133 -133
  264. package/skills/design-normalize/rubrics/token-naming.md +117 -117
  265. package/skills/design-normalize/templates/token-audit.md +89 -89
  266. package/skills/design-polish/SKILL.md +131 -131
  267. package/skills/design-polish/rubrics/polish-checklist.md +68 -68
  268. package/skills/design-polish/templates/polish-report.md +64 -64
  269. package/skills/design-teach/SKILL.md +182 -182
  270. package/skills/design-teach/rubrics/brand-personality.md +73 -73
  271. package/skills/design-teach/templates/design-context.json +36 -36
  272. package/skills/e2e-commerce/SKILL.md +62 -62
  273. package/skills/e2e-commerce/templates/test-scenarios.md +170 -170
  274. package/skills/event-comms/SKILL.md +162 -162
  275. package/skills/event-comms/templates/email-invite.md +99 -99
  276. package/skills/event-comms/templates/sns-post.md +133 -133
  277. package/skills/event-ops/SKILL.md +198 -198
  278. package/skills/event-ops/rubrics/contingency.md +85 -85
  279. package/skills/event-ops/templates/d-day-checklist.md +65 -65
  280. package/skills/event-planning/SKILL.md +132 -132
  281. package/skills/event-planning/rubrics/timeline.md +70 -70
  282. package/skills/event-planning/templates/event-plan.md +91 -91
  283. package/skills/exec-plan/SKILL.md +149 -149
  284. package/skills/exec-plan/agents/decomposer.md +47 -47
  285. package/skills/exec-plan/agents/dependency-mapper.md +44 -44
  286. package/skills/exec-plan/agents/estimator.md +43 -43
  287. package/skills/exec-plan/agents/validator.md +55 -55
  288. package/skills/exec-plan/orchestrator.md +70 -70
  289. package/skills/exec-plan/rubrics/complexity-scoring.md +75 -75
  290. package/skills/exec-plan/templates/plan.md +147 -147
  291. package/skills/git-worktree/SKILL.md +73 -73
  292. package/skills/git-worktree/rubrics/when-to-use.md +55 -55
  293. package/skills/handoff/SKILL.md +110 -110
  294. package/skills/handoff/agents/context-summarizer.md +51 -51
  295. package/skills/handoff/agents/document-writer.md +63 -63
  296. package/skills/handoff/agents/state-collector.md +53 -53
  297. package/skills/handoff/agents/verifier.md +48 -48
  298. package/skills/handoff/rubrics/completeness.md +62 -62
  299. package/skills/handoff/templates/handoff.md +107 -107
  300. package/skills/parallel-research/SKILL.md +89 -89
  301. package/skills/parallel-research/agents/best-practices.md +43 -43
  302. package/skills/parallel-research/agents/codebase-patterns.md +46 -46
  303. package/skills/parallel-research/agents/framework-docs.md +45 -45
  304. package/skills/parallel-research/agents/security-advisory.md +46 -46
  305. package/skills/parallel-research/agents/synthesizer.md +52 -52
  306. package/skills/parallel-research/experts/best-practices.md +50 -50
  307. package/skills/parallel-research/experts/codebase-patterns.md +70 -70
  308. package/skills/parallel-research/experts/framework-docs.md +65 -65
  309. package/skills/parallel-research/experts/security-advisory.md +69 -69
  310. package/skills/parallel-research/orchestrator.md +65 -65
  311. package/skills/parallel-research/templates/synthesis.md +101 -101
  312. package/skills/prioritization-frameworks/SKILL.md +87 -87
  313. package/skills/prioritization-frameworks/rubrics/frameworks.md +79 -79
  314. package/skills/prioritization-frameworks/templates/scoring-matrix.md +69 -69
  315. package/skills/priority-todos/SKILL.md +64 -64
  316. package/skills/priority-todos/rubrics/prioritization.md +70 -70
  317. package/skills/priority-todos/templates/todo-board.md +59 -59
  318. package/skills/seo-checklist/SKILL.md +58 -58
  319. package/skills/seo-checklist/frameworks/structured-data.md +153 -153
  320. package/skills/seo-checklist/rubrics/content-seo.md +42 -42
  321. package/skills/seo-checklist/rubrics/technical-seo.md +48 -48
  322. package/skills/techdebt/SKILL.md +124 -124
  323. package/skills/techdebt/agents/analyzer.md +50 -50
  324. package/skills/techdebt/agents/fixer.md +41 -41
  325. package/skills/techdebt/agents/reviewer.md +47 -47
  326. package/skills/techdebt/agents/scanner.md +44 -44
  327. package/skills/techdebt/orchestrator.md +70 -70
  328. package/skills/techdebt/rubrics/severity.md +51 -51
  329. package/skills/techdebt/scripts/scan.js +90 -90
  330. package/skills/techdebt/templates/report.md +86 -86
  331. package/skills/tool-fallback/SKILL.md +104 -104
  332. package/skills/tool-fallback/rubrics/fallback-chain.md +58 -58
  333. package/skills/typescript-advanced-types/SKILL.md +67 -67
  334. package/skills/typescript-advanced-types/rubrics/type-patterns.md +109 -109
  335. package/skills/ui-ux-pro-max/SKILL.md +236 -236
  336. package/skills/ui-ux-pro-max/reference/color-and-contrast.md +517 -517
  337. package/skills/ui-ux-pro-max/reference/interaction-design.md +544 -544
  338. package/skills/ui-ux-pro-max/reference/motion-design.md +591 -591
  339. package/skills/ui-ux-pro-max/reference/responsive-design.md +463 -463
  340. package/skills/ui-ux-pro-max/reference/spatial-design.md +390 -390
  341. package/skills/ui-ux-pro-max/reference/typography.md +455 -455
  342. package/skills/ui-ux-pro-max/reference/ux-writing.md +469 -469
  343. package/skills/ui-ux-pro-max/rubrics/interaction-states.md +83 -83
  344. package/skills/ui-ux-pro-max/rubrics/responsive-breakpoints.md +99 -99
  345. package/skills/user-personas/SKILL.md +75 -75
  346. package/skills/user-personas/rubrics/research-methods.md +56 -56
  347. package/skills/user-personas/templates/persona.md +89 -89
  348. package/skills/vercel-react-best-practices/SKILL.md +60 -60
  349. package/skills/vercel-react-best-practices/rubrics/performance.md +82 -82
  350. package/skills/vercel-react-best-practices/rubrics/server-components.md +86 -86
  351. package/skills/vibe.docs/SKILL.md +171 -171
  352. package/skills/vibe.docs/templates/architecture.md +80 -80
  353. package/skills/vibe.docs/templates/readme.md +84 -84
  354. package/skills/vibe.docs/templates/release-notes.md +74 -74
  355. package/skills/vibe.figma/SKILL.md +982 -1064
  356. package/skills/vibe.figma/rubrics/extraction-checklist.md +51 -51
  357. package/skills/vibe.figma/templates/component-index.md +126 -126
  358. package/skills/vibe.figma/templates/figma-handoff.md +100 -100
  359. package/skills/vibe.figma/templates/remapped-tree.md +277 -277
  360. package/skills/vibe.figma.convert/SKILL.md +511 -553
  361. package/skills/vibe.figma.convert/rubrics/conversion-rules.md +113 -129
  362. package/skills/vibe.figma.convert/templates/component.md +140 -140
  363. package/skills/vibe.figma.extract/SKILL.md +300 -312
  364. package/skills/vibe.figma.extract/rubrics/image-rules.md +137 -145
  365. package/skills/video-production/SKILL.md +52 -52
  366. package/skills/video-production/rubrics/quality-checklist.md +58 -58
  367. package/skills/video-production/templates/production-plan.md +104 -104
  368. package/vibe/config.json +29 -29
  369. package/vibe/constitution.md +227 -227
  370. package/vibe/rules/principles/communication-guide.md +98 -98
  371. package/vibe/rules/principles/development-philosophy.md +52 -52
  372. package/vibe/rules/principles/quick-start.md +102 -102
  373. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  374. package/vibe/rules/quality/checklist.md +276 -276
  375. package/vibe/rules/quality/performance.md +236 -236
  376. package/vibe/rules/quality/testing-strategy.md +440 -440
  377. package/vibe/rules/standards/anti-patterns.md +541 -541
  378. package/vibe/rules/standards/code-structure.md +291 -291
  379. package/vibe/rules/standards/complexity-metrics.md +313 -313
  380. package/vibe/rules/standards/git-workflow.md +237 -237
  381. package/vibe/rules/standards/naming-conventions.md +198 -198
  382. package/vibe/rules/standards/security.md +305 -305
  383. package/vibe/rules/writing/document-style.md +74 -74
  384. package/vibe/setup.sh +31 -31
  385. package/vibe/templates/constitution-template.md +252 -252
  386. package/vibe/templates/contract-backend-template.md +526 -526
  387. package/vibe/templates/contract-frontend-template.md +599 -599
  388. package/vibe/templates/feature-template.md +96 -96
  389. package/vibe/templates/spec-template.md +221 -221
  390. package/vibe/ui-ux-data/charts.csv +26 -26
  391. package/vibe/ui-ux-data/colors.csv +97 -97
  392. package/vibe/ui-ux-data/icons.csv +101 -101
  393. package/vibe/ui-ux-data/landing.csv +31 -31
  394. package/vibe/ui-ux-data/products.csv +96 -96
  395. package/vibe/ui-ux-data/react-performance.csv +45 -45
  396. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  397. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  398. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  399. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  400. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  401. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  402. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  403. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  404. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  405. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  406. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  407. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  408. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  409. package/vibe/ui-ux-data/styles.csv +68 -68
  410. package/vibe/ui-ux-data/typography.csv +57 -57
  411. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  412. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  413. package/vibe/ui-ux-data/version.json +31 -31
  414. 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