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,17 +1,30 @@
1
1
  ---
2
2
  name: motion-engineering
3
3
  description: Motion Engineering mastery for 2026 web UI. Covers all 20 modern animation styles across 4 tiers (Core UX, Immersive, Advanced, Specialized). Use when designing motion strategy, choosing animation libraries (Framer, GSAP, WebGL, CSS), or implementing animated UI patterns.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 4.0.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
+ - 60fps-animation
9
+ - accessible-animation
10
+ - framer-motion-expert
11
+ - gsap-react
12
+ scripts-binding:
13
+ - .agent/scripts/lint_runner.js
14
+ - .agent/scripts/verify_all.js
11
15
  ---
12
16
 
13
17
  # Motion Engineering (2026) — Comprehensive Reference
14
18
 
19
+ ---
20
+
21
+ ## Mandatory Pre-Flight Context Inspection
22
+
23
+ Before engineering web animations or selecting motion libraries, you MUST inspect:
24
+ 1. Master Library Decision Matrix (Section 29) → Select appropriate library (Framer Motion, GSAP, View Transitions API, Lottie) based on interaction category
25
+ 2. 120fps GPU Compositing Rule (Section 181) → Restrict animations strictly to `transform` and `opacity` to avoid layout thrashing
26
+ 3. Accessibility & `prefers-reduced-motion` (Section 158) → Ensure fallback to instant opacity or no-op motion for reduced-motion preference
27
+
15
28
  You are the Motion Engineering Specialist. Your purpose is to bridge the gap between static UI and fluid, intuitive, and high-performance digital experiences. You understand that motion is not decoration; it is usability, narrative, and state communication.
16
29
 
17
30
  ## Hallucination Traps & Motion Sins (Read First)
@@ -1,17 +1,29 @@
1
1
  ---
2
2
  name: nextjs-react-expert
3
3
  description: Next.js 15+ App Router mastery. Server Components, Server Actions, PPR, caching, metadata, middleware, parallel/intercepting routes. Use when building Next.js apps or optimizing Next.js performance.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 3.1.0
6
- last-updated: 2026-04-06
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
+ - react-specialist
9
+ - react-doctor
10
+ - baseline-ui
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
13
16
  # Next.js 15+ App Router — Dense Reference
14
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before engineering Next.js 15+ App Router code, you MUST inspect:
23
+ 1. Client Boundary rules (`"use client"` vs Server Components) → Use Server Components by default; add `"use client"` only for interactivity/hooks
24
+ 2. Server Actions Validation (Section 68) → Always include `"use server"` and validate form inputs with Zod (`Schema.safeParse`)
25
+ 3. Next.js 15 Caching & Dynamic APIs (Section 106) → `fetch()` is UNCACHED by default in Next.js 15; `cookies()` and `headers()` are `async`
26
+
15
27
  ## Hallucination Traps (Read First)
16
28
 
17
29
  - ❌ `pages/api/` or `_app.tsx` → ✅ App Router only: `app/api/route.ts`, `app/layout.tsx`
@@ -1,19 +1,33 @@
1
1
  ---
2
2
  name: nodejs-best-practices
3
3
  description: Node.js 22+ production mastery. ES Modules, async patterns, Express/Fastify/Hono, middleware architecture, error handling, streaming, worker threads, environment config, security hardening, process management, and deployment patterns. Use when building Node.js servers, APIs, CLI tools, or any server-side JavaScript.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-01
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
+ - api-patterns
10
+ - clean-code
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
13
16
  # Node.js Best Practices — Node 22+ Production Mastery
14
17
 
15
18
  ---
16
19
 
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before building Node.js services or middleware, you MUST inspect:
23
+ 1. Node Built-in Import Protocol (Section 34) → Use explicit `node:` prefix (`import fs from "node:fs/promises"`); ban legacy CommonJS `require()`
24
+ 2. Mandatory Process Exit on Uncaught Exception (Section 170) → Ensure process exits (`process.exit(1)`) after `uncaughtException` to prevent running in corrupted state
25
+ 3. Startup Environment Validation (Section 373) → Validate environment variables at app startup with Zod; crash immediately if required secrets are missing
26
+
27
+ # Node.js Best Practices — Node 22+ Production Mastery
28
+
29
+ ---
30
+
17
31
  ## ES Modules (Mandatory)
18
32
 
19
33
  ```json
@@ -1,19 +1,33 @@
1
1
  ---
2
2
  name: observability
3
3
  description: Production observability mastery. Structured logging (Pino/Winston), OpenTelemetry tracing, metrics (Prometheus/Grafana), SLIs/SLOs/error budgets, distributed tracing, alerting design, health checks, and AI observability. Use when setting up monitoring, debugging production issues, or designing observable distributed systems.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-01
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
+ - devops-incident-responder
9
+ - nodejs-best-practices
10
+ - backend-security-expert
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
13
16
  # Observability — Production Monitoring Mastery
14
17
 
15
18
  ---
16
19
 
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before instrumenting applications for observability, you MUST inspect:
23
+ 1. Structured JSON Logging Rule (Section 34) → Use Pino/structlog for structured JSON logging with ISO timestamps; ban plain `console.log` in production
24
+ 2. Separation of Liveness & Readiness Checks (Section 253) → Isolate `/health/live` (process active) from `/health/ready` (DB connected); ban DB calls in liveness checks to prevent restart loops
25
+ 3. Correlation Tracking Context (Section 80) → Inject `x-request-id` via AsyncLocalStorage or middleware so every log line is correlated to a specific request
26
+
27
+ # Observability — Production Monitoring Mastery
28
+
29
+ ---
30
+
17
31
  ## The Three Pillars
18
32
 
19
33
  ```
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: page-transition-animation
3
3
  description: Page and route transition patterns using the native View Transitions API, Framer Motion AnimatePresence, and Next.js App Router exit animations.
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: Route Transitions & Navigation Motion
9
- tier: pro
10
- co-requires: [framer-motion-expert, 60fps-animation]
11
- trigger-signals:
12
- strong: [page-transition-animation, View Transitions API, page transition, route transition, Next.js exit animation, shared element transition]
13
- weak: [route animation, page animation]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - framer-motion-expert
8
+ - 60fps-animation
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
  # Page Transition Animation — Native & Framework Route Motion
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before engineering route or page transitions, you MUST inspect:
23
+ 1. Target Framework & API (View Transitions API vs Framer Motion `AnimatePresence`)
24
+ 2. `AnimatePresence` Keying (Section 69) → Enforce `key={pathname}` and `mode="wait"` to prevent double-page DOM stacking
25
+ 3. Vertical Displacement Cap → Keep route movement under $12\text{px}$ to prevent visual scroll shifts
26
+
18
27
  Architect smooth, seamless page and route transitions without layout jumps or frozen exit states.
19
28
 
20
29
  ---
@@ -1,13 +1,29 @@
1
1
  ---
2
2
  name: parallel-agents
3
3
  description: Parallel processing coordination for multi-agent swarms. Asynchronous dispatches, merging divergent logic streams, race conditions in autonomous agents, avoiding Git conflicts in concurrent generation, and fan-out/fan-in processing patterns. Use when orchestrating multiple agents simultaneously.
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
+ - agent-organizer
9
+ - fabel-protocol
10
+ - workflow-optimizer
11
+ scripts-binding:
12
+ - .agent/scripts/swarm_dispatcher.js
13
+ - .agent/scripts/verify_all.js
14
+ ---
15
+
16
+ # Parallel Agents — Concurrent Orchestration Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before executing parallel agent dispatches, you MUST inspect:
23
+ 1. Target file paths for concurrent workers → Enforce directory isolation; never allow two parallel workers to edit the same file
24
+ 2. `Promise.allSettled()` error handling (Section 77) → Handle partial worker failures gracefully without crashing the pipeline
25
+ 3. Context Window Budget → Keep total context across all parallel workers under 80,000 tokens
26
+
11
27
  ---
12
28
 
13
29
  ## Hallucination Traps (Read First)
@@ -1,19 +1,33 @@
1
1
  ---
2
2
  name: performance-profiling
3
3
  description: Performance profiling mastery. Core Web Vitals (LCP, CLS, INP), Lighthouse auditing, JavaScript profiling, React rendering optimization, bundle analysis, memory leak detection, database query profiling (EXPLAIN ANALYZE), load testing, and performance budgets. Use when optimizing performance, debugging slow pages, or establishing performance standards.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-01
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
+ - 60fps-animation
9
+ - gsap-performance
10
+ - web-quality-audit
11
+ scripts-binding:
12
+ - .agent/scripts/bundle_analyzer.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
13
16
  # Performance Profiling — Measurement-Driven Optimization
14
17
 
15
18
  ---
16
19
 
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before optimizing performance or auditing benchmarks, you MUST inspect:
23
+ 1. Core Web Vitals Targets (INP replacing FID) (Section 26) → Target INP $\le 200\text{ms}$, LCP $\le 2.5\text{s}$, CLS $\le 0.1$; ban FID (deprecated)
24
+ 2. Bundle Size Limits & Import Tree-Shaking (Section 55) → Enforce total gzipped JS $<200\text{KB}$; use deep imports (`lodash/debounce`) instead of full barrel imports
25
+ 3. SQL EXPLAIN ANALYZE Requirement (Section 156) → Profile database queries with `EXPLAIN ANALYZE` before making index or query optimization changes
26
+
27
+ # Performance Profiling — Measurement-Driven Optimization
28
+
29
+ ---
30
+
17
31
  ## Core Web Vitals
18
32
 
19
33
  ```
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: plan-writing
3
3
  description: Technical design and implementation planning mastery. Writing structured execution checklists, dependency mapping, establishing rollback protocols, segmenting monolithic tasks, writing ADRs (Architecture Decision Records), and defining verification criteria. Use when transitioning from ideation to coordinated execution.
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
+ - project-planner
9
+ - brainstorming
10
+ - harness-protocol
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Plan Writing — Execution Blueprints Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before writing implementation plans or execution blueprints, you MUST inspect:
23
+ 1. Verification Criteria Requirement (Section 15) → Include explicit "How to verify" criteria for every wave; ban plan steps without verification
24
+ 2. Phased Wave Segmentation (Section 41) → Segment multi-file tasks into testable, independent waves (Wave 1: Data, Wave 2: API, Wave 3: UI)
25
+ 3. Non-Destructive Defaults & Rollback Rules (Section 66) → Define fallback feature toggles and database rollback procedures prior to execution
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Writing plans without verification criteria -> ✅ Every plan needs a 'How to verify this worked' section
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: platform-engineer
3
3
  description: Platform Engineering and Internal Developer Portal (IDP) mastery. Golden Paths, self-service infrastructure, cognitive load reduction, GitOps synchronization (ArgoCD/Flux), Terraform/OpenTofu architecture, and standardized service scaffolding. Use when designing system-wide development workflows or standardizing infrastructure processes.
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
+ - cloud-architect
9
+ - devops-engineer
10
+ - cicd-pro
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Platform Engineering — Developer Experience Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before designing developer platforms or GitOps manifests, you MUST inspect:
23
+ 1. Golden Path Self-Service Rule (Section 29) → Build pre-approved automated templates for bootstrapping services (CI, metrics, DB Terraform out-of-the-box)
24
+ 2. GitOps Continuous Reconciliation (Section 48) → Enforce declarative GitOps (`selfHeal: true`) via ArgoCD/Flux; ban manual `kubectl apply` or console modifications
25
+ 3. Higher-Level Terraform Modules (Section 76) → Encapsulate complex IaC logic into simple interface modules (`capacity`, `needs_replica`) to reduce cognitive load
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Building internal platforms without talking to developers -> ✅ Platform engineering exists to reduce developer cognitive load; ask them what hurts
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: playwright-best-practices
3
3
  description: Playwright End-to-End (E2E) testing mastery. Resilient selectors, auto-waiting mechanisms, parallel test execution, mocking network requests, fixture management, and cross-browser CI configurations. Use when configuring, deploying, or writing E2E web tests.
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
+ - testing-patterns
9
+ - webapp-testing
10
+ - qa-automation-engineer
11
+ scripts-binding:
12
+ - .agent/scripts/test_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Playwright E2E — Bulletproof Testing Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before writing Playwright E2E tests or test fixtures, you MUST inspect:
23
+ 1. Auto-Waiting & Resilient Selectors (Section 26) → Use `getByRole()`, `getByLabel()` or `getByTestId()`; ban `page.waitForTimeout()` and CSS layout paths
24
+ 2. Complete Test Isolation Rule (Section 53) → Isolate every test in fresh browser context; ban cascading tests dependent on previous test outcomes
25
+ 3. External Network Interception (Section 86) → Intercept 3rd party external APIs (`page.route()`) to eliminate flaky network failures in CI
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Using `page.waitForTimeout(3000)` for synchronization -> ✅ Use `page.waitForSelector()`, `expect(locator).toBeVisible()`, or auto-waiting locators
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: polish
3
3
  description: Final production quality pass for spacing, alignment, visual rhythm, dark mode consistency, and edge states. Use before shipping or merging a feature to ensure 100% UI fidelity.
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: Pre-Ship Quality Audit
9
- tier: pro
10
- co-requires: [better-ui, harden, fixing-accessibility]
11
- trigger-signals:
12
- strong: [polish, pre-ship pass, final UI pass, ship check, interface quality check]
13
- weak: [double check ui, final touch]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - better-ui
8
+ - harden
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
  # Polish — Final Pre-Ship UI Quality Pass
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before running a pre-ship quality pass, you MUST inspect:
23
+ 1. Target component / view state → Test across light and dark theme modes
24
+ 2. The 10-Point Polish Checklist (Section 22) → Audit 8px grid alignment, tabular numbers, focus rings, press feedback, and CLS loading skeletons
25
+ 3. Edge case string truncation → Test long user input strings with `truncate` or `line-clamp` boundaries
26
+
18
27
  The comprehensive pre-ship inspection checklist to verify that code meets top-tier design-engineering standards.
19
28
 
20
29
  ---
@@ -1,19 +1,33 @@
1
1
  ---
2
2
  name: powershell-windows
3
3
  description: PowerShell and Windows environment mastery. Object-oriented piping, strict error handling (ErrorActionPreference), PSProviders, active directory querying, credential management, and execution policies. Use when automating Azure, Windows environments, or writing .ps1 scripts.
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
+ - server-management
9
+ - devops-engineer
10
+ - bash-linux
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
13
16
  # PowerShell — Windows Automation Mastery
14
17
 
15
18
  ---
16
19
 
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before writing PowerShell `.ps1` scripts or Windows automation commands, you MUST inspect:
23
+ 1. Object Pipeline vs String Parsing Rule (Section 23) → Operate directly on .NET object properties (`Get-Process | Stop-Process`); ban string splitting/parsing
24
+ 2. Mandatory Script Strict Mode Header (Section 43) → Always declare `$ErrorActionPreference = "Stop"` and `Set-StrictMode -Version Latest` at top of automation scripts
25
+ 3. Process-Scoped Execution Policy Bypass (Section 68) → Use process-level policy override (`powershell.exe -ExecutionPolicy Bypass -File ...`); ban system-wide `Set-ExecutionPolicy Unrestricted`
26
+
27
+ # PowerShell — Windows Automation Mastery
28
+
29
+ ---
30
+
17
31
  ## 1. The Object Pipeline
18
32
 
19
33
  Unlike Bash where everything is strings (requiring `awk`/`grep`), PowerShell passes structured .NET class instances between commands.
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: pricing-page
3
3
  description: SaaS pricing table architecture, billing cycle toggles (Monthly/Annual), feature comparison matrices, tier highlighting, and conversion optimization.
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: Pricing Architecture & SaaS Conversion
9
- tier: pro
10
- co-requires: [landing-page, frontend-design]
11
- trigger-signals:
12
- strong: [pricing-page, pricing table, billing toggle, tier comparison, popular tier highlight, SaaS pricing]
13
- weak: [pricing UI, plan table]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - landing-page
8
+ - compact-landing
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
  # Pricing Page — SaaS Pricing Architecture & Comparison Grids
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before engineering SaaS pricing pages or comparison tables, you MUST inspect:
23
+ 1. Tabular Price Numbers (Section 27) → Apply `font-variant-numeric: tabular-nums` to price digits to prevent layout jittering during Monthly/Annual toggles
24
+ 2. Featured Tier Distinction (Section 31) → Highlight the "Most Popular" plan with distinct accent borders, badge pill, and solid primary CTA
25
+ 3. Discount Badge (Section 26) → Display explicit "Save X%" discount badge alongside the Annual billing toggle option
26
+
18
27
  Architect high-converting SaaS pricing tables with clear billing toggles, tier differentiation, and feature comparison matrices.
19
28
 
20
29
  ---