tribunal-kit 5.8.5 → 6.0.1

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 (315) hide show
  1. package/.agent/.manifest.json +78 -0
  2. package/.agent/ARCHITECTURE.md +32 -253
  3. package/.agent/agents/accessibility-reviewer.md +66 -151
  4. package/.agent/agents/ai-code-reviewer.md +22 -2
  5. package/.agent/agents/anti-pattern-reviewer.md +99 -0
  6. package/.agent/agents/api-architect.md +19 -2
  7. package/.agent/agents/backend-specialist.md +25 -3
  8. package/.agent/agents/cloud-engineer.md +21 -0
  9. package/.agent/agents/code-archaeologist.md +20 -3
  10. package/.agent/agents/complexity-reviewer.md +22 -2
  11. package/.agent/agents/database-architect.md +24 -3
  12. package/.agent/agents/db-latency-auditor.md +22 -2
  13. package/.agent/agents/debugger.md +19 -3
  14. package/.agent/agents/dependency-reviewer.md +19 -2
  15. package/.agent/agents/devops-engineer.md +24 -3
  16. package/.agent/agents/documentation-writer.md +21 -3
  17. package/.agent/agents/explorer-agent.md +21 -3
  18. package/.agent/agents/frontend-reviewer.md +19 -3
  19. package/.agent/agents/frontend-specialist.md +72 -224
  20. package/.agent/agents/game-developer.md +22 -3
  21. package/.agent/agents/interaction-reviewer.md +118 -0
  22. package/.agent/agents/logic-reviewer.md +18 -3
  23. package/.agent/agents/minimalist-reviewer.md +98 -0
  24. package/.agent/agents/mobile-developer.md +21 -3
  25. package/.agent/agents/mobile-reviewer.md +22 -2
  26. package/.agent/agents/orchestrator.md +19 -3
  27. package/.agent/agents/penetration-tester.md +22 -3
  28. package/.agent/agents/performance-optimizer.md +21 -3
  29. package/.agent/agents/performance-reviewer.md +2 -0
  30. package/.agent/agents/precedence-reviewer.md +19 -5
  31. package/.agent/agents/product-manager.md +20 -3
  32. package/.agent/agents/product-owner.md +22 -1
  33. package/.agent/agents/product-reviewer.md +98 -0
  34. package/.agent/agents/project-planner.md +19 -3
  35. package/.agent/agents/qa-automation-engineer.md +24 -3
  36. package/.agent/agents/resilience-reviewer.md +21 -2
  37. package/.agent/agents/schema-reviewer.md +21 -2
  38. package/.agent/agents/security-auditor.md +7 -1
  39. package/.agent/agents/seo-specialist.md +18 -3
  40. package/.agent/agents/sql-reviewer.md +22 -2
  41. package/.agent/agents/supervisor-agent.md +22 -3
  42. package/.agent/agents/swarm-worker-registry.md +7 -0
  43. package/.agent/agents/system-architect.md +19 -0
  44. package/.agent/agents/test-coverage-reviewer.md +22 -2
  45. package/.agent/agents/test-engineer.md +21 -2
  46. package/.agent/agents/throughput-optimizer.md +22 -2
  47. package/.agent/agents/type-safety-reviewer.md +21 -2
  48. package/.agent/agents/ui-ux-auditor.md +44 -242
  49. package/.agent/agents/ui-visual-auditor.md +99 -0
  50. package/.agent/agents/ux-reviewer.md +104 -0
  51. package/.agent/agents/visual-reviewer.md +98 -0
  52. package/.agent/agents/vitals-reviewer.md +23 -2
  53. package/.agent/history/README.md +53 -0
  54. package/.agent/history/case-law/cases/template-case.json +19 -0
  55. package/.agent/history/integrity_manifest.json +63 -33
  56. package/.agent/history/memory/.memory.idx +2701 -1
  57. package/.agent/history/memory/MEMORY.md +179 -1
  58. package/.agent/routing_index.json +273 -690
  59. package/.agent/rules/GEMINI.md +11 -13
  60. package/.agent/rules/GEMINI_PLANNER.md +84 -0
  61. package/.agent/scripts/case_law_manager.js +2 -0
  62. package/.agent/scripts/context_broker.js +152 -0
  63. package/.agent/scripts/guardrail_engine.js +59 -4
  64. package/.agent/scripts/impact_classifier.js +167 -0
  65. package/.agent/scripts/minimal_change_engine.js +437 -0
  66. package/.agent/scripts/pipeline_engine.js +856 -0
  67. package/.agent/scripts/socratic_gate_policy.js +60 -0
  68. package/.agent/scripts/token_budget_broker.js +52 -0
  69. package/.agent/scripts/verify_all.js +13 -0
  70. package/.agent/scripts/visual_audit.js +92 -0
  71. package/.agent/skill_topic_map.json +218 -0
  72. package/.agent/skills/12-principles-of-animation/SKILL.md +19 -10
  73. package/.agent/skills/60fps-animation/SKILL.md +19 -10
  74. package/.agent/skills/accessible-animation/SKILL.md +19 -10
  75. package/.agent/skills/adapt/SKILL.md +19 -10
  76. package/.agent/skills/advanced-rag-pipelines/SKILL.md +21 -3
  77. package/.agent/skills/agent-organizer/SKILL.md +21 -7
  78. package/.agent/skills/agentic-patterns/SKILL.md +19 -7
  79. package/.agent/skills/agentic-workflows-2026/SKILL.md +76 -0
  80. package/.agent/skills/ai-app-hardening/SKILL.md +58 -0
  81. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +21 -7
  82. package/.agent/skills/animation-on-scroll/SKILL.md +19 -10
  83. package/.agent/skills/animation-systems/SKILL.md +19 -10
  84. package/.agent/skills/antfu-conventions/SKILL.md +21 -10
  85. package/.agent/skills/api-patterns/SKILL.md +21 -7
  86. package/.agent/skills/api-security-auditor/SKILL.md +21 -7
  87. package/.agent/skills/app-builder/SKILL.md +21 -7
  88. package/.agent/skills/apple-design/SKILL.md +19 -10
  89. package/.agent/skills/architecture/SKILL.md +21 -7
  90. package/.agent/skills/audit-and-fix/SKILL.md +19 -10
  91. package/.agent/skills/authentication-best-practices/SKILL.md +21 -7
  92. package/.agent/skills/backend-security-expert/SKILL.md +21 -7
  93. package/.agent/skills/baseline-ui/SKILL.md +19 -10
  94. package/.agent/skills/bash-linux/SKILL.md +21 -7
  95. package/.agent/skills/behavioral-modes/SKILL.md +19 -7
  96. package/.agent/skills/better-colors/SKILL.md +19 -10
  97. package/.agent/skills/better-ui/SKILL.md +19 -10
  98. package/.agent/skills/bolder/SKILL.md +19 -10
  99. package/.agent/skills/brainstorming/SKILL.md +17 -7
  100. package/.agent/skills/browser-native-ai/SKILL.md +19 -3
  101. package/.agent/skills/build-primitive/SKILL.md +19 -10
  102. package/.agent/skills/building-native-ui/SKILL.md +21 -7
  103. package/.agent/skills/cicd-pro/SKILL.md +21 -10
  104. package/.agent/skills/clarify/SKILL.md +19 -10
  105. package/.agent/skills/clean-code/SKILL.md +21 -7
  106. package/.agent/skills/cloud-architect/SKILL.md +21 -10
  107. package/.agent/skills/cobejs/SKILL.md +19 -10
  108. package/.agent/skills/code-review-checklist/SKILL.md +21 -7
  109. package/.agent/skills/codebase-design/SKILL.md +21 -10
  110. package/.agent/skills/colorize/SKILL.md +19 -10
  111. package/.agent/skills/compact-landing/SKILL.md +19 -10
  112. package/.agent/skills/company-logos/SKILL.md +19 -10
  113. package/.agent/skills/config-validator/SKILL.md +21 -7
  114. package/.agent/skills/containerization-pro/SKILL.md +21 -10
  115. package/.agent/skills/context-engineering-pro/SKILL.md +69 -0
  116. package/.agent/skills/create-design-md/SKILL.md +19 -10
  117. package/.agent/skills/critique/SKILL.md +19 -10
  118. package/.agent/skills/csharp-developer/SKILL.md +21 -7
  119. package/.agent/skills/data-validation-schemas/SKILL.md +21 -7
  120. package/.agent/skills/database-design/SKILL.md +21 -7
  121. package/.agent/skills/delight/SKILL.md +19 -10
  122. package/.agent/skills/deployment-procedures/SKILL.md +21 -7
  123. package/.agent/skills/design-lab/SKILL.md +21 -10
  124. package/.agent/skills/devops-engineer/SKILL.md +21 -7
  125. package/.agent/skills/devops-incident-responder/SKILL.md +21 -7
  126. package/.agent/skills/diagnosing-bugs/SKILL.md +21 -10
  127. package/.agent/skills/distill/SKILL.md +19 -10
  128. package/.agent/skills/documentation-templates/SKILL.md +21 -7
  129. package/.agent/skills/domain-modeling/SKILL.md +21 -10
  130. package/.agent/skills/duckdb-analytical-sql/SKILL.md +55 -0
  131. package/.agent/skills/edge-ai-mobile/SKILL.md +46 -0
  132. package/.agent/skills/edge-computing/SKILL.md +21 -7
  133. package/.agent/skills/emil-design-eng/SKILL.md +19 -10
  134. package/.agent/skills/error-resilience/SKILL.md +21 -7
  135. package/.agent/skills/expo-router-v4/SKILL.md +80 -0
  136. package/.agent/skills/extract-design-system/SKILL.md +21 -7
  137. package/.agent/skills/fabel-protocol/SKILL.md +19 -2
  138. package/.agent/skills/fixing-accessibility/SKILL.md +19 -10
  139. package/.agent/skills/fixing-metadata/SKILL.md +19 -10
  140. package/.agent/skills/fixing-motion-performance/SKILL.md +19 -10
  141. package/.agent/skills/framer-motion-expert/SKILL.md +19 -6
  142. package/.agent/skills/frontend-design/SKILL.md +64 -201
  143. package/.agent/skills/frontend-security-expert/SKILL.md +21 -7
  144. package/.agent/skills/game-design-expert/SKILL.md +21 -7
  145. package/.agent/skills/game-engineering-expert/SKILL.md +21 -7
  146. package/.agent/skills/generative-ui-expert/SKILL.md +19 -3
  147. package/.agent/skills/geo-fundamentals/SKILL.md +21 -7
  148. package/.agent/skills/git-pro/SKILL.md +21 -10
  149. package/.agent/skills/github-operations/SKILL.md +21 -7
  150. package/.agent/skills/gpt-taste/SKILL.md +19 -10
  151. package/.agent/skills/gsap-core/SKILL.md +21 -4
  152. package/.agent/skills/gsap-frameworks/SKILL.md +21 -4
  153. package/.agent/skills/gsap-performance/SKILL.md +20 -5
  154. package/.agent/skills/gsap-plugins/SKILL.md +20 -5
  155. package/.agent/skills/gsap-react/SKILL.md +20 -5
  156. package/.agent/skills/gsap-scrolltrigger/SKILL.md +21 -4
  157. package/.agent/skills/gsap-timeline/SKILL.md +20 -5
  158. package/.agent/skills/gsap-utils/SKILL.md +20 -5
  159. package/.agent/skills/harden/SKILL.md +19 -10
  160. package/.agent/skills/harness-protocol/SKILL.md +20 -4
  161. package/.agent/skills/i18n-localization/SKILL.md +21 -7
  162. package/.agent/skills/impeccable/SKILL.md +19 -10
  163. package/.agent/skills/improve-codebase-architecture/SKILL.md +21 -10
  164. package/.agent/skills/improve-ui/SKILL.md +19 -10
  165. package/.agent/skills/intelligent-routing/SKILL.md +19 -7
  166. package/.agent/skills/knowledge-graph/SKILL.md +20 -4
  167. package/.agent/skills/landing-page/SKILL.md +20 -10
  168. package/.agent/skills/lint-and-validate/SKILL.md +21 -7
  169. package/.agent/skills/llm-engineering/SKILL.md +21 -7
  170. package/.agent/skills/local-first/SKILL.md +21 -7
  171. package/.agent/skills/local-first-architecture/SKILL.md +19 -10
  172. package/.agent/skills/lottie-animation/SKILL.md +19 -10
  173. package/.agent/skills/marquee-loop/SKILL.md +19 -10
  174. package/.agent/skills/masked-reveal/SKILL.md +19 -10
  175. package/.agent/skills/mcp-builder/SKILL.md +21 -7
  176. package/.agent/skills/micro-interaction/SKILL.md +19 -10
  177. package/.agent/skills/mobile-design/SKILL.md +21 -6
  178. package/.agent/skills/monorepo-management/SKILL.md +21 -7
  179. package/.agent/skills/morphing-icons/SKILL.md +19 -10
  180. package/.agent/skills/motion-engineering/SKILL.md +20 -7
  181. package/.agent/skills/nextjs-react-expert/SKILL.md +19 -7
  182. package/.agent/skills/nodejs-best-practices/SKILL.md +21 -7
  183. package/.agent/skills/observability/SKILL.md +21 -7
  184. package/.agent/skills/opentelemetry-observability/SKILL.md +58 -0
  185. package/.agent/skills/page-transition-animation/SKILL.md +19 -10
  186. package/.agent/skills/parallel-agents/SKILL.md +23 -7
  187. package/.agent/skills/performance-profiling/SKILL.md +21 -7
  188. package/.agent/skills/plan-writing/SKILL.md +21 -7
  189. package/.agent/skills/platform-engineer/SKILL.md +21 -7
  190. package/.agent/skills/platform-engineering-opentofu/SKILL.md +67 -0
  191. package/.agent/skills/playwright-ai-e2e/SKILL.md +59 -0
  192. package/.agent/skills/playwright-best-practices/SKILL.md +21 -7
  193. package/.agent/skills/polish/SKILL.md +19 -10
  194. package/.agent/skills/powershell-windows/SKILL.md +21 -7
  195. package/.agent/skills/pricing-page/SKILL.md +19 -10
  196. package/.agent/skills/product-aware-heuristics/SKILL.md +358 -0
  197. package/.agent/skills/progressive-blur/SKILL.md +19 -10
  198. package/.agent/skills/project-idioms/SKILL.md +20 -8
  199. package/.agent/skills/property-based-testing/SKILL.md +60 -0
  200. package/.agent/skills/python-patterns/SKILL.md +21 -7
  201. package/.agent/skills/python-pro/SKILL.md +21 -6
  202. package/.agent/skills/quieter/SKILL.md +19 -10
  203. package/.agent/skills/react-doctor/SKILL.md +19 -10
  204. package/.agent/skills/react-specialist/SKILL.md +19 -6
  205. package/.agent/skills/readme-builder/SKILL.md +21 -7
  206. package/.agent/skills/realtime-patterns/SKILL.md +21 -7
  207. package/.agent/skills/red-team-tactics/SKILL.md +21 -7
  208. package/.agent/skills/redesign-skill/SKILL.md +19 -10
  209. package/.agent/skills/review-animations/SKILL.md +21 -10
  210. package/.agent/skills/rust-pro/SKILL.md +21 -7
  211. package/.agent/skills/seo-fundamentals/SKILL.md +21 -7
  212. package/.agent/skills/server-management/SKILL.md +21 -7
  213. package/.agent/skills/shadcn-ui-expert/SKILL.md +21 -7
  214. package/.agent/skills/shape/SKILL.md +19 -10
  215. package/.agent/skills/skill-creator/SKILL.md +21 -7
  216. package/.agent/skills/soft-skill/SKILL.md +19 -10
  217. package/.agent/skills/sounds-on-the-web/SKILL.md +19 -10
  218. package/.agent/skills/sql-pro/SKILL.md +21 -7
  219. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +21 -7
  220. package/.agent/skills/svg-animation/SKILL.md +19 -10
  221. package/.agent/skills/swiftui-expert/SKILL.md +21 -7
  222. package/.agent/skills/swiss-design/SKILL.md +19 -10
  223. package/.agent/skills/system-design-pro/SKILL.md +21 -9
  224. package/.agent/skills/systematic-debugging/SKILL.md +21 -7
  225. package/.agent/skills/tailwind-patterns/SKILL.md +21 -7
  226. package/.agent/skills/taste-skill/SKILL.md +19 -10
  227. package/.agent/skills/tdd-workflow/SKILL.md +21 -10
  228. package/.agent/skills/test-result-analyzer/SKILL.md +18 -6
  229. package/.agent/skills/testing-patterns/SKILL.md +21 -7
  230. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +21 -10
  231. package/.agent/skills/thinking-protocol/SKILL.md +20 -8
  232. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -10
  233. package/.agent/skills/transitions-dev/SKILL.md +19 -10
  234. package/.agent/skills/trend-researcher/SKILL.md +17 -6
  235. package/.agent/skills/typescript-advanced/SKILL.md +21 -7
  236. package/.agent/skills/typeset/SKILL.md +19 -10
  237. package/.agent/skills/ui-reasoning-engine/SKILL.md +154 -0
  238. package/.agent/skills/ui-skill-packs/SKILL.md +77 -0
  239. package/.agent/skills/ui-skills-root/SKILL.md +21 -9
  240. package/.agent/skills/ui-ux-pro-max/SKILL.md +62 -583
  241. package/.agent/skills/ui-ux-researcher/SKILL.md +17 -6
  242. package/.agent/skills/vector-search-pgvector/SKILL.md +77 -0
  243. package/.agent/skills/vue-expert/SKILL.md +19 -6
  244. package/.agent/skills/vulnerability-scanner/SKILL.md +21 -7
  245. package/.agent/skills/web-accessibility-auditor/SKILL.md +21 -7
  246. package/.agent/skills/web-design-guidelines/SKILL.md +32 -206
  247. package/.agent/skills/web-quality-audit/SKILL.md +19 -10
  248. package/.agent/skills/webapp-testing/SKILL.md +21 -7
  249. package/.agent/skills/webgpu-performance/SKILL.md +19 -3
  250. package/.agent/skills/whimsy-injector/SKILL.md +20 -10
  251. package/.agent/skills/workflow-optimizer/SKILL.md +16 -6
  252. package/.agent/skills/zero-trust-passkeys/SKILL.md +85 -0
  253. package/.agent/templates/DESIGN.md +292 -0
  254. package/.agent/templates/design-tokens.json +137 -0
  255. package/.agent/workflows/acf.md +13 -6
  256. package/.agent/workflows/api-tester.md +15 -8
  257. package/.agent/workflows/audit.md +19 -8
  258. package/.agent/workflows/brainstorm.md +14 -9
  259. package/.agent/workflows/changelog.md +14 -8
  260. package/.agent/workflows/create.md +16 -8
  261. package/.agent/workflows/debug.md +15 -10
  262. package/.agent/workflows/deploy.md +16 -8
  263. package/.agent/workflows/enhance.md +15 -10
  264. package/.agent/workflows/fix.md +15 -8
  265. package/.agent/workflows/generate.md +17 -11
  266. package/.agent/workflows/marathon.md +15 -8
  267. package/.agent/workflows/migrate.md +16 -8
  268. package/.agent/workflows/minimal.md +94 -0
  269. package/.agent/workflows/orchestrate.md +15 -8
  270. package/.agent/workflows/performance-benchmarker.md +15 -8
  271. package/.agent/workflows/pipeline.md +155 -0
  272. package/.agent/workflows/plan.md +14 -10
  273. package/.agent/workflows/preview.md +14 -7
  274. package/.agent/workflows/refactor.md +16 -8
  275. package/.agent/workflows/review-ai.md +15 -7
  276. package/.agent/workflows/review.md +15 -7
  277. package/.agent/workflows/session.md +14 -7
  278. package/.agent/workflows/status.md +13 -7
  279. package/.agent/workflows/strengthen-skills.md +15 -6
  280. package/.agent/workflows/super-prompt.md +19 -10
  281. package/.agent/workflows/swarm.md +15 -7
  282. package/.agent/workflows/test.md +15 -8
  283. package/.agent/workflows/tribunal-backend.md +16 -9
  284. package/.agent/workflows/tribunal-database.md +15 -8
  285. package/.agent/workflows/tribunal-frontend.md +26 -11
  286. package/.agent/workflows/tribunal-full.md +41 -26
  287. package/.agent/workflows/tribunal-mobile.md +15 -8
  288. package/.agent/workflows/tribunal-performance.md +15 -8
  289. package/.agent/workflows/tribunal-speed.md +16 -9
  290. package/.agent/workflows/tribunal-ui.md +82 -0
  291. package/.agent/workflows/ui-ux-pro-max.md +51 -107
  292. package/CONTRIBUTING.md +2 -2
  293. package/README.md +82 -60
  294. package/SECURITY.md +3 -3
  295. package/bin/mcp-server.js +253 -57
  296. package/bin/wrapper.js +24 -10
  297. package/dist/cli.js +29 -1
  298. package/dist/commands/compile.js +7 -0
  299. package/dist/commands/context.js +8 -3
  300. package/dist/commands/graph.js +8 -2
  301. package/dist/commands/init.js +13 -2
  302. package/dist/commands/memory.js +120 -68
  303. package/dist/commands/minimal.js +71 -0
  304. package/dist/commands/native.js +36 -0
  305. package/dist/commands/optimize.js +15 -5
  306. package/dist/esm/index.mjs +58 -32
  307. package/dist/index.d.ts +50 -2
  308. package/dist/utils/fs.js +10 -4
  309. package/dist/utils/helpers.js +10 -1
  310. package/dist/utils/version.js +9 -2
  311. package/mcp_config.json +10 -1
  312. package/package.json +16 -10
  313. package/scripts/benchmark.js +16 -0
  314. package/scripts/sync-version.js +1 -1
  315. package/scripts/visual_audit.js +126 -0
@@ -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
  ```
@@ -0,0 +1,58 @@
1
+ ---
2
+ name: opentelemetry-observability
3
+ description: Full-stack distributed tracing, metrics, OpenTelemetry (OTel), Prometheus, Grafana Tempo, and zero-overhead observability instrumentation.
4
+ tools: Read, Grep, Glob, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-08-05
7
+ script: .agent/scripts/test_runner.js
8
+ scripts-binding:
9
+ - .agent/scripts/test_runner.js
10
+ skills:
11
+ - devops-engineer
12
+ - observability
13
+ - performance-profiling
14
+ ---
15
+
16
+ # OpenTelemetry Observability — 2026 Telemetry Standards
17
+
18
+ ## Mandatory Pre-Flight Context Inspection
19
+
20
+ Before instrumenting applications:
21
+ 1. Vendor-Neutral Telemetry → Use standard OpenTelemetry SDKs (OTLP over gRPC/HTTP)
22
+ 2. Trace Propagation → Propagate `traceparent` W3C headers across HTTP and message queues
23
+ 3. Sampling Policy → Implement head/tail sampling to reduce telemetry storage costs by 80%
24
+
25
+ ## Custom Trace & Meter Instrumentation (TypeScript)
26
+
27
+ ```typescript
28
+ import { trace, metrics } from '@opentelemetry/api';
29
+
30
+ const tracer = trace.getTracer('user-service', '1.0.0');
31
+ const meter = metrics.getMeter('user-service', '1.0.0');
32
+
33
+ const loginCounter = meter.createCounter('user_logins_total', {
34
+ description: 'Counts total user login attempts',
35
+ });
36
+
37
+ export async function handleLogin(userId: string) {
38
+ return tracer.startActiveSpan('handleLogin', async (span) => {
39
+ try {
40
+ span.setAttribute('user.id', userId);
41
+ loginCounter.add(1, { status: 'success' });
42
+ // Business logic...
43
+ span.setStatus({ code: 1 }); // OK
44
+ } catch (err: any) {
45
+ span.recordException(err);
46
+ span.setStatus({ code: 2, message: err.message }); // Error
47
+ throw err;
48
+ } finally {
49
+ span.end();
50
+ }
51
+ });
52
+ }
53
+ ```
54
+
55
+ ## 🛑 Verification-Before-Completion (VBC) Protocol
56
+
57
+ - Verify traces connect seamlessly from frontend click to DB query.
58
+ - Confirm telemetry exporter overhead adds < 1ms latency to HTTP handlers.
@@ -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
@@ -0,0 +1,67 @@
1
+ ---
2
+ name: platform-engineering-opentofu
3
+ description: Infrastructure as Code (IaC) with OpenTofu/Terraform/Pulumi, automated cloud provisioning, DevSecOps pipelines, and self-service platform engineering.
4
+ tools: Read, Grep, Glob, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-08-05
7
+ script: .agent/scripts/verify_all.js
8
+ scripts-binding:
9
+ - .agent/scripts/security_scan.js
10
+ - .agent/scripts/verify_all.js
11
+ skills:
12
+ - devops-engineer
13
+ - platform-engineer
14
+ - cloud-architect
15
+ ---
16
+
17
+ # Platform Engineering & OpenTofu IaC
18
+
19
+ ## Mandatory Pre-Flight Context Inspection
20
+
21
+ Before provisioning cloud infrastructure:
22
+ 1. OpenTofu State Locking → Use remote S3/DynamoDB or backend state locking to prevent concurrency collisions
23
+ 2. Least Privilege IAM → Enforce strict role-based access control (RBAC) on all cloud resources
24
+ 3. Plan Validation → Run `tofu plan` and static security analysis (tfsec/checkov) before `tofu apply`
25
+
26
+ ## Production AWS VPC & ECS Module Blueprint
27
+
28
+ ```hcl
29
+ terraform {
30
+ required_version = ">= 1.6.0"
31
+ required_providers {
32
+ aws = {
33
+ source = "hashicorp/aws"
34
+ version = "~> 5.0"
35
+ }
36
+ }
37
+ }
38
+
39
+ variable "environment" {
40
+ type = string
41
+ default = "production"
42
+ }
43
+
44
+ resource "aws_vpc" "main" {
45
+ cidr_block = "10.0.0.0/16"
46
+ enable_dns_hostnames = true
47
+ enable_dns_support = true
48
+
49
+ tags = {
50
+ Name = "vpc-${var.environment}"
51
+ Environment = var.environment
52
+ ManagedBy = "OpenTofu"
53
+ }
54
+ }
55
+
56
+ resource "aws_subnet" "public_a" {
57
+ vpc_id = aws_vpc.main.id
58
+ cidr_block = "10.0.1.0/24"
59
+ availability_zone = "us-east-1a"
60
+ map_public_ip_on_launch = true
61
+ }
62
+ ```
63
+
64
+ ## 🛑 Verification-Before-Completion (VBC) Protocol
65
+
66
+ - Run `tofu validate` and security scan before applying changes.
67
+ - Ensure rollback plan is explicitly documented.
@@ -0,0 +1,59 @@
1
+ ---
2
+ name: playwright-ai-e2e
3
+ description: Modern Playwright 1.45+ E2E web testing, resilient ARIA locators, visual regression testing, network mocking, and AI-assisted flakiness detection.
4
+ tools: Read, Grep, Glob, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-08-05
7
+ script: .agent/scripts/test_runner.js
8
+ scripts-binding:
9
+ - .agent/scripts/test_runner.js
10
+ - .agent/scripts/visual_audit.js
11
+ skills:
12
+ - playwright-best-practices
13
+ - webapp-testing
14
+ - testing-patterns
15
+ ---
16
+
17
+ # Playwright AI E2E Testing — 2026 Standards
18
+
19
+ ## Mandatory Pre-Flight Context Inspection
20
+
21
+ Before writing end-to-end web tests:
22
+ 1. ARIA Role Locators → Use accessibility roles (`getByRole`, `getByText`) over brittle CSS selectors
23
+ 2. Auto-Waiting & Zero Sleep → Avoid `page.waitForTimeout()`; rely on Playwright built-in auto-waiting
24
+ 3. Network Interception → Mock external third-party APIs using `page.route()` for deterministic CI runs
25
+
26
+ ## Resilient E2E API Route Mocking & Interaction Test
27
+
28
+ ```typescript
29
+ import { test, expect } from '@playwright/test';
30
+
31
+ test.describe('Dashboard Features', () => {
32
+ test.beforeEach(async ({ page }) => {
33
+ // Intercept external analytics API to avoid flaky network calls
34
+ await page.route('**/api/analytics', async (route) => {
35
+ await route.fulfill({
36
+ status: 200,
37
+ contentType: 'application/json',
38
+ body: JSON.stringify({ visits: 1042, conversions: 88 }),
39
+ });
40
+ });
41
+ });
42
+
43
+ test('user views analytics dashboard', async ({ page }) => {
44
+ await page.goto('/dashboard');
45
+
46
+ // Resilient ARIA locators
47
+ const heading = page.getByRole('heading', { name: 'Analytics' });
48
+ await expect(heading).toBeVisible();
49
+
50
+ const visitsText = page.getByText('1042');
51
+ await expect(visitsText).toBeVisible();
52
+ });
53
+ });
54
+ ```
55
+
56
+ ## 🛑 Verification-Before-Completion (VBC) Protocol
57
+
58
+ - Run Playwright test suite in headless mode and verify zero flakiness.
59
+ - Ensure all interactive elements rely on resilient locators.
@@ -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
  ---