tribunal-kit 5.8.5 → 6.0.0

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 (298) hide show
  1. package/.agent/ARCHITECTURE.md +219 -215
  2. package/.agent/agents/accessibility-reviewer.md +66 -151
  3. package/.agent/agents/ai-code-reviewer.md +22 -2
  4. package/.agent/agents/anti-pattern-reviewer.md +99 -0
  5. package/.agent/agents/api-architect.md +19 -2
  6. package/.agent/agents/backend-specialist.md +25 -3
  7. package/.agent/agents/cloud-engineer.md +21 -0
  8. package/.agent/agents/code-archaeologist.md +20 -3
  9. package/.agent/agents/complexity-reviewer.md +22 -2
  10. package/.agent/agents/database-architect.md +24 -3
  11. package/.agent/agents/db-latency-auditor.md +22 -2
  12. package/.agent/agents/debugger.md +19 -3
  13. package/.agent/agents/dependency-reviewer.md +19 -2
  14. package/.agent/agents/devops-engineer.md +24 -3
  15. package/.agent/agents/documentation-writer.md +21 -3
  16. package/.agent/agents/explorer-agent.md +21 -3
  17. package/.agent/agents/frontend-reviewer.md +19 -3
  18. package/.agent/agents/frontend-specialist.md +72 -224
  19. package/.agent/agents/game-developer.md +22 -3
  20. package/.agent/agents/interaction-reviewer.md +118 -0
  21. package/.agent/agents/logic-reviewer.md +18 -3
  22. package/.agent/agents/minimalist-reviewer.md +98 -0
  23. package/.agent/agents/mobile-developer.md +21 -3
  24. package/.agent/agents/mobile-reviewer.md +22 -2
  25. package/.agent/agents/orchestrator.md +19 -3
  26. package/.agent/agents/penetration-tester.md +22 -3
  27. package/.agent/agents/performance-optimizer.md +21 -3
  28. package/.agent/agents/performance-reviewer.md +2 -0
  29. package/.agent/agents/precedence-reviewer.md +19 -5
  30. package/.agent/agents/product-manager.md +20 -3
  31. package/.agent/agents/product-owner.md +22 -1
  32. package/.agent/agents/product-reviewer.md +98 -0
  33. package/.agent/agents/project-planner.md +19 -3
  34. package/.agent/agents/qa-automation-engineer.md +24 -3
  35. package/.agent/agents/resilience-reviewer.md +21 -2
  36. package/.agent/agents/schema-reviewer.md +21 -2
  37. package/.agent/agents/security-auditor.md +7 -1
  38. package/.agent/agents/seo-specialist.md +18 -3
  39. package/.agent/agents/sql-reviewer.md +22 -2
  40. package/.agent/agents/supervisor-agent.md +22 -3
  41. package/.agent/agents/swarm-worker-registry.md +7 -0
  42. package/.agent/agents/system-architect.md +19 -0
  43. package/.agent/agents/test-coverage-reviewer.md +22 -2
  44. package/.agent/agents/test-engineer.md +21 -2
  45. package/.agent/agents/throughput-optimizer.md +22 -2
  46. package/.agent/agents/type-safety-reviewer.md +21 -2
  47. package/.agent/agents/ui-ux-auditor.md +44 -242
  48. package/.agent/agents/ui-visual-auditor.md +99 -0
  49. package/.agent/agents/ux-reviewer.md +104 -0
  50. package/.agent/agents/visual-reviewer.md +98 -0
  51. package/.agent/agents/vitals-reviewer.md +23 -2
  52. package/.agent/history/README.md +53 -0
  53. package/.agent/history/case-law/cases/template-case.json +19 -0
  54. package/.agent/history/integrity_manifest.json +63 -33
  55. package/.agent/history/memory/.memory.idx +517 -1
  56. package/.agent/history/memory/MEMORY.md +35 -1
  57. package/.agent/routing_index.json +272 -690
  58. package/.agent/rules/GEMINI.md +10 -12
  59. package/.agent/rules/GEMINI_PLANNER.md +84 -0
  60. package/.agent/scripts/case_law_manager.js +2 -0
  61. package/.agent/scripts/context_broker.js +152 -0
  62. package/.agent/scripts/guardrail_engine.js +59 -4
  63. package/.agent/scripts/impact_classifier.js +167 -0
  64. package/.agent/scripts/minimal_change_engine.js +437 -0
  65. package/.agent/scripts/pipeline_engine.js +856 -0
  66. package/.agent/scripts/socratic_gate_policy.js +60 -0
  67. package/.agent/scripts/token_budget_broker.js +52 -0
  68. package/.agent/scripts/verify_all.js +13 -0
  69. package/.agent/scripts/visual_audit.js +92 -0
  70. package/.agent/skills/12-principles-of-animation/SKILL.md +19 -10
  71. package/.agent/skills/60fps-animation/SKILL.md +19 -10
  72. package/.agent/skills/accessible-animation/SKILL.md +19 -10
  73. package/.agent/skills/adapt/SKILL.md +19 -10
  74. package/.agent/skills/advanced-rag-pipelines/SKILL.md +21 -3
  75. package/.agent/skills/agent-organizer/SKILL.md +21 -7
  76. package/.agent/skills/agentic-patterns/SKILL.md +19 -7
  77. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +21 -7
  78. package/.agent/skills/animation-on-scroll/SKILL.md +19 -10
  79. package/.agent/skills/animation-systems/SKILL.md +19 -10
  80. package/.agent/skills/antfu-conventions/SKILL.md +21 -10
  81. package/.agent/skills/api-patterns/SKILL.md +21 -7
  82. package/.agent/skills/api-security-auditor/SKILL.md +21 -7
  83. package/.agent/skills/app-builder/SKILL.md +21 -7
  84. package/.agent/skills/apple-design/SKILL.md +19 -10
  85. package/.agent/skills/architecture/SKILL.md +21 -7
  86. package/.agent/skills/audit-and-fix/SKILL.md +19 -10
  87. package/.agent/skills/authentication-best-practices/SKILL.md +21 -7
  88. package/.agent/skills/backend-security-expert/SKILL.md +21 -7
  89. package/.agent/skills/baseline-ui/SKILL.md +19 -10
  90. package/.agent/skills/bash-linux/SKILL.md +21 -7
  91. package/.agent/skills/behavioral-modes/SKILL.md +19 -7
  92. package/.agent/skills/better-colors/SKILL.md +19 -10
  93. package/.agent/skills/better-ui/SKILL.md +19 -10
  94. package/.agent/skills/bolder/SKILL.md +19 -10
  95. package/.agent/skills/brainstorming/SKILL.md +17 -7
  96. package/.agent/skills/browser-native-ai/SKILL.md +19 -3
  97. package/.agent/skills/build-primitive/SKILL.md +19 -10
  98. package/.agent/skills/building-native-ui/SKILL.md +21 -7
  99. package/.agent/skills/cicd-pro/SKILL.md +21 -10
  100. package/.agent/skills/clarify/SKILL.md +19 -10
  101. package/.agent/skills/clean-code/SKILL.md +21 -7
  102. package/.agent/skills/cloud-architect/SKILL.md +21 -10
  103. package/.agent/skills/cobejs/SKILL.md +19 -10
  104. package/.agent/skills/code-review-checklist/SKILL.md +21 -7
  105. package/.agent/skills/codebase-design/SKILL.md +21 -10
  106. package/.agent/skills/colorize/SKILL.md +19 -10
  107. package/.agent/skills/compact-landing/SKILL.md +19 -10
  108. package/.agent/skills/company-logos/SKILL.md +19 -10
  109. package/.agent/skills/config-validator/SKILL.md +21 -7
  110. package/.agent/skills/containerization-pro/SKILL.md +21 -10
  111. package/.agent/skills/create-design-md/SKILL.md +19 -10
  112. package/.agent/skills/critique/SKILL.md +19 -10
  113. package/.agent/skills/csharp-developer/SKILL.md +21 -7
  114. package/.agent/skills/data-validation-schemas/SKILL.md +21 -7
  115. package/.agent/skills/database-design/SKILL.md +21 -7
  116. package/.agent/skills/delight/SKILL.md +19 -10
  117. package/.agent/skills/deployment-procedures/SKILL.md +21 -7
  118. package/.agent/skills/design-lab/SKILL.md +21 -10
  119. package/.agent/skills/devops-engineer/SKILL.md +21 -7
  120. package/.agent/skills/devops-incident-responder/SKILL.md +21 -7
  121. package/.agent/skills/diagnosing-bugs/SKILL.md +21 -10
  122. package/.agent/skills/distill/SKILL.md +19 -10
  123. package/.agent/skills/documentation-templates/SKILL.md +21 -7
  124. package/.agent/skills/domain-modeling/SKILL.md +21 -10
  125. package/.agent/skills/edge-computing/SKILL.md +21 -7
  126. package/.agent/skills/emil-design-eng/SKILL.md +19 -10
  127. package/.agent/skills/error-resilience/SKILL.md +21 -7
  128. package/.agent/skills/extract-design-system/SKILL.md +21 -7
  129. package/.agent/skills/fabel-protocol/SKILL.md +19 -2
  130. package/.agent/skills/fixing-accessibility/SKILL.md +19 -10
  131. package/.agent/skills/fixing-metadata/SKILL.md +19 -10
  132. package/.agent/skills/fixing-motion-performance/SKILL.md +19 -10
  133. package/.agent/skills/framer-motion-expert/SKILL.md +19 -6
  134. package/.agent/skills/frontend-design/SKILL.md +64 -201
  135. package/.agent/skills/frontend-security-expert/SKILL.md +21 -7
  136. package/.agent/skills/game-design-expert/SKILL.md +21 -7
  137. package/.agent/skills/game-engineering-expert/SKILL.md +21 -7
  138. package/.agent/skills/generative-ui-expert/SKILL.md +19 -3
  139. package/.agent/skills/geo-fundamentals/SKILL.md +21 -7
  140. package/.agent/skills/git-pro/SKILL.md +21 -10
  141. package/.agent/skills/github-operations/SKILL.md +21 -7
  142. package/.agent/skills/gpt-taste/SKILL.md +19 -10
  143. package/.agent/skills/gsap-core/SKILL.md +21 -4
  144. package/.agent/skills/gsap-frameworks/SKILL.md +21 -4
  145. package/.agent/skills/gsap-performance/SKILL.md +20 -5
  146. package/.agent/skills/gsap-plugins/SKILL.md +20 -5
  147. package/.agent/skills/gsap-react/SKILL.md +20 -5
  148. package/.agent/skills/gsap-scrolltrigger/SKILL.md +21 -4
  149. package/.agent/skills/gsap-timeline/SKILL.md +20 -5
  150. package/.agent/skills/gsap-utils/SKILL.md +20 -5
  151. package/.agent/skills/harden/SKILL.md +19 -10
  152. package/.agent/skills/harness-protocol/SKILL.md +20 -4
  153. package/.agent/skills/i18n-localization/SKILL.md +21 -7
  154. package/.agent/skills/impeccable/SKILL.md +19 -10
  155. package/.agent/skills/improve-codebase-architecture/SKILL.md +21 -10
  156. package/.agent/skills/improve-ui/SKILL.md +19 -10
  157. package/.agent/skills/intelligent-routing/SKILL.md +19 -7
  158. package/.agent/skills/knowledge-graph/SKILL.md +20 -4
  159. package/.agent/skills/landing-page/SKILL.md +20 -10
  160. package/.agent/skills/lint-and-validate/SKILL.md +21 -7
  161. package/.agent/skills/llm-engineering/SKILL.md +21 -7
  162. package/.agent/skills/local-first/SKILL.md +21 -7
  163. package/.agent/skills/local-first-architecture/SKILL.md +19 -10
  164. package/.agent/skills/lottie-animation/SKILL.md +19 -10
  165. package/.agent/skills/marquee-loop/SKILL.md +19 -10
  166. package/.agent/skills/masked-reveal/SKILL.md +19 -10
  167. package/.agent/skills/mcp-builder/SKILL.md +21 -7
  168. package/.agent/skills/micro-interaction/SKILL.md +19 -10
  169. package/.agent/skills/mobile-design/SKILL.md +21 -6
  170. package/.agent/skills/monorepo-management/SKILL.md +21 -7
  171. package/.agent/skills/morphing-icons/SKILL.md +19 -10
  172. package/.agent/skills/motion-engineering/SKILL.md +20 -7
  173. package/.agent/skills/nextjs-react-expert/SKILL.md +19 -7
  174. package/.agent/skills/nodejs-best-practices/SKILL.md +21 -7
  175. package/.agent/skills/observability/SKILL.md +21 -7
  176. package/.agent/skills/page-transition-animation/SKILL.md +19 -10
  177. package/.agent/skills/parallel-agents/SKILL.md +23 -7
  178. package/.agent/skills/performance-profiling/SKILL.md +21 -7
  179. package/.agent/skills/plan-writing/SKILL.md +21 -7
  180. package/.agent/skills/platform-engineer/SKILL.md +21 -7
  181. package/.agent/skills/playwright-best-practices/SKILL.md +21 -7
  182. package/.agent/skills/polish/SKILL.md +19 -10
  183. package/.agent/skills/powershell-windows/SKILL.md +21 -7
  184. package/.agent/skills/pricing-page/SKILL.md +19 -10
  185. package/.agent/skills/product-aware-heuristics/SKILL.md +358 -0
  186. package/.agent/skills/progressive-blur/SKILL.md +19 -10
  187. package/.agent/skills/project-idioms/SKILL.md +20 -8
  188. package/.agent/skills/python-patterns/SKILL.md +21 -7
  189. package/.agent/skills/python-pro/SKILL.md +21 -6
  190. package/.agent/skills/quieter/SKILL.md +19 -10
  191. package/.agent/skills/react-doctor/SKILL.md +19 -10
  192. package/.agent/skills/react-specialist/SKILL.md +19 -6
  193. package/.agent/skills/readme-builder/SKILL.md +21 -7
  194. package/.agent/skills/realtime-patterns/SKILL.md +21 -7
  195. package/.agent/skills/red-team-tactics/SKILL.md +21 -7
  196. package/.agent/skills/redesign-skill/SKILL.md +19 -10
  197. package/.agent/skills/review-animations/SKILL.md +21 -10
  198. package/.agent/skills/rust-pro/SKILL.md +21 -7
  199. package/.agent/skills/seo-fundamentals/SKILL.md +21 -7
  200. package/.agent/skills/server-management/SKILL.md +21 -7
  201. package/.agent/skills/shadcn-ui-expert/SKILL.md +21 -7
  202. package/.agent/skills/shape/SKILL.md +19 -10
  203. package/.agent/skills/skill-creator/SKILL.md +21 -7
  204. package/.agent/skills/soft-skill/SKILL.md +19 -10
  205. package/.agent/skills/sounds-on-the-web/SKILL.md +19 -10
  206. package/.agent/skills/sql-pro/SKILL.md +21 -7
  207. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +21 -7
  208. package/.agent/skills/svg-animation/SKILL.md +19 -10
  209. package/.agent/skills/swiftui-expert/SKILL.md +21 -7
  210. package/.agent/skills/swiss-design/SKILL.md +19 -10
  211. package/.agent/skills/system-design-pro/SKILL.md +21 -9
  212. package/.agent/skills/systematic-debugging/SKILL.md +21 -7
  213. package/.agent/skills/tailwind-patterns/SKILL.md +21 -7
  214. package/.agent/skills/taste-skill/SKILL.md +19 -10
  215. package/.agent/skills/tdd-workflow/SKILL.md +21 -10
  216. package/.agent/skills/test-result-analyzer/SKILL.md +18 -6
  217. package/.agent/skills/testing-patterns/SKILL.md +21 -7
  218. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +21 -10
  219. package/.agent/skills/thinking-protocol/SKILL.md +20 -8
  220. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -10
  221. package/.agent/skills/transitions-dev/SKILL.md +19 -10
  222. package/.agent/skills/trend-researcher/SKILL.md +17 -6
  223. package/.agent/skills/typescript-advanced/SKILL.md +21 -7
  224. package/.agent/skills/typeset/SKILL.md +19 -10
  225. package/.agent/skills/ui-reasoning-engine/SKILL.md +154 -0
  226. package/.agent/skills/ui-skill-packs/SKILL.md +77 -0
  227. package/.agent/skills/ui-skills-root/SKILL.md +21 -9
  228. package/.agent/skills/ui-ux-pro-max/SKILL.md +62 -583
  229. package/.agent/skills/ui-ux-researcher/SKILL.md +17 -6
  230. package/.agent/skills/vue-expert/SKILL.md +19 -6
  231. package/.agent/skills/vulnerability-scanner/SKILL.md +21 -7
  232. package/.agent/skills/web-accessibility-auditor/SKILL.md +21 -7
  233. package/.agent/skills/web-design-guidelines/SKILL.md +32 -206
  234. package/.agent/skills/web-quality-audit/SKILL.md +19 -10
  235. package/.agent/skills/webapp-testing/SKILL.md +21 -7
  236. package/.agent/skills/webgpu-performance/SKILL.md +19 -3
  237. package/.agent/skills/whimsy-injector/SKILL.md +20 -10
  238. package/.agent/skills/workflow-optimizer/SKILL.md +16 -6
  239. package/.agent/templates/DESIGN.md +292 -0
  240. package/.agent/templates/design-tokens.json +137 -0
  241. package/.agent/workflows/acf.md +13 -6
  242. package/.agent/workflows/api-tester.md +15 -8
  243. package/.agent/workflows/audit.md +19 -8
  244. package/.agent/workflows/brainstorm.md +14 -9
  245. package/.agent/workflows/changelog.md +14 -8
  246. package/.agent/workflows/create.md +16 -8
  247. package/.agent/workflows/debug.md +15 -10
  248. package/.agent/workflows/deploy.md +16 -8
  249. package/.agent/workflows/enhance.md +15 -10
  250. package/.agent/workflows/fix.md +15 -8
  251. package/.agent/workflows/generate.md +17 -11
  252. package/.agent/workflows/marathon.md +15 -8
  253. package/.agent/workflows/migrate.md +16 -8
  254. package/.agent/workflows/minimal.md +94 -0
  255. package/.agent/workflows/orchestrate.md +15 -8
  256. package/.agent/workflows/performance-benchmarker.md +15 -8
  257. package/.agent/workflows/pipeline.md +155 -0
  258. package/.agent/workflows/plan.md +14 -10
  259. package/.agent/workflows/preview.md +14 -7
  260. package/.agent/workflows/refactor.md +16 -8
  261. package/.agent/workflows/review-ai.md +15 -7
  262. package/.agent/workflows/review.md +15 -7
  263. package/.agent/workflows/session.md +14 -7
  264. package/.agent/workflows/status.md +13 -7
  265. package/.agent/workflows/strengthen-skills.md +15 -6
  266. package/.agent/workflows/super-prompt.md +19 -10
  267. package/.agent/workflows/swarm.md +15 -7
  268. package/.agent/workflows/test.md +15 -8
  269. package/.agent/workflows/tribunal-backend.md +16 -9
  270. package/.agent/workflows/tribunal-database.md +15 -8
  271. package/.agent/workflows/tribunal-frontend.md +26 -11
  272. package/.agent/workflows/tribunal-full.md +29 -14
  273. package/.agent/workflows/tribunal-mobile.md +15 -8
  274. package/.agent/workflows/tribunal-performance.md +15 -8
  275. package/.agent/workflows/tribunal-speed.md +16 -9
  276. package/.agent/workflows/tribunal-ui.md +82 -0
  277. package/.agent/workflows/ui-ux-pro-max.md +51 -107
  278. package/CONTRIBUTING.md +2 -2
  279. package/README.md +5 -5
  280. package/bin/mcp-server.js +81 -31
  281. package/bin/wrapper.js +17 -6
  282. package/dist/cli.js +9 -1
  283. package/dist/commands/compile.js +7 -0
  284. package/dist/commands/context.js +8 -3
  285. package/dist/commands/graph.js +8 -2
  286. package/dist/commands/init.js +13 -2
  287. package/dist/commands/memory.js +119 -68
  288. package/dist/commands/minimal.js +71 -0
  289. package/dist/commands/optimize.js +15 -5
  290. package/dist/esm/index.mjs +26 -32
  291. package/dist/utils/fs.js +10 -4
  292. package/dist/utils/helpers.js +10 -1
  293. package/dist/utils/version.js +9 -2
  294. package/mcp_config.json +10 -1
  295. package/package.json +17 -14
  296. package/scripts/benchmark.js +16 -0
  297. package/scripts/sync-version.js +1 -1
  298. package/scripts/visual_audit.js +126 -0
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: improve-ui
3
3
  description: Audit an existing product surface against its own design evidence, identify verified UI problems, and write self-contained implementation plans for another agent. Strictly read-only on product source. Use when asked to review, refine, improve, or clean up an interface without replacing its identity.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: UI Craft & Design Audit
9
- tier: master
10
- co-requires: [better-ui, baseline-ui]
11
- trigger-signals:
12
- strong: [improve-ui, audit interface, refine UI, UI review, design-system drift, UI cleanup plan]
13
- weak: [review layout, UI feedback]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - better-ui
8
+ - baseline-ui
9
+ - create-design-md
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Improve UI — Evidence-Based UI Audit & Implementation Planning
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before auditing UI surfaces or writing remediation plans, you MUST inspect:
23
+ 1. Read-Only Constraint (Section 24) → Strictly NEVER modify product source code (`src/`, `components/`, `app/`) during an `improve-ui` audit session
24
+ 2. 3-Proof Requirement (Section 40) → Every reported defect MUST present Observation (code line/element), Basis (token/grid violation), and Consequence
25
+ 3. Plan Artifact Output (Section 25) → Write implementation plans to `design-plans/` or output structured markdown for execution
26
+
18
27
  Audit a specific product surface against its governing design tokens and guidelines, identify verified UI defects, and generate self-contained implementation plans for remediation.
19
28
 
20
29
  ---
@@ -1,15 +1,27 @@
1
1
  ---
2
2
  name: intelligent-routing
3
3
  description: LLM Intent Processing and Gateway Routing mastery. Request classification hierarchies, function routing, confidence scoring, fallback cascades, zero-shot vs few-shot classification patterns, and identifying specialized skills for delegation. Use when parsing raw user input to determine the architectural path of execution.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 4.0.0
6
- last-updated: 2026-06-21
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: meta
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - fabel-protocol
9
+ - agentic-patterns
10
+ - behavioral-modes
11
+ scripts-binding:
12
+ - .agent/scripts/compile_router.py
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Intelligent Routing v4 — Self-Describing Skill Graph
17
+
18
+ ## Mandatory Pre-Flight Context Inspection
19
+
20
+ Before routing user prompts to specialized skills or agents, you MUST inspect:
21
+ 1. `.agent/routing_index.json` → Read pre-compiled skill index instead of loading full skill markdown files into context
22
+ 2. Semantic Intent Schema (Section 1) → Classify request type (QUESTION, SURVEY, SIMPLE_EDIT, COMPLEX_BUILD, SECURITY_AUDIT, UNCLEAR_GIBBERISH)
23
+ 3. Confidence Threshold (Section 3 Socratic Yield Rule) → Yield back to user with clarifying question if confidence score is < 85s
24
+
13
25
  ## Hallucination Traps (Read First)
14
26
 
15
27
  - ❌ Routing based on exact keyword matching -> ✅ Use intent classification with confidence scores; keywords miss synonyms and context
@@ -1,14 +1,30 @@
1
1
  ---
2
- name: Knowledge Graph Analyzer
2
+ name: knowledge-graph
3
3
  description: Understands the architecture, risk blast radius, and dependencies of the codebase without token bloat. Now includes Context Snapshots for 27x token reduction.
4
4
  version: 3.0.0
5
- routing:
6
- domain: general
7
- tier: basic
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - codebase-design
8
+ - architecture
9
+ - fabel-protocol
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/graph_builder.js
13
+ - .agent/scripts/graph_zoom.js
14
+ - .agent/scripts/verify_all.js
8
15
  ---
9
16
 
10
17
  # /graph — Knowledge Graph Skill v3.0
11
18
 
19
+ ---
20
+
21
+ ## Mandatory Pre-Flight Context Inspection
22
+
23
+ Before inspecting codebase architecture, you MUST inspect:
24
+ 1. Context Snapshots (`.agent/history/snapshots/`) → Read pre-computed JSON snapshots to reduce token overhead by 27x
25
+ 2. `graph_builder.js` output → Check downstream dependencies, risk scores, and blast radius before modifying any file
26
+ 3. Module boundaries → Identify top imported symbols and high-risk core modules
27
+
12
28
  Use this skill when the user types `/graph` or when you need to deeply understand the architecture of an unfamiliar codebase without suffering from context-window bloat.
13
29
 
14
30
  ## The Token Reduction Protocol (Option C)
@@ -1,20 +1,30 @@
1
1
  ---
2
2
  name: landing-page
3
3
  description: High-converting landing page structure, hero section layout variance, CTA hierarchy, visual pacing, feature grid storytelling, and social proof placement.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Landing Page Architecture & Conversion
9
- tier: pro
10
- co-requires: [compact-landing, company-logos, pricing-page, frontend-design]
11
- trigger-signals:
12
- strong: [landing-page, hero section, CTA hierarchy, conversion landing page, SaaS landing page, feature grid storytelling]
13
- weak: [homepage design, marketing page]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - compact-landing
8
+ - company-logos
9
+ - pricing-page
10
+ - baseline-ui
11
+ tools: Read, Grep, Glob, Bash, Edit, Write
12
+ scripts-binding:
13
+ - .agent/scripts/lint_runner.js
14
+ - .agent/scripts/verify_all.js
14
15
  ---
15
16
 
16
17
  # Landing Page — Conversion Architecture & Visual Pacing
17
18
 
19
+ ---
20
+
21
+ ## Mandatory Pre-Flight Context Inspection
22
+
23
+ Before engineering full landing pages, you MUST inspect:
24
+ 1. Hero Layout Model (Section 50) → Choose appropriate layout variance model (Model A Centered Stacked, Model B Asymmetric Split, Model C Full-Bleed Canvas)
25
+ 2. CTA Hierarchy (Section 32) → Ensure exactly ONE primary solid accent button above the fold; pair only with a secondary ghost button
26
+ 3. Blueprint Rhythm (Section 22) → Follow the 6-section blueprint (Nav, Hero, Social Proof, Features, Testimonials, Final CTA)
27
+
18
28
  Build high-converting, visually stunning landing pages that guide visitors from curiosity to conversion.
19
29
 
20
30
  ---
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: lint-and-validate
3
3
  description: Linting and validation principles for code quality enforcement.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 1.0.0
6
- last-updated: 2026-03-12
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - clean-code
9
+ - config-validator
10
+ - code-review-checklist
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Linting & Validation
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before running linting tools or modifying linter rules, you MUST inspect:
23
+ 1. Zero-Warning CI Blocking (Section 34) → Enforce zero-warning policy in CI pipelines; ban treating lint warnings as non-blocking
24
+ 2. Mandatory Strict Type Checks (Section 121) → Run static type checking (`tsc --noEmit` or `mypy`) alongside linters to catch non-linter type bugs
25
+ 3. Diff Review Before Auto-Fixing (Section 15) → Review diffs explicitly after auto-fixing (`eslint --fix`) to prevent accidental removal of side-effect code
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Auto-fixing lint errors without reviewing the diff -> ✅ Some auto-fixes change logic (e.g., removing 'unused' variables that are side-effects)
@@ -1,19 +1,33 @@
1
1
  ---
2
2
  name: llm-engineering
3
3
  description: LLM engineering mastery for production AI systems. Prompt engineering, RAG pipeline design, vector store selection, embedding strategies, chunking, reranking, structured output, function calling, streaming, evals, guard-rails, cost optimization, and LLMOps. Use when building AI features, chat interfaces, semantic search, or any system calling an LLM API.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 3.2.0
6
- last-updated: 2026-04-07
7
- applies-to-model: gemini-3-1-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - ai-prompt-injection-defense
9
+ - advanced-rag-pipelines
10
+ - data-validation-schemas
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
13
16
  # LLM Engineering — Production AI Systems Mastery
14
17
 
15
18
  ---
16
19
 
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before engineering LLM integrations or tool calling loops, you MUST inspect:
23
+ 1. Zod Schema Validation on JSON Outputs (Section 115) → Always run Zod validation (`Schema.parse(...)`) on LLM JSON responses, even in strict mode
24
+ 2. Hybrid Vector + Keyword Search (Section 290) → Use hybrid vector + BM25 keyword search in RAG applications to prevent missing exact identifiers
25
+ 3. System Prompt Secret Isolation (Section 69) → Never put private API keys, database credentials, or secret internal URLs into system prompts
26
+
27
+ # LLM Engineering — Production AI Systems Mastery
28
+
29
+ ---
30
+
17
31
  ## Model Selection
18
32
 
19
33
  ```
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: local-first
3
3
  description: Local-first software architecture mastery. CRDTs (Conflict-free Replicated Data Types), IndexedDB synchronization, sync engines (ElectricSQL, Replicache, PowerSync), offline-capable data fetching, optimistic UI, and SQLite in the browser (WASM). Use when building PWA offline capabilities, rapid UIs, or multiplayer collaborative tools.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-02
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - local-first-architecture
9
+ - react-specialist
10
+ - baseline-ui
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Local-First Architecture — Offline-capable Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before implementing local-first storage or CRDT synchronization, you MUST inspect:
23
+ 1. Conflict Resolution Strategy (Section 15) → Define explicit conflict resolution (LWW timestamps or Yjs CRDTs) before writing local sync logic
24
+ 2. Persistent Storage (Section 16) → Use IndexedDB (via Dexie/idb) or SQLite WASM for local persistence; ban localStorage for >5MB data
25
+ 3. Incremental Watermark Sync (Section 17) → Perform delta syncs using timestamps/watermarks rather than re-fetching full datasets
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Assuming server data is always newer than local data -> ✅ Conflicts are inevitable; design merge strategy (LWW, CRDTs) before writing code
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: local-first-architecture
3
3
  description: Local-first architecture guidance for instant-feeling web & desktop apps, optimistic updates, IndexedDB sync engines, offline operation, and Conflict-free Replicated Data Types (CRDTs).
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Local-First Architecture & Sync Engines
9
- tier: pro
10
- co-requires: [local-first, realtime-patterns, architecture]
11
- trigger-signals:
12
- strong: [local-first-architecture, Linear architecture, optimistic updates, IndexedDB sync, CRDT, offline-first app, zero-latency UI]
13
- weak: [offline sync, optimistic state]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - react-specialist
8
+ - nextjs-react-expert
9
+ - baseline-ui
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Local-First Architecture — Instant UI & Sync Engines
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before implementing local-first architecture or offline sync engines, you MUST inspect:
23
+ 1. Zero Network Latency Rule (Section 24) → Execute reads and writes against local storage (IndexedDB/SQLite) first before queueing outbound sync
24
+ 2. Outbound Mutation Queue (Section 28) → Persist mutation logs in IndexedDB with client-generated UUID `idempotencyKey` fields
25
+ 3. Conflict Resolution Strategy (Section 33) → Use Last-Write-Wins (LWW) for simple fields or CRDTs (Yjs/Automerge) for collaborative state
26
+
18
27
  Architect software that reads and writes to local storage (SQLite/IndexedDB) first, ensuring instant zero-latency UI mutations with background server synchronization.
19
28
 
20
29
  ---
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: lottie-animation
3
3
  description: Lottie and dotLottie integration, playback control, hover/click triggers, runtime theming, and performance optimization for React/Vue/Web.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Vector Animation & Lottie Integration
9
- tier: pro
10
- co-requires: [60fps-animation, text-to-lottie]
11
- trigger-signals:
12
- strong: [lottie-animation, dotLottie, Lottie React, Lottie playback, vector animation JSON]
13
- weak: [lottie, json animation]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - 60fps-animation
8
+ - motion-engineering
9
+ - micro-interaction
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Lottie Animation — dotLottie & Runtime Control
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before integrating Lottie animations, you MUST inspect:
23
+ 1. Asset Format (.lottie vs .json) → Prefer compressed `.lottie` (dotLottie) assets for 80% smaller bundle file sizes
24
+ 2. Playback Triggers (Section 34) → Bind playback to user hover/click or viewport intersection instead of aggressive continuous looping
25
+ 3. Package Manifest (`package.json`) → Verify `@dotlottie/react-player` or `lottie-web` library dependencies
26
+
18
27
  Integrate lightweight, vector-based Lottie animations with interactive trigger controls and runtime color theming.
19
28
 
20
29
  ---
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: marquee-loop
3
3
  description: Hardware-accelerated, seamless, continuous looping marquees for logo rows, testimonials, and announcements with pause-on-hover accessibility.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Ticker & Continuous Motion
9
- tier: pro
10
- co-requires: [60fps-animation, company-logos]
11
- trigger-signals:
12
- strong: [marquee-loop, marquee animation, continuous ticker, looping logo track, seamless marquee]
13
- weak: [scrolling logos, ticker]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - 60fps-animation
8
+ - company-logos
9
+ - accessible-animation
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Marquee Loop — Hardware-Accelerated Continuous Tickers
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before implementing marquee loop tracks, you MUST inspect:
23
+ 1. DOM Structure (Section 24) → Duplicate item tracks MUST be rendered with `aria-hidden="true"` to prevent screen reader redundancy
24
+ 2. Hover Accessibility (Section 50) → Enforce `animation-play-state: paused` on `:hover` and `:focus-within`
25
+ 3. Reduced Motion Fallback (Section 61) → Collapse marquee into static wrapped flex grid when `prefers-reduced-motion: reduce` is active
26
+
18
27
  Build seamless 60fps infinite marquee tracks that pause on hover and respect accessibility settings.
19
28
 
20
29
  ---
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: masked-reveal
3
3
  description: CSS clip-path, SVG masking, and layered entrance reveals for images, hero banners, and text blocks.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Visual Masking & Entrance Motion
9
- tier: pro
10
- co-requires: [60fps-animation, framer-motion-expert]
11
- trigger-signals:
12
- strong: [masked-reveal, clip-path reveal, SVG mask animation, curtain reveal, text mask reveal]
13
- weak: [mask effect, clip path animation]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - 60fps-animation
8
+ - framer-motion-expert
9
+ - motion-engineering
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Masked Reveal — Clip-Path & Layered Entrances
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before implementing clip-path or SVG mask reveals, you MUST inspect:
23
+ 1. Target DOM elements → Enforce `overflow: hidden` on text line wrappers to prevent unmasked overflow artifacts
24
+ 2. `clip-path: inset()` syntax (Section 26) → Prefer CSS `clip-path` over heavy SVG masks for linear curtain wipes
25
+ 3. Transition Easing → Use custom ease-out curves (`cubic-bezier(0.16, 1, 0.3, 1)`) for smooth deceleration
26
+
18
27
  Create editorial, high-end visual reveals using CSS `clip-path` and SVG masks.
19
28
 
20
29
  ---
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: mcp-builder
3
3
  description: Model Context Protocol (MCP) server integration mastery. Building custom MCP servers, standardizing tool exposes, managing standardized communication between large language models and localized datasets, securing boundary contexts, and architecting resource schemas. Use when modifying, extending, or building custom toolsets for AI platforms relying on the MCP standard.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-02
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - backend-security-expert
9
+ - nodejs-best-practices
10
+ - agentic-patterns
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # MCP Builder — Context Protocol Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before architecting MCP tools or resource handlers, you MUST inspect:
23
+ 1. Strict Zod Input Validation (Section 45) → Enforce explicit JSON Schema parameter validation (Zod) for every tool exposed to the LLM
24
+ 2. Resource vs Tool Distinction (Section 68) → Use Resources for static read-only data (`file:///`, `db://schema`), Tools strictly for dynamic parameterized actions
25
+ 3. Output Payload Truncation Safeguard (Section 94) → Forcibly truncate large tool response outputs before returning payload to protect LLM context windows
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Exposing tools without input validation schemas -> ✅ Every MCP tool MUST have JSON Schema for parameters; the protocol requires it
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: micro-interaction
3
3
  description: Detailed UI motion guidance for hover and press feedback, toggles, checkboxes, toasts, drawers, modals, list transitions, and shared-element interactions.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Micro-Interactions & Component Tactility
9
- tier: pro
10
- co-requires: [delight, emil-design-eng, better-ui]
11
- trigger-signals:
12
- strong: [micro-interaction, button press feedback, toggle motion, checkbox animation, toast entrance, drawer interaction]
13
- weak: [interactive feedback, hover state animation]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - delight
8
+ - better-ui
9
+ - 60fps-animation
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Micro-Interaction — Component Motion & Tactile Feedback
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before engineering component micro-interactions, you MUST inspect:
23
+ 1. Duration Caps → Keep interactive component feedback (press/hover/toggle) under 180ms
24
+ 2. Popover Origin Rules (Section 60) → Set `transform-origin` dynamically to match trigger button position
25
+ 3. SVG Path Draw-on (Section 48) → Use `stroke-dashoffset` transitions for checkboxes and toggle icons
26
+
18
27
  Craft responsive, physically grounded micro-interactions for everyday UI controls.
19
28
 
20
29
  ---
@@ -1,16 +1,31 @@
1
1
  ---
2
2
  name: mobile-design
3
3
  description: Mobile-first design for iOS, Android, Foldables, React Native, Flutter. Touch interaction, haptics, 120Hz performance, on-device AI, spatial UI, Reanimated 3. Use when building mobile UI, animations, or cross-platform apps.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 3.1.0
6
- last-updated: 2026-04-06
7
- routing:
8
- domain: general
9
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - building-native-ui
9
+ - adapt
10
+ - 60fps-animation
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
10
14
  ---
11
15
 
12
16
  # Mobile Design — Dense Reference
13
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before designing mobile interfaces or writing React Native code, you MUST inspect:
23
+ 1. Reanimated 3 & Worklet Rules (Section 47) → Execute animations on the UI thread using Reanimated 3 worklets; ban legacy `Animated.View`
24
+ 2. List Optimization (Section 32) → Use `@shopify/flash-list` with required `estimatedItemSize` instead of `ScrollView` or `FlatList`
25
+ 3. Safe Area Insets (Section 100) → Always wrap content with `useSafeAreaInsets()` to accommodate notch, dynamic island, and home indicators
26
+
27
+ # Mobile Design — Dense Reference
28
+
14
29
  ## Hallucination Traps (Read First)
15
30
 
16
31
  - ❌ `Animated.View` for any animation → ✅ `Reanimated 3` worklets (Animated API is legacy, runs on JS thread)
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: monorepo-management
3
3
  description: Monorepo architecture and tooling mastery. Turborepo, Nx, pnpm workspaces, shared package design, task pipelines, dependency hoisting, change detection, versioning strategies (independent vs. fixed), shared TypeScript configs, internal packages, and CI optimization for monorepos. Use when setting up monorepos, managing shared code across apps, or optimizing build pipelines.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 1.0.0
6
- last-updated: 2026-04-17
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - cicd-pro
9
+ - codebase-design
10
+ - lint-and-validate
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Monorepo Management — Scaling Multi-Package Projects
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before organizing workspace packages or writing Turborepo/pnpm configs, you MUST inspect:
23
+ 1. Internal Package Protocol (Section 128) → Reference internal monorepo dependencies via `"workspace:*"` protocol and mark them `"private": true`
24
+ 2. Topological Task Dependencies (Section 146) → Define topological ordering (`"^build"`) in `turbo.json` to ensure dependencies build before consumers
25
+ 3. Domain-Focused Package Partitioning (Section 261) → Divide shared code into domain packages (`packages/ui`, `packages/db`, `packages/utils`); ban single monolithic `packages/shared` dumpsters
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Publishing internal packages to npm when they're meant to stay private -> ✅ Internal packages use `"private": true` and workspace protocol `"workspace:*"`
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: morphing-icons
3
3
  description: Build morphing SVG icon components that transition smoothly between states (Play <-> Pause, Hamburger Menu <-> Close X, Sun <-> Moon).
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Interactive Vector Icons & State Morphing
9
- tier: pro
10
- co-requires: [svg-animation, micro-interaction]
11
- trigger-signals:
12
- strong: [morphing-icons, morphing SVG icon, menu to close icon, play to pause icon, animated icon morph]
13
- weak: [icon transition, animated icon]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - svg-animation
8
+ - micro-interaction
9
+ - 60fps-animation
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Morphing Icons — Interactive State-Morphing Vector Icons
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before implementing morphing icon components, you MUST inspect:
23
+ 1. Target states (e.g. Hamburger Menu <-> Close X, Play <-> Pause) → Verify matching SVG path point count and coordinate bounds
24
+ 2. Accessibility (Section 65) → Ensure `aria-label` updates dynamically alongside state changes
25
+ 3. Interpolation Curves → Use snappy ease-out curves (`cubic-bezier(0.16, 1, 0.3, 1)`) with duration $\le 200\text{ms}$
26
+
18
27
  Architect crisp, interactive SVG icon components that morph seamlessly between operational states.
19
28
 
20
29
  ---