tribunal-kit 6.0.0 → 7.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 (353) hide show
  1. package/.agent/.manifest.json +78 -0
  2. package/.agent/ARCHITECTURE.md +19 -241
  3. package/.agent/agents/accessibility-reviewer.md +23 -16
  4. package/.agent/agents/ai-code-reviewer.md +25 -21
  5. package/.agent/agents/anti-pattern-reviewer.md +12 -7
  6. package/.agent/agents/api-architect.md +1 -0
  7. package/.agent/agents/backend-specialist.md +23 -22
  8. package/.agent/agents/cloud-engineer.md +1 -0
  9. package/.agent/agents/code-archaeologist.md +1 -0
  10. package/.agent/agents/complexity-reviewer.md +10 -7
  11. package/.agent/agents/database-architect.md +3 -2
  12. package/.agent/agents/db-latency-auditor.md +6 -2
  13. package/.agent/agents/debugger.md +3 -2
  14. package/.agent/agents/dependency-reviewer.md +1 -0
  15. package/.agent/agents/devops-engineer.md +9 -8
  16. package/.agent/agents/documentation-writer.md +6 -5
  17. package/.agent/agents/explorer-agent.md +1 -0
  18. package/.agent/agents/frontend-reviewer.md +21 -17
  19. package/.agent/agents/frontend-specialist.md +23 -20
  20. package/.agent/agents/game-developer.md +1 -0
  21. package/.agent/agents/interaction-reviewer.md +10 -5
  22. package/.agent/agents/logic-reviewer.md +3 -0
  23. package/.agent/agents/minimalist-reviewer.md +6 -0
  24. package/.agent/agents/mobile-developer.md +7 -6
  25. package/.agent/agents/mobile-reviewer.md +14 -13
  26. package/.agent/agents/orchestrator.md +3 -0
  27. package/.agent/agents/penetration-tester.md +1 -0
  28. package/.agent/agents/performance-optimizer.md +6 -5
  29. package/.agent/agents/performance-reviewer.md +6 -6
  30. package/.agent/agents/pipeline-reviewer.md +144 -0
  31. package/.agent/agents/precedence-reviewer.md +1 -0
  32. package/.agent/agents/product-manager.md +1 -0
  33. package/.agent/agents/product-owner.md +1 -0
  34. package/.agent/agents/product-reviewer.md +12 -7
  35. package/.agent/agents/project-planner.md +3 -0
  36. package/.agent/agents/qa-automation-engineer.md +50 -43
  37. package/.agent/agents/resilience-reviewer.md +1 -0
  38. package/.agent/agents/schema-reviewer.md +1 -0
  39. package/.agent/agents/security-auditor.md +24 -24
  40. package/.agent/agents/seo-specialist.md +33 -23
  41. package/.agent/agents/sql-reviewer.md +5 -4
  42. package/.agent/agents/supervisor-agent.md +12 -2
  43. package/.agent/agents/swarm-worker-contracts.md +13 -13
  44. package/.agent/agents/swarm-worker-registry.md +51 -51
  45. package/.agent/agents/system-architect.md +1 -0
  46. package/.agent/agents/test-coverage-reviewer.md +25 -22
  47. package/.agent/agents/test-engineer.md +12 -11
  48. package/.agent/agents/throughput-optimizer.md +45 -40
  49. package/.agent/agents/type-safety-reviewer.md +5 -4
  50. package/.agent/agents/ui-ux-auditor.md +6 -4
  51. package/.agent/agents/ui-visual-auditor.md +3 -0
  52. package/.agent/agents/ux-reviewer.md +11 -6
  53. package/.agent/agents/visual-reviewer.md +11 -6
  54. package/.agent/agents/vitals-reviewer.md +5 -4
  55. package/.agent/history/memory/.memory.idx +3716 -1
  56. package/.agent/history/memory/MEMORY.md +246 -1
  57. package/.agent/mcp_config.json +1 -6
  58. package/.agent/routing_index.json +2034 -263
  59. package/.agent/rules/GEMINI.md +12 -10
  60. package/.agent/rules/GEMINI_PLANNER.md +19 -21
  61. package/.agent/scripts/_colors.js +52 -54
  62. package/.agent/scripts/_utils.js +52 -53
  63. package/.agent/scripts/auto_preview.js +39 -43
  64. package/.agent/scripts/bundle_analyzer.js +47 -60
  65. package/.agent/scripts/case_law_manager.js +200 -294
  66. package/.agent/scripts/checklist.js +73 -94
  67. package/.agent/scripts/cicd_validator.js +305 -0
  68. package/.agent/scripts/compile_router.py +4 -111
  69. package/.agent/scripts/context_broker.js +317 -412
  70. package/.agent/scripts/contract_engine.js +402 -0
  71. package/.agent/scripts/dependency_analyzer.js +112 -124
  72. package/.agent/scripts/graph_builder.js +75 -103
  73. package/.agent/scripts/graph_visualizer.js +10 -12
  74. package/.agent/scripts/graph_zoom.js +38 -55
  75. package/.agent/scripts/guardrail_engine.js +195 -145
  76. package/.agent/scripts/impact_classifier.js +55 -30
  77. package/.agent/scripts/inner_loop_validator.js +108 -159
  78. package/.agent/scripts/integrity_manifest.js +59 -67
  79. package/.agent/scripts/lint_runner.js +65 -75
  80. package/.agent/scripts/marathon_harness.js +131 -208
  81. package/.agent/scripts/migrate_skills_frontmatter.py +4 -63
  82. package/.agent/scripts/minify_context.js +29 -33
  83. package/.agent/scripts/minimal_change_engine.js +95 -87
  84. package/.agent/scripts/mutation_runner.js +46 -62
  85. package/.agent/scripts/pipeline_engine.js +320 -209
  86. package/.agent/scripts/prompt_compiler.js +118 -93
  87. package/.agent/scripts/schema_validator.js +73 -121
  88. package/.agent/scripts/security_scan.js +88 -117
  89. package/.agent/scripts/session_manager.js +52 -69
  90. package/.agent/scripts/signal_detector.js +24 -22
  91. package/.agent/scripts/skill_evolution.js +184 -245
  92. package/.agent/scripts/skill_integrator.js +35 -48
  93. package/.agent/scripts/socratic_gate_policy.js +15 -12
  94. package/.agent/scripts/strengthen_skills.js +29 -33
  95. package/.agent/scripts/swarm_dispatcher.js +120 -151
  96. package/.agent/scripts/test_runner.js +54 -56
  97. package/.agent/scripts/token_budget_broker.js +9 -7
  98. package/.agent/scripts/trace_engine.js +126 -0
  99. package/.agent/scripts/verify_all.js +76 -93
  100. package/.agent/scripts/visual_audit.js +16 -21
  101. package/.agent/skill_topic_map.json +237 -0
  102. package/.agent/skills/12-principles-of-animation/SKILL.md +7 -0
  103. package/.agent/skills/60fps-animation/SKILL.md +7 -0
  104. package/.agent/skills/accessible-animation/SKILL.md +5 -1
  105. package/.agent/skills/adapt/SKILL.md +7 -1
  106. package/.agent/skills/advanced-rag-pipelines/SKILL.md +1 -0
  107. package/.agent/skills/agent-organizer/SKILL.md +1 -0
  108. package/.agent/skills/agentic-patterns/SKILL.md +33 -25
  109. package/.agent/skills/agentic-workflows-2026/SKILL.md +80 -0
  110. package/.agent/skills/ai-app-hardening/SKILL.md +59 -0
  111. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +7 -6
  112. package/.agent/skills/animation-on-scroll/SKILL.md +24 -15
  113. package/.agent/skills/animation-systems/SKILL.md +11 -10
  114. package/.agent/skills/antfu-conventions/SKILL.md +7 -2
  115. package/.agent/skills/api-patterns/SKILL.md +14 -10
  116. package/.agent/skills/api-security-auditor/SKILL.md +15 -14
  117. package/.agent/skills/app-builder/SKILL.md +1 -0
  118. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +2 -2
  119. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +1 -1
  120. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +12 -12
  121. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +3 -3
  122. package/.agent/skills/apple-design/SKILL.md +8 -7
  123. package/.agent/skills/architecture/SKILL.md +3 -2
  124. package/.agent/skills/audit-and-fix/SKILL.md +8 -5
  125. package/.agent/skills/authentication-best-practices/SKILL.md +9 -8
  126. package/.agent/skills/backend-security-expert/SKILL.md +1 -0
  127. package/.agent/skills/baseline-ui/SKILL.md +8 -7
  128. package/.agent/skills/bash-linux/SKILL.md +1 -0
  129. package/.agent/skills/behavioral-modes/SKILL.md +1 -0
  130. package/.agent/skills/better-colors/SKILL.md +11 -7
  131. package/.agent/skills/better-typography/SKILL.md +30 -16
  132. package/.agent/skills/better-ui/SKILL.md +17 -10
  133. package/.agent/skills/bolder/SKILL.md +6 -0
  134. package/.agent/skills/brainstorming/SKILL.md +6 -4
  135. package/.agent/skills/browser-native-ai/SKILL.md +5 -4
  136. package/.agent/skills/build-primitive/SKILL.md +5 -0
  137. package/.agent/skills/building-native-ui/SKILL.md +1 -0
  138. package/.agent/skills/cicd-pro/SKILL.md +2 -1
  139. package/.agent/skills/clarify/SKILL.md +19 -14
  140. package/.agent/skills/clean-code/SKILL.md +16 -15
  141. package/.agent/skills/cloud-architect/SKILL.md +1 -0
  142. package/.agent/skills/cobejs/SKILL.md +7 -9
  143. package/.agent/skills/code-review-checklist/SKILL.md +1 -0
  144. package/.agent/skills/codebase-design/SKILL.md +7 -2
  145. package/.agent/skills/colorize/SKILL.md +8 -3
  146. package/.agent/skills/compact-landing/SKILL.md +8 -3
  147. package/.agent/skills/company-logos/SKILL.md +6 -0
  148. package/.agent/skills/config-validator/SKILL.md +10 -9
  149. package/.agent/skills/containerization-pro/SKILL.md +6 -5
  150. package/.agent/skills/context-engineering-pro/SKILL.md +70 -0
  151. package/.agent/skills/create-design-md/SKILL.md +13 -5
  152. package/.agent/skills/critique/SKILL.md +10 -8
  153. package/.agent/skills/csharp-developer/SKILL.md +1 -0
  154. package/.agent/skills/data-validation-schemas/SKILL.md +28 -23
  155. package/.agent/skills/database-design/SKILL.md +2 -1
  156. package/.agent/skills/delight/SKILL.md +6 -0
  157. package/.agent/skills/deployment-procedures/SKILL.md +2 -1
  158. package/.agent/skills/design-lab/SKILL.md +5 -0
  159. package/.agent/skills/devops-engineer/SKILL.md +3 -2
  160. package/.agent/skills/devops-incident-responder/SKILL.md +2 -1
  161. package/.agent/skills/diagnosing-bugs/SKILL.md +12 -2
  162. package/.agent/skills/distill/SKILL.md +7 -2
  163. package/.agent/skills/documentation-templates/SKILL.md +3 -2
  164. package/.agent/skills/domain-modeling/SKILL.md +12 -4
  165. package/.agent/skills/duckdb-analytical-sql/SKILL.md +59 -0
  166. package/.agent/skills/edge-ai-mobile/SKILL.md +50 -0
  167. package/.agent/skills/edge-computing/SKILL.md +9 -8
  168. package/.agent/skills/emil-design-eng/SKILL.md +43 -27
  169. package/.agent/skills/error-resilience/SKILL.md +34 -16
  170. package/.agent/skills/expo-router-v4/SKILL.md +81 -0
  171. package/.agent/skills/extract-design-system/SKILL.md +12 -11
  172. package/.agent/skills/fabel-protocol/SKILL.md +24 -17
  173. package/.agent/skills/fixing-accessibility/SKILL.md +23 -16
  174. package/.agent/skills/fixing-metadata/SKILL.md +24 -13
  175. package/.agent/skills/fixing-motion-performance/SKILL.md +7 -5
  176. package/.agent/skills/framer-motion-expert/SKILL.md +29 -15
  177. package/.agent/skills/frontend-design/SKILL.md +21 -13
  178. package/.agent/skills/frontend-security-expert/SKILL.md +1 -0
  179. package/.agent/skills/game-design-expert/SKILL.md +1 -0
  180. package/.agent/skills/game-engineering-expert/SKILL.md +1 -0
  181. package/.agent/skills/generative-ui-expert/SKILL.md +3 -2
  182. package/.agent/skills/geo-fundamentals/SKILL.md +2 -1
  183. package/.agent/skills/git-pro/SKILL.md +10 -9
  184. package/.agent/skills/github-operations/SKILL.md +2 -1
  185. package/.agent/skills/gpt-taste/SKILL.md +7 -0
  186. package/.agent/skills/gsap-core/SKILL.md +26 -22
  187. package/.agent/skills/gsap-frameworks/SKILL.md +6 -5
  188. package/.agent/skills/gsap-performance/SKILL.md +4 -3
  189. package/.agent/skills/gsap-plugins/SKILL.md +34 -33
  190. package/.agent/skills/gsap-react/SKILL.md +9 -8
  191. package/.agent/skills/gsap-scrolltrigger/SKILL.md +34 -33
  192. package/.agent/skills/gsap-timeline/SKILL.md +18 -15
  193. package/.agent/skills/gsap-utils/SKILL.md +25 -24
  194. package/.agent/skills/harden/SKILL.md +9 -3
  195. package/.agent/skills/harness-protocol/SKILL.md +1 -0
  196. package/.agent/skills/i18n-localization/SKILL.md +10 -9
  197. package/.agent/skills/impeccable/SKILL.md +5 -0
  198. package/.agent/skills/improve-codebase-architecture/SKILL.md +10 -5
  199. package/.agent/skills/improve-ui/SKILL.md +12 -5
  200. package/.agent/skills/intelligent-routing/SKILL.md +7 -6
  201. package/.agent/skills/knowledge-graph/SKILL.md +1 -0
  202. package/.agent/skills/landing-page/SKILL.md +1 -0
  203. package/.agent/skills/lint-and-validate/SKILL.md +9 -4
  204. package/.agent/skills/llm-engineering/SKILL.md +55 -54
  205. package/.agent/skills/local-first/SKILL.md +20 -19
  206. package/.agent/skills/local-first-architecture/SKILL.md +6 -1
  207. package/.agent/skills/lottie-animation/SKILL.md +7 -3
  208. package/.agent/skills/marquee-loop/SKILL.md +1 -0
  209. package/.agent/skills/masked-reveal/SKILL.md +17 -4
  210. package/.agent/skills/mcp-builder/SKILL.md +13 -10
  211. package/.agent/skills/micro-interaction/SKILL.md +20 -5
  212. package/.agent/skills/mobile-design/SKILL.md +26 -15
  213. package/.agent/skills/monorepo-management/SKILL.md +3 -2
  214. package/.agent/skills/morphing-icons/SKILL.md +16 -6
  215. package/.agent/skills/motion-engineering/SKILL.md +19 -15
  216. package/.agent/skills/nextjs-react-expert/SKILL.md +26 -21
  217. package/.agent/skills/nodejs-best-practices/SKILL.md +89 -76
  218. package/.agent/skills/observability/SKILL.md +45 -44
  219. package/.agent/skills/opentelemetry-observability/SKILL.md +59 -0
  220. package/.agent/skills/page-transition-animation/SKILL.md +6 -3
  221. package/.agent/skills/parallel-agents/SKILL.md +7 -2
  222. package/.agent/skills/performance-profiling/SKILL.md +24 -13
  223. package/.agent/skills/plan-writing/SKILL.md +1 -0
  224. package/.agent/skills/platform-engineer/SKILL.md +3 -2
  225. package/.agent/skills/platform-engineering-opentofu/SKILL.md +68 -0
  226. package/.agent/skills/playwright-ai-e2e/SKILL.md +60 -0
  227. package/.agent/skills/playwright-best-practices/SKILL.md +29 -28
  228. package/.agent/skills/polish/SKILL.md +13 -12
  229. package/.agent/skills/powershell-windows/SKILL.md +1 -0
  230. package/.agent/skills/pricing-page/SKILL.md +8 -3
  231. package/.agent/skills/product-aware-heuristics/SKILL.md +122 -72
  232. package/.agent/skills/progressive-blur/SKILL.md +9 -4
  233. package/.agent/skills/project-idioms/SKILL.md +1 -0
  234. package/.agent/skills/property-based-testing/SKILL.md +58 -0
  235. package/.agent/skills/python-patterns/SKILL.md +1 -0
  236. package/.agent/skills/python-pro/SKILL.md +1 -0
  237. package/.agent/skills/quieter/SKILL.md +6 -0
  238. package/.agent/skills/react-doctor/SKILL.md +6 -0
  239. package/.agent/skills/react-specialist/SKILL.md +32 -28
  240. package/.agent/skills/readme-builder/SKILL.md +1 -0
  241. package/.agent/skills/realtime-patterns/SKILL.md +34 -33
  242. package/.agent/skills/red-team-tactics/SKILL.md +1 -0
  243. package/.agent/skills/redesign-skill/SKILL.md +6 -0
  244. package/.agent/skills/review-animations/SKILL.md +5 -2
  245. package/.agent/skills/review-animations/STANDARDS.md +37 -23
  246. package/.agent/skills/rust-pro/SKILL.md +1 -0
  247. package/.agent/skills/seo-fundamentals/SKILL.md +4 -3
  248. package/.agent/skills/server-management/SKILL.md +1 -0
  249. package/.agent/skills/shadcn-ui-expert/SKILL.md +28 -22
  250. package/.agent/skills/shape/SKILL.md +9 -2
  251. package/.agent/skills/skill-creator/SKILL.md +1 -0
  252. package/.agent/skills/soft-skill/SKILL.md +6 -0
  253. package/.agent/skills/sounds-on-the-web/SKILL.md +1 -0
  254. package/.agent/skills/sql-pro/SKILL.md +1 -0
  255. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +1 -0
  256. package/.agent/skills/svg-animation/SKILL.md +16 -7
  257. package/.agent/skills/swiftui-expert/SKILL.md +1 -0
  258. package/.agent/skills/swiss-design/SKILL.md +5 -0
  259. package/.agent/skills/system-design-pro/SKILL.md +1 -0
  260. package/.agent/skills/systematic-debugging/SKILL.md +1 -0
  261. package/.agent/skills/tailwind-patterns/SKILL.md +25 -11
  262. package/.agent/skills/taste-skill/SKILL.md +6 -0
  263. package/.agent/skills/tdd-workflow/SKILL.md +5 -0
  264. package/.agent/skills/test-result-analyzer/SKILL.md +1 -0
  265. package/.agent/skills/testing-patterns/SKILL.md +123 -115
  266. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +5 -0
  267. package/.agent/skills/thinking-protocol/SKILL.md +3 -0
  268. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +9 -8
  269. package/.agent/skills/transitions-dev/SKILL.md +19 -6
  270. package/.agent/skills/trend-researcher/SKILL.md +1 -0
  271. package/.agent/skills/typescript-advanced/SKILL.md +23 -18
  272. package/.agent/skills/typeset/SKILL.md +10 -1
  273. package/.agent/skills/ui-reasoning-engine/SKILL.md +67 -48
  274. package/.agent/skills/ui-skill-packs/SKILL.md +6 -1
  275. package/.agent/skills/ui-skills-root/SKILL.md +39 -38
  276. package/.agent/skills/ui-ux-pro-max/SKILL.md +34 -26
  277. package/.agent/skills/ui-ux-researcher/SKILL.md +1 -0
  278. package/.agent/skills/vector-search-pgvector/SKILL.md +78 -0
  279. package/.agent/skills/vue-expert/SKILL.md +22 -19
  280. package/.agent/skills/vulnerability-scanner/SKILL.md +22 -21
  281. package/.agent/skills/web-accessibility-auditor/SKILL.md +2 -1
  282. package/.agent/skills/web-design-guidelines/SKILL.md +16 -10
  283. package/.agent/skills/web-quality-audit/SKILL.md +5 -0
  284. package/.agent/skills/webapp-testing/SKILL.md +14 -13
  285. package/.agent/skills/webgpu-performance/SKILL.md +1 -0
  286. package/.agent/skills/whimsy-injector/SKILL.md +9 -5
  287. package/.agent/skills/workflow-optimizer/SKILL.md +1 -0
  288. package/.agent/skills/zero-trust-passkeys/SKILL.md +90 -0
  289. package/.agent/templates/DESIGN.md +119 -110
  290. package/.agent/templates/design-tokens.json +9 -6
  291. package/.agent/workflows/acf.md +1 -0
  292. package/.agent/workflows/api-tester.md +1 -0
  293. package/.agent/workflows/audit.md +1 -0
  294. package/.agent/workflows/brainstorm.md +1 -0
  295. package/.agent/workflows/changelog.md +1 -0
  296. package/.agent/workflows/contract.md +60 -0
  297. package/.agent/workflows/create.md +1 -0
  298. package/.agent/workflows/debug.md +1 -0
  299. package/.agent/workflows/deploy.md +1 -0
  300. package/.agent/workflows/enhance.md +1 -0
  301. package/.agent/workflows/fix-ci.md +89 -0
  302. package/.agent/workflows/fix.md +1 -0
  303. package/.agent/workflows/generate.md +1 -0
  304. package/.agent/workflows/marathon.md +1 -0
  305. package/.agent/workflows/migrate.md +1 -0
  306. package/.agent/workflows/minimal.md +9 -7
  307. package/.agent/workflows/orchestrate.md +1 -0
  308. package/.agent/workflows/performance-benchmarker.md +1 -0
  309. package/.agent/workflows/pipeline.md +26 -21
  310. package/.agent/workflows/plan.md +1 -0
  311. package/.agent/workflows/preview.md +1 -0
  312. package/.agent/workflows/refactor.md +3 -2
  313. package/.agent/workflows/review-ai.md +4 -3
  314. package/.agent/workflows/review.md +1 -0
  315. package/.agent/workflows/session.md +1 -0
  316. package/.agent/workflows/status.md +1 -0
  317. package/.agent/workflows/strengthen-skills.md +1 -0
  318. package/.agent/workflows/super-prompt.md +1 -0
  319. package/.agent/workflows/swarm.md +15 -3
  320. package/.agent/workflows/test.md +8 -7
  321. package/.agent/workflows/tribunal-backend.md +3 -2
  322. package/.agent/workflows/tribunal-cicd.md +104 -0
  323. package/.agent/workflows/tribunal-database.md +1 -0
  324. package/.agent/workflows/tribunal-frontend.md +8 -6
  325. package/.agent/workflows/tribunal-full.md +15 -14
  326. package/.agent/workflows/tribunal-mobile.md +6 -5
  327. package/.agent/workflows/tribunal-performance.md +1 -0
  328. package/.agent/workflows/tribunal-speed.md +1 -0
  329. package/.agent/workflows/tribunal-ui.md +29 -21
  330. package/.agent/workflows/ui-ux-pro-max.md +19 -15
  331. package/CONTRIBUTING.md +3 -3
  332. package/README.md +160 -88
  333. package/SECURITY.md +11 -11
  334. package/bin/mcp-server.js +512 -233
  335. package/bin/tribunal-kit.js +29 -30
  336. package/bin/wrapper.js +45 -48
  337. package/dist/cli.js +26 -0
  338. package/dist/commands/case.js +2 -0
  339. package/dist/commands/contract.js +440 -0
  340. package/dist/commands/memory.js +3 -2
  341. package/dist/commands/native.js +36 -0
  342. package/dist/commands/status.js +6 -0
  343. package/dist/esm/index.mjs +32 -0
  344. package/dist/index.d.ts +58 -3
  345. package/package.json +20 -16
  346. package/scripts/benchmark.js +62 -86
  347. package/scripts/changelog.js +67 -73
  348. package/scripts/fix-vbc.js +13 -15
  349. package/scripts/fix-vbc.ps1 +2 -118
  350. package/scripts/stress_benchmark.js +358 -0
  351. package/scripts/sync-version.js +71 -41
  352. package/scripts/validate-payload.js +23 -30
  353. package/scripts/visual_audit.js +23 -13
@@ -0,0 +1,78 @@
1
+ {
2
+ "ARCHITECTURE.md": "260ba64b8bae04d32fdefead90ba0c9c32d667ae93e4179b01fafba79e999977",
3
+ "mcp_config.json": "f6a66c11c396e809c30292cc46c232f2bea01fa2b71c43770df7980f3c5da07d",
4
+ "routing_index.json": "7ed02e81a341ab8f7e213a167c80c088bdbe74564edab038f8e396988b3c0459",
5
+ ".shared/ui-ux-pro-max/README.md": "6eef9eb39dcca03d3d5e9ff8269a0fb95f66e7632adc65e5a4d87c7702f8700e",
6
+ "agents/accessibility-reviewer.md": "19a5955c0e2040b5e6bcc182c0a6555b670b8a19506bf2a1fc42d076ec148d5d",
7
+ "agents/ai-code-reviewer.md": "d191c961a5d8007fc23b9a796b8e7c861ddc46c9a6ea9bfda5247d847c860de0",
8
+ "agents/anti-pattern-reviewer.md": "609bdf7a90bdce0af5ca3bc603b9fc8f471bb45b8dd73a2d665ecde693c933dd",
9
+ "agents/api-architect.md": "e835403bf257cf5feb46e66a88d9224ecdada0950f128f06d5360116545689ba",
10
+ "agents/backend-specialist.md": "5800f0f31fe85e7c91306566e5272b355766ab509f5af9b35f1585cd5302eb8a",
11
+ "agents/cloud-engineer.md": "105d3c4c80994691515264eb88ca6ea17badb20c1a2b94248e7b4bcd83396b4a",
12
+ "agents/code-archaeologist.md": "38fd341176a7bd65e43e5431240ec04327fcb78ba97baba8d67fd6cf160e0573",
13
+ "agents/complexity-reviewer.md": "56f7b196f5e090ccf5a91fa2bda39cd6e321fc4d394335b15098e468d92b1c18",
14
+ "agents/database-architect.md": "b83084749dfdd1202211f0921794a1a0d69f15e4fc57b49c8e06ee522eea4558",
15
+ "agents/db-latency-auditor.md": "ad7c234762ece94658896b937746950a01970745dbfe02c96e407910faaf4016",
16
+ "agents/debugger.md": "53efc71ceb04a38f9679c9964f493feba53054730014ebce7a6b3fd294d156bf",
17
+ "agents/dependency-reviewer.md": "ae02377df25412256aade7f717bee11db7213932d7a263dc8e980c1bb3c55c1c",
18
+ "agents/devops-engineer.md": "26aa391279d87e489224d4d1902f7df7c7bf25ed017eecd69d416636a9163114",
19
+ "agents/documentation-writer.md": "6ede8695ac7a305e4fd32d283cab390b41bfcb6ec1f19771af8670d49639f413",
20
+ "agents/explorer-agent.md": "d9864e0f8e2952efb4917e6cdb209e4ac31bbf4d4e4b445a0a75ed323baa98af",
21
+ "agents/frontend-reviewer.md": "8c9f29ecea5d3df2282d449c4305c6856cf3fe9c9687be84058e9eaf2b3b2b4b",
22
+ "agents/frontend-specialist.md": "018c3cb62f28191fd08fd50ba1b80a2e5aa50c93b3b5aff51873a4e2730655cf",
23
+ "agents/game-developer.md": "7d74fdb55c9a83a63ff1fa702891c95db6e5cb98defdd77f275699a012d13182",
24
+ "agents/interaction-reviewer.md": "2ab393869082a28d5c8d8aa462662dbab9f7be494f78b6e3af5e9cbc1b38b14a",
25
+ "agents/logic-reviewer.md": "3c62bf24ced30eda67f89f8db445decc33b6779927d7ff6e5ee203768bda0c95",
26
+ "agents/minimalist-reviewer.md": "b445ed39fb1e9d34496b18c30053143f3d07ef537b1f05fcff5a774ef4f0383d",
27
+ "agents/mobile-developer.md": "a414b6e030c28cab98439ad7d55ee627ab5895ab88aa46ab84d65cb0a8f173ad",
28
+ "agents/mobile-reviewer.md": "2e57830b419029d15f45ea36d07d1336388ced8d4bb474cbcb3727747ece3fad",
29
+ "agents/orchestrator.md": "0709bc2761ba4a72145c4745b441ab0574f8d586e3ba9c44005146dda4d4582a",
30
+ "agents/penetration-tester.md": "c021ae363bc152fea571671d76a5e91d6d0364ab5461eabbce79307262c237ba",
31
+ "agents/performance-optimizer.md": "950892fe759be062e99b24188eff07f9a0880b59fe0f0e9a140a01d8a9d979e1",
32
+ "agents/performance-reviewer.md": "eddb122a486409ab1b8819cbde14ac6cc37d3157726cbddaef8b5e576fa59018",
33
+ "agents/precedence-reviewer.md": "821d755c980c089640027fa98a06e4b72d9ad5870450c857ef899772da575417",
34
+ "agents/product-manager.md": "202850175e29bc7b4cef98735b2590d38005208c997a1ea6d77b8f42e6529aff",
35
+ "agents/product-owner.md": "ebdb9ec76cc375a4c372aeb2606c038e2a200bc7fbeb179803f49bd8382fe733",
36
+ "agents/product-reviewer.md": "2899b10b538121a82c4aad0b56c2ce0f273dcdc859489911372916090853adc2",
37
+ "agents/project-planner.md": "663128b26287931c270659083e4b23bb54af5ce5629a6871fee190a1d785cb36",
38
+ "agents/qa-automation-engineer.md": "4112f9d47e3816387ad4666054d4ed166fa465131f38482c468b16ebd57e3ff1",
39
+ "agents/resilience-reviewer.md": "fd7b0245a149a20347a20c2665b4e9363b2590b964c52667be5a034c69fc05a7",
40
+ "agents/schema-reviewer.md": "8e23c94c9ec96ee995ba54c5af87c6c4bcf455309c7a59188b4b6e115fa64dee",
41
+ "agents/security-auditor.md": "5a23581c041a8be551166c44d9d632d7809c942f818d3f2e86dd1656d11cb73c",
42
+ "agents/seo-specialist.md": "304318b15e7243c50765c9329b1807927b417dab00809b6e4b8b60ad41818482",
43
+ "agents/sql-reviewer.md": "bac1fb217ac1564005b24ccb6d64ff97f8309a43e6e181d4e397e53a0a2ceb4b",
44
+ "agents/supervisor-agent.md": "1e1acf3af5ef0089f2b6f85257fa6e5856d24f1554c31b9e11df16545abb70fc",
45
+ "agents/swarm-worker-contracts.md": "ccd0d905cd47634b5084a0368bde4f8cf2b9191fb0118ef105c3a93a0da6314d",
46
+ "agents/swarm-worker-registry.md": "0bacf1872dfba3a020880c42481c3d1c91546951d8087b7513c98b4ca9dab4e3",
47
+ "agents/system-architect.md": "8dfa980f65ddec9aaf0cd6e91c0be6de442fc8bd487327dbc8401b7d9beae4b3",
48
+ "agents/test-coverage-reviewer.md": "9b0f45fabc8770bb1466cee496921965bad6352e98ff94d5f96e9dbb88afc3d2",
49
+ "agents/test-engineer.md": "95ccf1f2dfb1169914f60d4a58caaaac30cd0c323769b990cfeee44b36f9a6c0",
50
+ "agents/throughput-optimizer.md": "61912f95fd330d0bdb7568bbdf8f56bcf9a23436adef1614eac01ee747117649",
51
+ "agents/type-safety-reviewer.md": "fa53aa125a876bbf79ad8e27530622087b5221832162e9753808250f515aee3e",
52
+ "agents/ui-ux-auditor.md": "eca159306ec3517d263268bd14805bf861c0b2a43538eb887ebf553bc0fe6b4b",
53
+ "agents/ui-visual-auditor.md": "808738bb9beaddbb1a318b5af9375907c694aad79d09ff308fd0cf4ef560f701",
54
+ "agents/ux-reviewer.md": "f7ccfdee74b7167130732e9e4b60f4bc76384e8cbcd346f67d4690a4310cad7a",
55
+ "agents/visual-reviewer.md": "fb1e14e81bdab69ce48629335718b0bceed64be6551ef3217033f233ae523346",
56
+ "agents/vitals-reviewer.md": "1a0c5d212c4260a96353771469f6f23b88d412c1468a6f64708d50ce4a62210a",
57
+ "patterns/generator.md": "009e73216e18aac251390f5d393d8c337f7714f0e5792ee03928f6e5f71c52f4",
58
+ "patterns/inversion.md": "50c23e1e3cd703a6bc9f4f70452dc9df2515d31b5e269d9a2cad8b158a382642",
59
+ "patterns/pipeline.md": "ae7a1cf81b83606887479623e69073bfb841ccf16ab3aff3248942a621cf3bbe",
60
+ "patterns/reviewer.md": "9aefbe2e1d70384c6acd39cf7e7ad7a582237096933069945d863178c5765611",
61
+ "patterns/tool-wrapper.md": "46e9b6b04f911415f0defdd44345570e818dfe6e3c4aafff1028582936f3fb8f",
62
+ "rules/GEMINI.md": "c77c36e6d8011895731deb645e524bdb0b15f1266c0b10f3fcd276824ceda02f",
63
+ "rules/GEMINI_PLANNER.md": "eb189fa733d63e0e87b61be94c35d940e541076161ac134546649d8d4404bced",
64
+ "workflows/tribunal-ui.md": "3ff8ad1d814f08fae8be453be5f4ec7bcdd7cdea36a8a51785018dafde94a8f3",
65
+ "workflows/ui-ux-pro-max.md": "04063384a85f12682ec2d99804dc4a1d90f51c74c4430723a212c27942495dfb",
66
+ "skills/context-engineering-pro/SKILL.md": "a888b0bb671f6a62e81cc23846d80e9a6591bb7968d5d59339bfc76c8424791a",
67
+ "skills/agentic-workflows-2026/SKILL.md": "b96c46d0915e6113e20a5498bbb8d8d79949da28cbdd4b8749a83ac909a5731b",
68
+ "skills/vector-search-pgvector/SKILL.md": "18a3495ea81b52c4c054945ae26e14bfbf59d8a9f893a3cdd6201da5b317a792",
69
+ "skills/duckdb-analytical-sql/SKILL.md": "0d282bf667f3bcaf88d0f71bb7f95c7f6a1e97131f035b88f0a9d28c2e2732ab",
70
+ "skills/expo-router-v4/SKILL.md": "8a0c8ecce143e7686661933af4bf88264ebd7c6074c0b6384711585515940125",
71
+ "skills/edge-ai-mobile/SKILL.md": "f6c75111597175e943291523226ec916ea8e4f21555780a32f60427e04bcc8ed",
72
+ "skills/platform-engineering-opentofu/SKILL.md": "a888b0bb671f6a62e81cc23846d80e9a6591bb7968d5d59339bfc76c8424791a",
73
+ "skills/opentelemetry-observability/SKILL.md": "60024b62cbe8165d0f9c0520675a7c2726ef1d54e81e1be6f65e182e96d9545a",
74
+ "skills/zero-trust-passkeys/SKILL.md": "ba8eaeb9b7957a9b6516532304e5fcd54bce2cee1b351ccf26a614aea7e778d0",
75
+ "skills/ai-app-hardening/SKILL.md": "03cfe2ac052856bd9483f3dc49d1fb848c8bbe0333d778a0f288bbdefd7f698e",
76
+ "skills/playwright-ai-e2e/SKILL.md": "778de79a3ec24a9bd6532d7d2bd5365b433208036d3d45e8783a7a72ee40c149",
77
+ "skills/property-based-testing/SKILL.md": "ed7dfa9119a955282465bc6e118bcd6b2994a90398e994d3547eed91309d3d15"
78
+ }
@@ -1,4 +1,4 @@
1
- # 🏛️ Tribunal Anti-Hallucination Kit v3.0.0 — Architecture
1
+ # 🏛️ Tribunal Anti-Hallucination Kit v6.0.1 — Architecture
2
2
 
3
3
  Works natively in **Antigravity**, **Cursor**, **Windsurf**, and any AI IDE that indexes `.agent/` folders.
4
4
 
@@ -34,252 +34,30 @@ flowchart TD
34
34
 
35
35
  ---
36
36
 
37
- ## 2. 3-Pass Hybrid Pipeline Architecture
37
+ ## 2. Option A + Option C Hybrid Architecture (v3.0.0 Standard)
38
38
 
39
- The `/pipeline` engine uses a 3-pass decoupled architecture to separate planning, generation, and validation, saving ~89% of context window tokens compared to monolithic generation.
39
+ ### Subsystem A: 2-Tier Lazy Skill Routing Engine
40
40
 
41
- ```mermaid
42
- flowchart LR
43
- subgraph Pass1 ["Pass 1: Planner (~1,500 tokens)"]
44
- P1["Task & Context"] --> P2["Classify Task & Stack"]
45
- P2 --> P3["Select 2-3 Essential Skills"]
46
- P3 --> P4["Output: Spec JSON"]
47
- end
48
-
49
- subgraph Pass2 ["Pass 2: Builder (~2,500 tokens)"]
50
- B1["Spec JSON + 2-3 Skill Rules"] --> B2["Focus Synthesis (75% Task Context)"]
51
- B2 --> B3["Generate Clean Code"]
52
- end
53
-
54
- subgraph Pass3 ["Pass 3: Validator (0 Tokens - Free)"]
55
- V1["Generated Code"] --> V2["pipeline_engine.js"]
56
- V2 --> V3["OWASP & Lint Check"]
57
- V3 -->|Pass| V4["Human Gate"]
58
- V3 -->|Fail| V5["Targeted Retry (Max 3)"]
59
- end
60
-
61
- Pass1 --> Pass2 --> Pass3
62
- ```
63
-
64
- ---
65
-
66
- ## 3. Swarm / Supervisor Architecture
67
-
68
- The `/swarm` workflow decomposes complex multi-domain goals into atomic, non-overlapping sub-tasks handled concurrently by specialist Workers.
69
-
70
- ```mermaid
71
- flowchart TD
72
- A["/swarm [Multi-domain Goal]"] --> B["supervisor-agent"]
73
- B --> C["Read: swarm-worker-registry.md"]
74
- C --> D["Validate Payload: swarm_dispatcher.js"]
75
-
76
- D --> E1["Worker A: backend-specialist"]
77
- D --> E2["Worker B: database-architect"]
78
- D --> E3["Worker C: frontend-specialist"]
79
-
80
- E1 --> F1["WorkerResult A"]
81
- E2 --> F2["WorkerResult B"]
82
- E3 --> F3["WorkerResult C"]
83
-
84
- F1 & F2 & F3 --> G["Promise.allSettled() Synthesis"]
85
- G --> H["Human Gate Approval"]
86
- ```
87
-
88
- ---
89
-
90
- ## 4. Context Window Token Budget Breakdown
91
-
92
- ```mermaid
93
- pie title Monolithic Generation vs Decoupled 3-Pass Pipeline Context Window
94
- "Generated Code Output" : 75
95
- "Essential Skill Rules" : 15
96
- "Task & File Context" : 10
97
- ```
98
-
99
- * **Monolithic `/generate`**: Uses ~12,000–18,000 tokens per pass (89% spent on system rules & personas).
100
- * **Decoupled `/pipeline`**: Uses ~2,500 tokens in Pass 2 (75%+ of context window dedicated exclusively to code synthesis).
101
-
102
- ---
103
-
104
- ## 5. The 27 Parallel Tribunal Reviewers
105
-
106
- When code is generated or audited, domain reviewers evaluate the diff in parallel. Approval requires unanimous pass across all assigned reviewers.
107
-
108
- | Reviewer Agent | Agent File | Primary Domain & Activation Signals |
109
- | :--- | :--- | :--- |
110
- | `logic-reviewer` | `agents/logic-reviewer.md` | **Always Active** — Core logic, boundary conditions, edge cases |
111
- | `security-auditor` | `agents/security-auditor.md` | **Always Active** — OWASP Top 10, sanitization, secret exposure |
112
- | `precedence-reviewer` | `agents/precedence-reviewer.md` | **Always Active** — Checks Case Law & project architectural precedents |
113
- | `complexity-reviewer` | `agents/complexity-reviewer.md` | **Always Active** — Over-engineering, Dependency Ladder enforcement |
114
- | `type-safety-reviewer` | `agents/type-safety-reviewer.md` | TypeScript strictness, zero `as any` policy, generic constraints |
115
- | `dependency-reviewer` | `agents/dependency-reviewer.md` | Phantom package detection, `package.json` verification |
116
- | `resilience-reviewer` | `agents/resilience-reviewer.md` | Fault tolerance, retries, circuit breakers, error boundaries |
117
- | `schema-reviewer` | `agents/schema-reviewer.md` | Input validation, Zod / Pydantic schemas, contract boundaries |
118
- | `frontend-reviewer` | `agents/frontend-reviewer.md` | React 19 / Next.js Server Components, hook rules, state mutations |
119
- | `ui-ux-auditor` | `agents/ui-ux-auditor.md` | Usability heuristics, responsive layouts, spatial systems |
120
- | `visual-reviewer` | `agents/visual-reviewer.md` | Visual hierarchy, typography scaling, OKLCH color palettes |
121
- | `interaction-reviewer` | `agents/interaction-reviewer.md` | Micro-interactions, hover/focus/active states, tactile feedback |
122
- | `anti-pattern-reviewer` | `agents/anti-pattern-reviewer.md` | Banned AI clichés (purple gradients, generic hero grids) |
123
- | `accessibility-reviewer` | `agents/accessibility-reviewer.md` | WCAG 2.2 AA compliance, ARIA attributes, keyboard navigation |
124
- | `sql-reviewer` | `agents/sql-reviewer.md` | Parameterized queries, ORM safety, transaction integrity |
125
- | `db-latency-auditor` | `agents/db-latency-auditor.md` | Slow query detection, index optimization, N+1 query prevention |
126
- | `mobile-reviewer` | `agents/mobile-reviewer.md` | React Native, Expo Router, 60fps Reanimated worklets, safe areas |
127
- | `performance-reviewer` | `agents/performance-reviewer.md` | O(n²) bottlenecks, layout thrashing, memory leaks |
128
- | `vitals-reviewer` | `agents/vitals-reviewer.md` | Core Web Vitals (LCP, CLS, INP, TTFB) depth analysis |
129
- | `throughput-optimizer` | `agents/throughput-optimizer.md` | Event-loop blocking, server concurrency, streaming optimization |
130
- | `ai-code-reviewer` | `agents/ai-code-reviewer.md` | LLM SDK parameters, prompt injection defense, token explosion |
131
-
132
- ---
133
-
134
- ## 6. 29 Specialist Domain Agents
135
-
136
- | Domain Specialist | Agent File | Focus Area & Capabilities |
137
- | :--- | :--- | :--- |
138
- | `supervisor-agent` | `agents/supervisor-agent.md` | Swarm triage, Worker dispatch, result synthesis |
139
- | `orchestrator` | `agents/orchestrator.md` | Multi-agent workflow coordination & fan-out |
140
- | `agent-organizer` | `agents/agent-organizer.md` | Agent ecosystem management & memory distillation |
141
- | `project-planner` | `agents/project-planner.md` | 4-phase structured implementation planning |
142
- | `backend-specialist` | `agents/backend-specialist.md` | Node.js, Express, Hono, API design, Server Actions |
143
- | `frontend-specialist` | `agents/frontend-specialist.md` | Modern Web UI, CSS systems, component architecture |
144
- | `react-specialist` | `agents/react-specialist.md` | React 19, Server Components, Zustand, TanStack Query |
145
- | `nextjs-react-expert` | `agents/nextjs-react-expert.md` | Next.js 15 App Router, PPR, Server Actions, Middleware |
146
- | `vue-expert` | `agents/vue-expert.md` | Vue 3.5+, Composition API, Nuxt 4, Pinia |
147
- | `python-pro` | `agents/python-pro.md` | Python 3.12+, FastAPI, Pydantic v2, Asyncio, Pytest |
148
- | `rust-pro` | `agents/rust-pro.md` | Rust 1.75+, Tokio async, Axum, Serde, memory safety |
149
- | `csharp-developer` | `agents/csharp-developer.md` | C# 12, .NET 8/9, ASP.NET Core, Blazor architecture |
150
- | `database-architect` | `agents/database-architect.md` | Data modeling, Prisma/Drizzle schema design, migrations |
151
- | `sql-pro` | `agents/sql-pro.md` | PostgreSQL, Supabase RLS, complex analytical SQL |
152
- | `mobile-developer` | `agents/mobile-developer.md` | Expo, React Native, Flutter, native modules |
153
- | `devops-engineer` | `agents/devops-engineer.md` | Docker, CI/CD pipelines, GitHub Actions, deployment |
154
- | `platform-engineer` | `agents/platform-engineer.md` | Cloud-native infrastructure, Kubernetes, Terraform |
155
- | `cloud-engineer` | `agents/cloud-engineer.md` | AWS, Serverless, IaC, edge computing topology |
156
- | `devops-incident-responder` | `agents/devops-incident-responder.md` | Incident root cause investigation & hotfixes |
157
- | `debugger` | `agents/debugger.md` | 4-phase systematic debugging & traceback isolation |
158
- | `system-architect` | `agents/system-architect.md` | Capacity planning, scale estimation, distributed systems |
159
- | `code-archaeologist` | `agents/code-archaeologist.md` | Legacy codebase analysis, debt mapping, seams |
160
- | `explorer-agent` | `agents/explorer-agent.md` | Unknown codebase mapping & dependency graph discovery |
161
- | `documentation-writer` | `agents/documentation-writer.md` | Technical documentation, OpenAPI, README generation |
162
- | `test-engineer` | `agents/test-engineer.md` | Testing Trophy strategy, behavioral test design |
163
- | `qa-automation-engineer` | `agents/qa-automation-engineer.md` | E2E Playwright testing, CI test automation |
164
- | `seo-specialist` | `agents/seo-specialist.md` | Technical SEO, OpenGraph, Core Web Vitals optimization |
165
- | `product-manager` | `agents/product-manager.md` | Feature prioritization, scope control, user stories |
166
- | `product-owner` | `agents/product-owner.md` | Backlog management, acceptance criteria verification |
167
-
168
- ---
169
-
170
- ## 7. 37 Slash Commands & Workflows
171
-
172
- Type any of these commands in your AI IDE chat to trigger specialized workflows:
41
+ - **Lightweight Index (`skill_topic_map.json`):** 183 skills indexed across 9 domain routes and file extensions (~500 tokens).
42
+ - **Startup Overhead:** ~2,500 – 3,500 startup tokens vs 85,000 tokens previously (95% token reduction).
43
+ - **Zero Exclusions:** All 183 skills remain indexed on disk; target skills are fetched dynamically on-demand via `view_file`.
173
44
 
174
- | Command | Purpose | File Path |
175
- | :--- | :--- | :--- |
176
- | `/generate` | Full Tribunal: Maker → Parallel Review → Human Gate | [`workflows/generate.md`](workflows/generate.md) |
177
- | `/review` | Pure read-only hallucination audit | [`workflows/review.md`](workflows/review.md) |
178
- | `/tribunal-full` | Comprehensive 27-reviewer parallel audit | [`workflows/tribunal-full.md`](workflows/tribunal-full.md) |
179
- | `/tribunal-backend` | Logic + Security + Deps + Type Safety + Resilience + Schema | [`workflows/tribunal-backend.md`](workflows/tribunal-backend.md) |
180
- | `/tribunal-frontend` | Logic + Security + Frontend + Types + UI/UX + Motion + Visual | [`workflows/tribunal-frontend.md`](workflows/tribunal-frontend.md) |
181
- | `/tribunal-database` | Logic + Security + SQL parameterization audit | [`workflows/tribunal-database.md`](workflows/tribunal-database.md) |
182
- | `/tribunal-mobile` | Logic + Security + Mobile 60fps Reanimated audit | [`workflows/tribunal-mobile.md`](workflows/tribunal-mobile.md) |
183
- | `/tribunal-performance` | Logic + Performance optimization audit | [`workflows/tribunal-performance.md`](workflows/tribunal-performance.md) |
184
- | `/tribunal-ui` | Dedicated UI/UX design heuristics audit | [`workflows/tribunal-ui.md`](workflows/tribunal-ui.md) |
185
- | `/tribunal-speed` | Full-stack parallel performance swarm (max 5 AI calls) | [`workflows/tribunal-speed.md`](workflows/tribunal-speed.md) |
186
- | `/brainstorm` | Socratic exploration mode — 3 options & tradeoffs | [`workflows/brainstorm.md`](workflows/brainstorm.md) |
187
- | `/create` | Full application creation from requirements to scaffold | [`workflows/create.md`](workflows/create.md) |
188
- | `/enhance` | Dependency-safe feature addition & impact analysis | [`workflows/enhance.md`](workflows/enhance.md) |
189
- | `/debug` | 4-phase systematic root cause investigation | [`workflows/debug.md`](workflows/debug.md) |
190
- | `/plan` | Strategic 4-phase implementation planning | [`workflows/plan.md`](workflows/plan.md) |
191
- | `/deploy` | Pre-flight safety checks & production release gates | [`workflows/deploy.md`](workflows/deploy.md) |
192
- | `/test` | Behavioral test generation & execution | [`workflows/test.md`](workflows/test.md) |
193
- | `/preview` | Local dev server lifecycle management | [`workflows/preview.md`](workflows/preview.md) |
194
- | `/status` | Project health dashboard & active execution ledger | [`workflows/status.md`](workflows/status.md) |
195
- | `/session` | Multi-session state tracking & restoration | [`workflows/session.md`](workflows/session.md) |
196
- | `/orchestrate` | Multi-agent fan-out/fan-in coordination | [`workflows/orchestrate.md`](workflows/orchestrate.md) |
197
- | `/swarm` | Multi-agent swarm supervisor & JSON contract dispatcher | [`workflows/swarm.md`](workflows/swarm.md) |
198
- | `/strengthen-skills` | Skill hardening & Tribunal guardrail injector | [`workflows/strengthen-skills.md`](workflows/strengthen-skills.md) |
199
- | `/ui-ux-pro-max` | Picasso design specification & 16-step UI engine | [`workflows/ui-ux-pro-max.md`](workflows/ui-ux-pro-max.md) |
200
- | `/refactor` | Dependency-safe structural code refactoring | [`workflows/refactor.md`](workflows/refactor.md) |
201
- | `/migrate` | Expand-and-contract database & framework migrations | [`workflows/migrate.md`](workflows/migrate.md) |
202
- | `/audit` | Full project health assessment & priority script audit | [`workflows/audit.md`](workflows/audit.md) |
203
- | `/fix` | Automated error resolution & lint diff preview | [`workflows/fix.md`](workflows/fix.md) |
204
- | `/changelog` | Conventional commit history to changelog compiler | [`workflows/changelog.md`](workflows/changelog.md) |
205
- | `/review-ai` | LLM integration & prompt injection defense audit | [`workflows/review-ai.md`](workflows/review-ai.md) |
206
- | `/pipeline` | Token-efficient 3-pass code generation pipeline | [`workflows/pipeline.md`](workflows/pipeline.md) |
207
- | `/super-prompt` | Zero-token local prompt compiler | [`workflows/super-prompt.md`](workflows/super-prompt.md) |
208
- | `/marathon` | Multi-session long-running agent harness | [`workflows/marathon.md`](workflows/marathon.md) |
209
- | `/acf` | Agent Context Format spec distillation | [`workflows/acf.md`](workflows/acf.md) |
210
- | `/api-tester` | Multi-stage auth-aware API endpoint testing | [`workflows/api-tester.md`](workflows/api-tester.md) |
211
- | `/performance-benchmarker` | Evidence-based Core Web Vitals measurement | [`workflows/performance-benchmarker.md`](workflows/performance-benchmarker.md) |
45
+ ### Subsystem C: Stage-Partitioned Tribunal Pipeline
212
46
 
213
- ---
214
-
215
- ## 8. Complete 32-Script Automation Inventory
216
-
217
- All scripts live in `.agent/scripts/`:
218
-
219
- | Script Name | Primary Function | Command Example |
220
- | :--- | :--- | :--- |
221
- | `security_scan.js` | Deep OWASP-aware source code security scanner | `node .agent/scripts/security_scan.js .` |
222
- | `dependency_analyzer.js` | Unused/phantom dependency audit & npm security audit | `node .agent/scripts/dependency_analyzer.js . --audit` |
223
- | `lint_runner.js` | Standalone multi-linter runner (ESLint, Prettier, Ruff) | `node .agent/scripts/lint_runner.js . --fix` |
224
- | `schema_validator.js` | DB schema validator (Prisma, Drizzle, SQL) | `node .agent/scripts/schema_validator.js .` |
225
- | `test_runner.js` | Auto-detecting test runner (Jest, Vitest, Pytest) | `node .agent/scripts/test_runner.js . --coverage` |
226
- | `bundle_analyzer.js` | JS/TS production bundle size analyzer | `node .agent/scripts/bundle_analyzer.js . --build` |
227
- | `verify_all.js` | Comprehensive pre-deploy validation suite | `node .agent/scripts/verify_all.js` |
228
- | `checklist.js` | Priority audit: Security → Dependencies → Types → Lint | `node .agent/scripts/checklist.js .` |
229
- | `auto_preview.js` | Local development server lifecycle manager | `node .agent/scripts/auto_preview.js start` |
230
- | `session_manager.js` | Multi-session state tracking & snapshot restoration | `node .agent/scripts/session_manager.js status` |
231
- | `swarm_dispatcher.js` | Validates Swarm WorkerRequest/WorkerResult payloads | `node .agent/scripts/swarm_dispatcher.js --file payload.json` |
232
- | `skill_integrator.js` | Maps active skills to executable scripts | `node .agent/scripts/skill_integrator.js` |
233
- | `pipeline_engine.js` | 3-pass hybrid pipeline orchestrator (Plan/Build/Validate) | `node .agent/scripts/pipeline_engine.js --task "..." --dry-run` |
234
- | `prompt_compiler.js` | Zero-token local prompt compiler to dense YAML | `node .agent/scripts/prompt_compiler.js "build login"` |
235
- | `strengthen_skills.js` | Hardens skills with Pre-Flight & VBC guardrails | `node .agent/scripts/strengthen_skills.js . --dry-run` |
236
- | `test_swarm_dispatcher.js` | Integration test suite for swarm dispatcher | `npx jest test/integration/swarm_dispatcher.test.js` |
237
- | `auto_fixer.js` | Automated formatting & import cleanup engine | `node .agent/scripts/auto_fixer.js .` |
238
- | `context_snapshot.js` | Compacts large codebase graphs for 27x context reduction | `node .agent/scripts/context_snapshot.js .` |
239
- | `skill_evolution.js` | Extracts project idioms & auto-evolves project-idioms skill | `node .agent/scripts/skill_evolution.js .` |
240
-
241
- *(Note: Additional internal helper scripts in `.agent/scripts/` handle AST parsing, diff formatting, and IPC message routing).*
47
+ - **52 Specialist Agents** (28 Parallel Reviewers + 24 Domain Specialists).
48
+ - **3 Execution Waves:** Replaces monolithic fan-out with 3 partitioned passes (28 reviewers total):
49
+ - **Wave 1 (Core Integrity):** `precedence-reviewer`, `logic-reviewer`, `schema-reviewer`, `resilience-reviewer`
50
+ - **Wave 2 (Security & Types):** `security-auditor`, `dependency-reviewer`, `type-safety-reviewer`, `complexity-reviewer`, `sql-reviewer`, `pipeline-reviewer`
51
+ - **Wave 3 (Domain & Performance):** `frontend-reviewer`, `performance-reviewer`, `mobile-reviewer`, `ai-code-reviewer`, `test-coverage-reviewer`, `accessibility-reviewer`, `ui-ux-auditor`, `review-animations`, `vitals-reviewer`, `db-latency-auditor`, `throughput-optimizer`
52
+ - **Attention Preservation:** Reviewers execute in scoped evaluation pairs of 4 to 8 specialists, eliminating hallucination risks and attention dilution.
242
53
 
243
54
  ---
244
55
 
245
- ## 9. Kit v3.0.0 Specification Standards
246
-
247
- ### Option B Agent Standard (51 Agents)
248
- * **YAML Frontmatter**: Version `3.0.0`, `last-updated: 2026-07-29`, clean `skills` array, tool declarations, model targets.
249
- * **Mandatory Pre-Flight Context Inspection**: Grounded list of workspace files inspected prior to action.
250
- * **Framework Decision Trees & Blueprints**: Version-pinned decision matrices (React 19, Next 15, Prisma 6, Node 20+, Python 3.12+, Expo Router v4).
251
- * **Hand-Off & Coordination Protocols**: Explicit `@agent` routing contracts.
56
+ ## 3. Skill-Script Binding Standard
252
57
 
253
- ### Option A+C Hybrid Skill Standard (171 Skills)
254
- * **YAML Frontmatter**: Version `3.0.0`, `last-updated: 2026-07-30`, array-style `skills` co-requirements, `tools` declaration, `scripts-binding` array pointing to `.agent/scripts/`.
255
- * **Mandatory Pre-Flight Context Inspection**: Specific numbered section targets and rules that agents MUST check before executing the skill.
256
- * **Tribunal Integration & VBC Protocol**: Anti-hallucination guardrails and Verification-Before-Completion evidence validation.
58
+ Every skill in `.agent/skills/` conforms to the Option A+C Hybrid v3.0.0 frontmatter standard:
257
59
 
258
- ### Workflow Standard v3.0.0 (37 Workflows)
259
- * **YAML Frontmatter**: Version `3.0.0`, `last-updated: 2026-07-30`, array-style `required-skills`, `tools` declaration, `scripts-binding` array.
260
- * **Mandatory Pre-Flight Context Inspection**: Workspace inspection checks and execution HALT conditions prior to tool invocation.
261
-
262
- ---
263
-
264
- ## 10. Directory Structure & File Map
265
-
266
- ```
267
- .agent/
268
- ├── ARCHITECTURE.md ← This file (Kit v3.0.0 Master Architecture)
269
- ├── GEMINI.md ← Master operational rules & auto domain router
270
- ├── agents/ ← 51 Option B v3.0.0 Agents (27 Parallel Reviewers + 24 Domain Specialists)
271
- │ ├── supervisor-agent.md ← Swarm triage, dispatch, synthesis
272
- │ ├── swarm-worker-contracts.md ← WorkerRequest/WorkerResult schemas
273
- │ └── swarm-worker-registry.md ← Task type → agent routing map
274
- ├── rules/
275
- │ ├── GEMINI.md ← Master rules (P0 priority)
276
- │ └── GEMINI_PLANNER.md ← Condensed planner rules for /pipeline Pass 1
277
- ├── scripts/ ← 37 automation scripts
278
- │ └── pipeline_engine.js ← 3-pass hybrid pipeline engine
279
- ├── skills/ ← 171 Option A+C Hybrid v3.0.0 Skills
280
- ├── patterns/ ← 5 ADK skill base patterns
281
- ├── history/ ← Case Law + Skill Evolution data
282
- └── workflows/ ← 37 Workflow Standard v3.0.0 Slash Commands
283
- ├── swarm.md ← /swarm orchestration procedure
284
- └── pipeline.md ← /pipeline hybrid generation procedure
285
- ```
60
+ - `version`: `3.0.0`
61
+ - `script`: Primary executable script path in `.agent/scripts/`
62
+ - `scripts-binding`: Array of executable CLI tools (`security_scan.js`, `test_runner.js`, `schema_validator.js`, etc.)
63
+ - `skills`: Array of co-required brother skills for automatic 2-tier lazy resolution
@@ -18,6 +18,7 @@ skills:
18
18
  ## Mandatory Pre-Flight Context Inspection
19
19
 
20
20
  Before auditing accessibility, you MUST inspect:
21
+
21
22
  1. Target size bounds → Verify touch targets on mobile/touch interfaces meet 44x44px minimum (WCAG 2.2 SC 2.5.8)
22
23
  2. Interactive element markup → Check for native `<button>` and `<a>` elements instead of unsemantic `<div onClick>`
23
24
  3. Form input & Icon-only buttons → Verify `<label htmlFor="...">` bindings and `aria-label` declarations
@@ -27,39 +28,44 @@ Before auditing accessibility, you MUST inspect:
27
28
  ## What This Reviewer Catches
28
29
 
29
30
  ### 1. Target Size (Minimum) (WCAG 2.2 SC 2.5.8 - Level AA)
30
- * **Criterion:** All interactive targets (buttons, links, form fields, checkboxes) must be at least **24x24 CSS pixels** in size.
31
- * **Coarse Pointers (Touch):** If the UI is used on touch devices (pointer: coarse), targets must meet a minimum size of **44x44px** (Apple HIG) or **48x48dp** (Material Design).
32
- * **Exception:** Inline text links (e.g., links in paragraphs) are exempt, but must have sufficient visual distinction (e.g., underline).
33
- * **Spacing Buffer:** Targets smaller than 24x24px must have surrounding spacing buffer so that a 24px diameter circle centered on the target does not intersect another target.
31
+
32
+ - **Criterion:** All interactive targets (buttons, links, form fields, checkboxes) must be at least **24x24 CSS pixels** in size.
33
+ - **Coarse Pointers (Touch):** If the UI is used on touch devices (pointer: coarse), targets must meet a minimum size of **44x44px** (Apple HIG) or **48x48dp** (Material Design).
34
+ - **Exception:** Inline text links (e.g., links in paragraphs) are exempt, but must have sufficient visual distinction (e.g., underline).
35
+ - **Spacing Buffer:** Targets smaller than 24x24px must have surrounding spacing buffer so that a 24px diameter circle centered on the target does not intersect another target.
34
36
 
35
37
  ### 2. APCA Contrast Guidelines (WCAG 3.0 APCA Base)
36
- * **Lightness Contrast (Lc):** Ensure readability using the APCA scale instead of flat 4.5:1 ratios:
37
- * **Body text (small size):** Must achieve Lc > 75.
38
- * **Large display headings (large size):** Must achieve Lc > 60.
39
- * **Interactive indicators & borders:** Must achieve Lc > 45.
38
+
39
+ - **Lightness Contrast (Lc):** Ensure readability using the APCA scale instead of flat 4.5:1 ratios:
40
+ - **Body text (small size):** Must achieve Lc > 75.
41
+ - **Large display headings (large size):** Must achieve Lc > 60.
42
+ - **Interactive indicators & borders:** Must achieve Lc > 45.
40
43
 
41
44
  ### 3. Keyboard Navigation & Focus Visibility
42
- * **Focus Ring (WCAG 2.4.13 - Level AA):** Visible focus rings must achieve 3:1 contrast and cannot be hidden (`outline: none` is forbidden).
43
- * **Focus Trap (WCAG 2.1.2):** All overlay modals, slide-out panels, and drawers must trap focus internally and return it to the trigger element on close.
44
- * **Semantic Tab Order:** Tab navigation must match the visual layout reading flow.
45
+
46
+ - **Focus Ring (WCAG 2.4.13 - Level AA):** Visible focus rings must achieve 3:1 contrast and cannot be hidden (`outline: none` is forbidden).
47
+ - **Focus Trap (WCAG 2.1.2):** All overlay modals, slide-out panels, and drawers must trap focus internally and return it to the trigger element on close.
48
+ - **Semantic Tab Order:** Tab navigation must match the visual layout reading flow.
45
49
 
46
50
  ### 4. Semantic Markup & ARIA Semantics (WCAG 4.1.2)
47
- * **Interactive Tags:** Clickable elements must use native `<button>` or `<a>` tags. Avoid `<div onClick>`.
48
- * **Label Association (WCAG 1.3.1):** All input elements must be linked to a `<label htmlFor="...">`. Placeholders are not labels.
49
- * **Accessible Name:** Icon-only buttons must declare an `aria-label` or `aria-labelledby` property.
51
+
52
+ - **Interactive Tags:** Clickable elements must use native `<button>` or `<a>` tags. Avoid `<div onClick>`.
53
+ - **Label Association (WCAG 1.3.1):** All input elements must be linked to a `<label htmlFor="...">`. Placeholders are not labels.
54
+ - **Accessible Name:** Icon-only buttons must declare an `aria-label` or `aria-labelledby` property.
50
55
 
51
56
  ---
52
57
 
53
58
  ## Code Comparison Examples
54
59
 
55
60
  ### Target Size (Minimum) Violation
61
+
56
62
  ```tsx
57
63
  // ❌ REJECTED: Small 14x14px click area, no padding buffer. Fails WCAG 2.5.8.
58
64
  <button onClick={onClose} className="w-3.5 h-3.5 bg-red-500 rounded-full" />
59
65
 
60
66
  // ✅ APPROVED: Visual area remains small (w-3.5 h-3.5), but absolute touch target is expanded to 44x44px
61
- <button
62
- onClick={onClose}
67
+ <button
68
+ onClick={onClose}
63
69
  aria-label="Close alert"
64
70
  className="relative p-3 hover:bg-[var(--bg-surface-raised)] rounded-full transition-all"
65
71
  >
@@ -68,6 +74,7 @@ Before auditing accessibility, you MUST inspect:
68
74
  ```
69
75
 
70
76
  ### Contrast Violation
77
+
71
78
  ```tsx
72
79
  // ❌ REJECTED: Gray text on white background yields contrast ratio of 2.2:1 (Lc <40).
73
80
  <p className="text-gray-300 bg-white text-xs">Secondary description</p>
@@ -21,6 +21,7 @@ Every piece of code that calls an LLM API must be verified against the actual pr
21
21
  ## Mandatory Pre-Flight Context Inspection
22
22
 
23
23
  Before auditing LLM integration code, you MUST inspect:
24
+
24
25
  1. `package.json` / `requirements.txt` → Check LLM SDK versions (`openai`, `@anthropic-ai/sdk`, `@google/genai`, `ai` Vercel AI SDK)
25
26
  2. Environment configs → Confirm model name strings are parameterized (`process.env.MODEL_NAME`) rather than hardcoded strings
26
27
  3. Prompt templates → Audit user input sanitization delimiters (`<user_input>`) and prompt injection boundaries
@@ -48,21 +49,21 @@ Flag any model name that cannot be verified in the provider's current model docu
48
49
  ```typescript
49
50
  // ❌ HALLUCINATED: Parameters that don't exist in OpenAI SDK
50
51
  const response = await openai.chat.completions.create({
51
- model: "gpt-4o",
52
+ model: 'gpt-4o',
52
53
  messages,
53
54
  max_length: 1000, // Hallucinated — use max_tokens
54
- format: "json", // Hallucinated — use response_format: { type: 'json_object' }
55
+ format: 'json', // Hallucinated — use response_format: { type: 'json_object' }
55
56
  memory: true, // Doesn't exist
56
- plugins: ["web-search"], // Doesn't exist in API
57
- instructions: "Be helpful", // Hallucinated — belongs in system message
57
+ plugins: ['web-search'], // Doesn't exist in API
58
+ instructions: 'Be helpful', // Hallucinated — belongs in system message
58
59
  });
59
60
 
60
61
  // ✅ REAL OpenAI API parameters
61
62
  const response = await openai.chat.completions.create({
62
- model: "gpt-4o",
63
+ model: 'gpt-4o',
63
64
  messages,
64
65
  max_tokens: 1000,
65
- response_format: { type: "json_object" },
66
+ response_format: { type: 'json_object' },
66
67
  temperature: 0.7,
67
68
  stream: false,
68
69
  });
@@ -71,17 +72,17 @@ const response = await openai.chat.completions.create({
71
72
  ```typescript
72
73
  // ❌ HALLUCINATED: Anthropic SDK parameters
73
74
  const message = await anthropic.messages.create({
74
- model: "claude-3-5-sonnet-20241022",
75
+ model: 'claude-3-5-sonnet-20241022',
75
76
  messages,
76
77
  max_response: 1024, // Hallucinated — use max_tokens
77
- system_prompt: "...", // Hallucinated — 'system' is a top-level param
78
+ system_prompt: '...', // Hallucinated — 'system' is a top-level param
78
79
  });
79
80
 
80
81
  // ✅ REAL Anthropic API
81
82
  const message = await anthropic.messages.create({
82
- model: "claude-3-5-sonnet-20241022",
83
+ model: 'claude-3-5-sonnet-20241022',
83
84
  max_tokens: 1024,
84
- system: "You are a helpful assistant.",
85
+ system: 'You are a helpful assistant.',
85
86
  messages,
86
87
  });
87
88
  ```
@@ -97,13 +98,16 @@ const systemPrompt = `You are a helpful assistant. Context: ${userInput}`;
97
98
 
98
99
  // ❌ CRITICAL: User content in system role message
99
100
  const messages = [
100
- { role: "system", content: userQuery }, // User can override system behavior
101
+ { role: 'system', content: userQuery }, // User can override system behavior
101
102
  ];
102
103
 
103
104
  // ✅ SAFE: Strict role separation
104
105
  const messages = [
105
- { role: "system", content: "You are a helpful assistant. Only answer questions about our product." },
106
- { role: "user", content: userQuery }, // User input isolated to user role
106
+ {
107
+ role: 'system',
108
+ content: 'You are a helpful assistant. Only answer questions about our product.',
109
+ },
110
+ { role: 'user', content: userQuery }, // User input isolated to user role
107
111
  ];
108
112
 
109
113
  // ✅ SAFE: XML delimiting when injection context unavoidable
@@ -155,14 +159,14 @@ try {
155
159
  const allUsers = await prisma.user.findMany(); // 50,000 users
156
160
  const response = await openai.chat.completions.create({
157
161
  messages: [
158
- { role: "user", content: `Users: ${JSON.stringify(allUsers)}\n${userQuery}` },
162
+ { role: 'user', content: `Users: ${JSON.stringify(allUsers)}\n${userQuery}` },
159
163
  // This could be 200,000 tokens per request!
160
164
  ],
161
165
  });
162
166
 
163
167
  // ❌ COST EXPLOSION: No max_tokens limit on user-facing endpoint
164
168
  const response = await anthropic.messages.create({
165
- model: "claude-3-5-sonnet-20241022",
169
+ model: 'claude-3-5-sonnet-20241022',
166
170
  // Missing max_tokens — model can run indefinitely
167
171
  messages,
168
172
  });
@@ -170,11 +174,11 @@ const response = await anthropic.messages.create({
170
174
  // ✅ APPROVED: Token budgeting + RAG for large datasets
171
175
  const relevantChunks = await vectorStore.similaritySearch(userQuery, 5); // Retrieve top 5
172
176
  const response = await openai.chat.completions.create({
173
- model: "gpt-4o-mini", // Cost-efficient model for routing
177
+ model: 'gpt-4o-mini', // Cost-efficient model for routing
174
178
  max_tokens: 500, // Hard cap prevents runaway responses
175
179
  messages: [
176
- { role: "system", content: `Context:\n${relevantChunks.map((c) => c.content).join("\n")}` },
177
- { role: "user", content: userQuery },
180
+ { role: 'system', content: `Context:\n${relevantChunks.map(c => c.content).join('\n')}` },
181
+ { role: 'user', content: userQuery },
178
182
  ],
179
183
  });
180
184
  ```
@@ -186,12 +190,12 @@ const response = await openai.chat.completions.create({
186
190
  ```typescript
187
191
  // ❌ REJECTED: Conversation history appended unbounded — will eventually overflow
188
192
  const messages = conversationHistory; // Can grow to 100k+ tokens
189
- messages.push({ role: "user", content: newMessage });
193
+ messages.push({ role: 'user', content: newMessage });
190
194
  const response = await client.chat(messages);
191
195
 
192
196
  // ✅ APPROVED: Sliding window with token counting
193
- import { encoding_for_model } from "tiktoken";
194
- const enc = encoding_for_model("gpt-4o");
197
+ import { encoding_for_model } from 'tiktoken';
198
+ const enc = encoding_for_model('gpt-4o');
195
199
 
196
200
  function trimToTokenLimit(messages: Message[], limit: number = 100_000): Message[] {
197
201
  let totalTokens = 0;
@@ -17,6 +17,7 @@ You enforce originality and build quality. You systematically block generic AI a
17
17
  ## Mandatory Pre-Flight Context Inspection
18
18
 
19
19
  Before auditing UI aesthetics, you MUST inspect:
20
+
20
21
  1. `index.css` / CSS variables / Tailwind config → Check color palette definitions (verify non-purple primary colors and custom design tokens)
21
22
  2. UI component library configs (`components.json`, `theme/`) → Verify customized radius, typography, and shadow tokens
22
23
  3. Visual layout files → Check for asymmetrical column balance vs generic repetitive cards
@@ -26,21 +27,24 @@ Before auditing UI aesthetics, you MUST inspect:
26
27
  ## What This Reviewer Catches
27
28
 
28
29
  ### ❌ REJECTED Criteria (Blocking)
29
- * **The Purple Primary Cliché:** Using purple/violet (`#7C3AED`, `#8B5CF6`, `oklch(... 280 ... / 290Hue)`) as the primary brand/interaction color.
30
- * **Mesh Gradient Cliché:** Using radial mesh gradients with multiple high-saturation blur stops as hero backgrounds.
31
- * **Bento Grid Overuse:** Structuring an entire page layout as a grid of identical rounded cards without visual break or tension.
32
- * **Glassmorphism Overuse:** Applying backdrop-blur panels and translucent layers for primary containers instead of clean solid surfaces.
33
- * **Card-inside-Card Overlap:** Embedding cards within cards without distinct backgrounds or border elevations, resulting in muddy visual hierarchy.
30
+
31
+ - **The Purple Primary Cliché:** Using purple/violet (`#7C3AED`, `#8B5CF6`, `oklch(... 280 ... / 290Hue)`) as the primary brand/interaction color.
32
+ - **Mesh Gradient Cliché:** Using radial mesh gradients with multiple high-saturation blur stops as hero backgrounds.
33
+ - **Bento Grid Overuse:** Structuring an entire page layout as a grid of identical rounded cards without visual break or tension.
34
+ - **Glassmorphism Overuse:** Applying backdrop-blur panels and translucent layers for primary containers instead of clean solid surfaces.
35
+ - **Card-inside-Card Overlap:** Embedding cards within cards without distinct backgrounds or border elevations, resulting in muddy visual hierarchy.
34
36
 
35
37
  ### ⚠️ WARNING Criteria (Non-blocking)
36
- * *Default Library Styles:* Using default, uncustomized colors/radii from tailwind or shadcn/ui.
37
- * *Centered Hero:* Uninspired "centered title + centered paragraph + centered CTA button" layouts.
38
+
39
+ - _Default Library Styles:_ Using default, uncustomized colors/radii from tailwind or shadcn/ui.
40
+ - _Centered Hero:_ Uninspired "centered title + centered paragraph + centered CTA button" layouts.
38
41
 
39
42
  ---
40
43
 
41
44
  ## Code Comparison Examples
42
45
 
43
46
  ### Purple Gradient vs. Sophisticated Tinted Depth
47
+
44
48
  ```css
45
49
  /* ❌ REJECTED: Overused purple gradient background */
46
50
  .card-ai {
@@ -56,6 +60,7 @@ Before auditing UI aesthetics, you MUST inspect:
56
60
  ```
57
61
 
58
62
  ### Bento Overuse vs. Asymmetrical Grid Balance
63
+
59
64
  ```tsx
60
65
  // ❌ REJECTED: Repetitive, identical rounded bento boxes for layout
61
66
  <div className="grid grid-cols-3 gap-4">