@su-record/vibe 2.8.49 → 2.8.51

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