tribunal-kit 9.2.5 โ†’ 9.2.7

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 (902) hide show
  1. package/.agent/ADRs/ADR-001-system-architecture-intelligence.md +1 -1
  2. package/.agent/ARCHITECTURE.md +4 -4
  3. package/.agent/agents/agent-shield-auditor.md +4 -1
  4. package/.agent/agents/anti-slop-auditor.md +79 -0
  5. package/.agent/agents/api-architect.md +5 -0
  6. package/.agent/agents/architecture-auditor.md +20 -19
  7. package/.agent/agents/backend-security-architect.md +115 -0
  8. package/.agent/agents/frontend-reviewer.md +2 -0
  9. package/.agent/agents/frontend-specialist.md +2 -1
  10. package/.agent/agents/harness-manager.md +8 -0
  11. package/.agent/agents/human-gate-negotiator.md +6 -2
  12. package/.agent/agents/kernel-scheduler.md +4 -0
  13. package/.agent/agents/memory-archivist.md +5 -0
  14. package/.agent/agents/orchestrator.md +0 -1
  15. package/.agent/agents/project-planner.md +0 -1
  16. package/.agent/agents/security-auditor.md +0 -1
  17. package/.agent/agents/system-architect.md +15 -1
  18. package/.agent/agents/ui-ux-auditor.md +5 -0
  19. package/.agent/agents/ui-visual-auditor.md +5 -0
  20. package/.agent/config/claude.json +2 -2
  21. package/.agent/config/plugin.json +2 -2
  22. package/.agent/config/system-prompt.md +1 -1
  23. package/.agent/history/architecture-intelligence.html +1880 -0
  24. package/.agent/history/architecture-model.json +19764 -0
  25. package/.agent/history/architecture-verification.json +50 -0
  26. package/.agent/history/integrity_manifest.json +1905 -0
  27. package/.agent/plans/implementation_plan.md +15 -8
  28. package/.agent/plans/task.md +6 -0
  29. package/.agent/routing_index.json +31 -22
  30. package/.agent/rules/GEMINI.md +1 -1
  31. package/.agent/rules/kernel.md +16 -13
  32. package/.agent/scripts/_utils.js +6 -1
  33. package/.agent/scripts/ab_json_experiment.js +129 -0
  34. package/.agent/scripts/adaptive_execution.js +511 -0
  35. package/.agent/scripts/architecture_diff.js +303 -0
  36. package/.agent/scripts/architecture_extractor.js +792 -0
  37. package/.agent/scripts/architecture_health.js +293 -0
  38. package/.agent/scripts/architecture_intelligence.js +3100 -0
  39. package/.agent/scripts/architecture_mapper.js +91 -25
  40. package/.agent/scripts/architecture_verifier.js +303 -0
  41. package/.agent/scripts/architecture_visualizer.js +880 -0
  42. package/.agent/scripts/backend_audit.js +238 -0
  43. package/.agent/scripts/backend_report_generator.js +161 -0
  44. package/.agent/scripts/benchmark_suite.js +493 -0
  45. package/.agent/scripts/blast_radius_engine.js +274 -0
  46. package/.agent/scripts/capability_evolution.js +453 -0
  47. package/.agent/scripts/checklist.js +8 -4
  48. package/.agent/scripts/concept_extractor.js +240 -0
  49. package/.agent/scripts/consideration_engine.js +284 -0
  50. package/.agent/scripts/consolidation_experiment.js +543 -0
  51. package/.agent/scripts/context_compiler.js +49 -18
  52. package/.agent/scripts/coverage_engine.js +102 -0
  53. package/.agent/scripts/cross_agent_correlator.js +223 -0
  54. package/.agent/scripts/cross_domain_engine.js +1883 -0
  55. package/.agent/scripts/dependency_analyzer.js +26 -4
  56. package/.agent/scripts/engineering_memory.js +1313 -0
  57. package/.agent/scripts/evidence_verifier.js +171 -0
  58. package/.agent/scripts/finding_schema.js +104 -0
  59. package/.agent/scripts/findings_validator.js +147 -0
  60. package/.agent/scripts/guardrail_engine.js +43 -24
  61. package/.agent/scripts/harness_manager.js +30 -18
  62. package/.agent/scripts/impact_classifier.js +6 -5
  63. package/.agent/scripts/integrity_manifest.js +45 -9
  64. package/.agent/scripts/judgment_engine.js +790 -0
  65. package/.agent/scripts/lint_runner.js +4 -2
  66. package/.agent/scripts/live_abc_benchmark.js +452 -0
  67. package/.agent/scripts/materiality_engine.js +251 -0
  68. package/.agent/scripts/mcp_server.js +81 -59
  69. package/.agent/scripts/memory_archivist.js +18 -12
  70. package/.agent/scripts/memory_consolidator.js +6 -6
  71. package/.agent/scripts/memory_engine.js +33 -17
  72. package/.agent/scripts/outcome_engine.js +624 -0
  73. package/.agent/scripts/outcome_optimization_engine.js +1632 -0
  74. package/.agent/scripts/pipeline_engine.js +26 -11
  75. package/.agent/scripts/secret_redactor.js +119 -0
  76. package/.agent/scripts/session_logger.js +4 -4
  77. package/.agent/scripts/session_manager.js +6 -1
  78. package/.agent/scripts/simulation_engine.js +1478 -0
  79. package/.agent/scripts/skill_intelligence.js +1371 -0
  80. package/.agent/scripts/swarm_dispatcher.js +29 -20
  81. package/.agent/scripts/syscall_registry.js +28 -23
  82. package/.agent/scripts/test_runner.js +1 -1
  83. package/.agent/scripts/tier3_audit.js +195 -0
  84. package/.agent/scripts/validation_engine.js +236 -0
  85. package/.agent/scripts/verification_auditor.js +266 -0
  86. package/.agent/scripts/verify_all.js +5 -3
  87. package/.agent/skill-intelligence/taxonomy/engineering-concepts.json +555 -0
  88. package/.agent/skill_topic_map.json +133 -146
  89. package/.agent/skills/12-principles-of-animation/SKILL.md +92 -22
  90. package/.agent/skills/60fps-animation/SKILL.md +83 -26
  91. package/.agent/skills/accessible-animation/SKILL.md +93 -31
  92. package/.agent/skills/adapt/SKILL.md +92 -22
  93. package/.agent/skills/adr-generation/SKILL.md +88 -12
  94. package/.agent/skills/advanced-rag-pipelines/SKILL.md +83 -22
  95. package/.agent/skills/agent-organizer/SKILL.md +85 -27
  96. package/.agent/skills/agent-syscall-guidelines/SKILL.md +100 -25
  97. package/.agent/skills/agentic-patterns/SKILL.md +93 -23
  98. package/.agent/skills/agentic-workflows-2026/SKILL.md +92 -20
  99. package/.agent/skills/agentshield-security/SKILL.md +85 -26
  100. package/.agent/skills/ai-app-hardening/SKILL.md +92 -20
  101. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +83 -22
  102. package/.agent/skills/animation-on-scroll/SKILL.md +93 -31
  103. package/.agent/skills/animation-systems/SKILL.md +93 -31
  104. package/.agent/skills/antfu-conventions/SKILL.md +92 -22
  105. package/.agent/skills/anti-slop-enforcement/SKILL.md +118 -0
  106. package/.agent/skills/api-patterns/SKILL.md +83 -22
  107. package/.agent/skills/api-security-auditor/SKILL.md +102 -24
  108. package/.agent/skills/app-builder/SKILL.md +85 -30
  109. package/.agent/skills/appflow-wireframe/SKILL.md +78 -18
  110. package/.agent/skills/apple-design/SKILL.md +92 -22
  111. package/.agent/skills/architecture/SKILL.md +83 -22
  112. package/.agent/skills/architecture-drift/SKILL.md +88 -12
  113. package/.agent/skills/architecture-intelligence/SKILL.md +53 -0
  114. package/.agent/skills/audit-and-fix/SKILL.md +95 -25
  115. package/.agent/skills/authentication-best-practices/SKILL.md +92 -22
  116. package/.agent/skills/autonomous-execution/SKILL.md +86 -8
  117. package/.agent/skills/backend-alembic/SKILL.md +91 -0
  118. package/.agent/skills/backend-architecture-auditor/SKILL.md +101 -0
  119. package/.agent/skills/backend-mongodb/SKILL.md +133 -0
  120. package/.agent/skills/backend-mysql/SKILL.md +84 -0
  121. package/.agent/skills/backend-performance-auditor/SKILL.md +100 -0
  122. package/.agent/skills/backend-postgresql/SKILL.md +117 -0
  123. package/.agent/skills/backend-redis/SKILL.md +122 -0
  124. package/.agent/skills/backend-security-expert/SKILL.md +83 -22
  125. package/.agent/skills/backend-sqlalchemy/SKILL.md +107 -0
  126. package/.agent/skills/backend-sqlite/SKILL.md +93 -0
  127. package/.agent/skills/backend-testing-auditor/SKILL.md +113 -0
  128. package/.agent/skills/baseline-ui/SKILL.md +92 -22
  129. package/.agent/skills/bash-linux/SKILL.md +84 -26
  130. package/.agent/skills/behavioral-modes/SKILL.md +93 -23
  131. package/.agent/skills/better-colors/SKILL.md +92 -22
  132. package/.agent/skills/better-typography/SKILL.md +88 -18
  133. package/.agent/skills/better-ui/SKILL.md +83 -22
  134. package/.agent/skills/bolder/SKILL.md +92 -22
  135. package/.agent/skills/brainstorming/SKILL.md +83 -23
  136. package/.agent/skills/browser-audit/SKILL.md +94 -24
  137. package/.agent/skills/browser-native-ai/SKILL.md +92 -22
  138. package/.agent/skills/build-primitive/SKILL.md +92 -22
  139. package/.agent/skills/building-native-ui/SKILL.md +83 -22
  140. package/.agent/skills/cicd-pro/SKILL.md +83 -22
  141. package/.agent/skills/clarify/SKILL.md +92 -22
  142. package/.agent/skills/clean-code/SKILL.md +83 -22
  143. package/.agent/skills/cloud-architect/SKILL.md +83 -22
  144. package/.agent/skills/cobejs/SKILL.md +92 -22
  145. package/.agent/skills/code-review-checklist/SKILL.md +92 -22
  146. package/.agent/skills/codebase-design/SKILL.md +83 -22
  147. package/.agent/skills/colorize/SKILL.md +92 -22
  148. package/.agent/skills/compact-landing/SKILL.md +92 -22
  149. package/.agent/skills/company-logos/SKILL.md +92 -22
  150. package/.agent/skills/config-validator/SKILL.md +84 -26
  151. package/.agent/skills/containerization-pro/SKILL.md +83 -22
  152. package/.agent/skills/context-engineering-pro/SKILL.md +92 -20
  153. package/.agent/skills/create-design-md/SKILL.md +92 -22
  154. package/.agent/skills/critique/SKILL.md +93 -23
  155. package/.agent/skills/csharp-developer/SKILL.md +92 -22
  156. package/.agent/skills/data-validation-schemas/SKILL.md +84 -26
  157. package/.agent/skills/database-design/SKILL.md +83 -22
  158. package/.agent/skills/delight/SKILL.md +92 -22
  159. package/.agent/skills/deployment-procedures/SKILL.md +84 -26
  160. package/.agent/skills/design-lab/SKILL.md +93 -23
  161. package/.agent/skills/devops-engineer/SKILL.md +92 -22
  162. package/.agent/skills/devops-incident-responder/SKILL.md +84 -26
  163. package/.agent/skills/diagnosing-bugs/SKILL.md +93 -23
  164. package/.agent/skills/distill/SKILL.md +92 -22
  165. package/.agent/skills/documentation-templates/SKILL.md +84 -26
  166. package/.agent/skills/domain-modeling/SKILL.md +92 -22
  167. package/.agent/skills/duckdb-analytical-sql/SKILL.md +91 -19
  168. package/.agent/skills/edge-ai-mobile/SKILL.md +91 -19
  169. package/.agent/skills/edge-computing/SKILL.md +84 -26
  170. package/.agent/skills/emil-design-eng/SKILL.md +92 -22
  171. package/.agent/skills/error-resilience/SKILL.md +83 -22
  172. package/.agent/skills/expo-router-v4/SKILL.md +90 -18
  173. package/.agent/skills/extract-design-system/SKILL.md +84 -26
  174. package/.agent/skills/fabel-protocol/SKILL.md +93 -23
  175. package/.agent/skills/failure-mode-analysis/SKILL.md +88 -12
  176. package/.agent/skills/fastapi-pro/SKILL.md +123 -0
  177. package/.agent/skills/fixing-accessibility/SKILL.md +92 -22
  178. package/.agent/skills/fixing-metadata/SKILL.md +92 -22
  179. package/.agent/skills/fixing-motion-performance/SKILL.md +92 -22
  180. package/.agent/skills/framer-motion-expert/SKILL.md +85 -30
  181. package/.agent/skills/frontend-design/SKILL.md +92 -22
  182. package/.agent/skills/frontend-security-expert/SKILL.md +83 -22
  183. package/.agent/skills/game-design-expert/SKILL.md +84 -26
  184. package/.agent/skills/game-engineering-expert/SKILL.md +84 -26
  185. package/.agent/skills/generative-ui-expert/SKILL.md +92 -22
  186. package/.agent/skills/geo-fundamentals/SKILL.md +84 -26
  187. package/.agent/skills/git-pro/SKILL.md +83 -22
  188. package/.agent/skills/github-operations/SKILL.md +92 -22
  189. package/.agent/skills/gpt-taste/SKILL.md +92 -22
  190. package/.agent/skills/graph-engineering/SKILL.md +116 -28
  191. package/.agent/skills/gsap-core/SKILL.md +92 -22
  192. package/.agent/skills/gsap-frameworks/SKILL.md +92 -22
  193. package/.agent/skills/gsap-performance/SKILL.md +92 -22
  194. package/.agent/skills/gsap-plugins/SKILL.md +92 -22
  195. package/.agent/skills/gsap-react/SKILL.md +92 -22
  196. package/.agent/skills/gsap-scrolltrigger/SKILL.md +92 -22
  197. package/.agent/skills/gsap-timeline/SKILL.md +92 -22
  198. package/.agent/skills/gsap-utils/SKILL.md +92 -22
  199. package/.agent/skills/harden/SKILL.md +92 -22
  200. package/.agent/skills/harness-protocol/SKILL.md +93 -23
  201. package/.agent/skills/hf-cli/SKILL.md +86 -6
  202. package/.agent/skills/hf-cloud-aws-context-discovery/SKILL.md +86 -8
  203. package/.agent/skills/hf-cloud-python-env-setup/SKILL.md +86 -8
  204. package/.agent/skills/hf-cloud-sagemaker-deployment-planner/SKILL.md +86 -8
  205. package/.agent/skills/hf-cloud-sagemaker-iam-preflight/SKILL.md +86 -8
  206. package/.agent/skills/hf-cloud-sagemaker-production-defaults/SKILL.md +86 -8
  207. package/.agent/skills/hf-cloud-serving-image-selection/SKILL.md +86 -8
  208. package/.agent/skills/hf-mem/SKILL.md +86 -6
  209. package/.agent/skills/huggingface-best/SKILL.md +86 -16
  210. package/.agent/skills/huggingface-community-evals/SKILL.md +86 -8
  211. package/.agent/skills/huggingface-datasets/SKILL.md +86 -8
  212. package/.agent/skills/huggingface-gradio/SKILL.md +86 -8
  213. package/.agent/skills/huggingface-llm-trainer/SKILL.md +86 -9
  214. package/.agent/skills/huggingface-local-models/SKILL.md +86 -8
  215. package/.agent/skills/huggingface-lora-space-builder/SKILL.md +86 -8
  216. package/.agent/skills/huggingface-paper-publisher/SKILL.md +86 -7
  217. package/.agent/skills/huggingface-papers/SKILL.md +86 -8
  218. package/.agent/skills/huggingface-spaces/SKILL.md +86 -8
  219. package/.agent/skills/huggingface-tool-builder/SKILL.md +86 -8
  220. package/.agent/skills/huggingface-trackio/SKILL.md +77 -8
  221. package/.agent/skills/huggingface-vision-trainer/SKILL.md +86 -8
  222. package/.agent/skills/huggingface-zerogpu/SKILL.md +86 -8
  223. package/.agent/skills/human-gate-negotiation/SKILL.md +96 -30
  224. package/.agent/skills/i18n-localization/SKILL.md +84 -26
  225. package/.agent/skills/impeccable/SKILL.md +92 -22
  226. package/.agent/skills/improve-codebase-architecture/SKILL.md +92 -22
  227. package/.agent/skills/improve-ui/SKILL.md +92 -22
  228. package/.agent/skills/intelligent-routing/SKILL.md +81 -18
  229. package/.agent/skills/knowledge-graph/SKILL.md +94 -24
  230. package/.agent/skills/landing-page/SKILL.md +93 -23
  231. package/.agent/skills/lint-and-validate/SKILL.md +84 -26
  232. package/.agent/skills/llm-engineering/SKILL.md +92 -22
  233. package/.agent/skills/local-first/SKILL.md +84 -26
  234. package/.agent/skills/local-first-architecture/SKILL.md +83 -22
  235. package/.agent/skills/lottie-animation/SKILL.md +92 -22
  236. package/.agent/skills/marquee-loop/SKILL.md +92 -22
  237. package/.agent/skills/masked-reveal/SKILL.md +93 -24
  238. package/.agent/skills/mcp-builder/SKILL.md +84 -26
  239. package/.agent/skills/micro-interaction/SKILL.md +93 -31
  240. package/.agent/skills/mobile-design/SKILL.md +83 -22
  241. package/.agent/skills/monorepo-management/SKILL.md +84 -26
  242. package/.agent/skills/morphing-icons/SKILL.md +93 -24
  243. package/.agent/skills/motion-engineering/SKILL.md +84 -23
  244. package/.agent/skills/nextjs-react-expert/SKILL.md +83 -22
  245. package/.agent/skills/nodejs-best-practices/SKILL.md +83 -22
  246. package/.agent/skills/observability/SKILL.md +92 -22
  247. package/.agent/skills/opentelemetry-observability/SKILL.md +91 -19
  248. package/.agent/skills/page-transition-animation/SKILL.md +92 -22
  249. package/.agent/skills/parallel-agents/SKILL.md +85 -27
  250. package/.agent/skills/performance-profiling/SKILL.md +93 -23
  251. package/.agent/skills/plan-writing/SKILL.md +83 -22
  252. package/.agent/skills/platform-engineer/SKILL.md +84 -26
  253. package/.agent/skills/platform-engineering-opentofu/SKILL.md +91 -19
  254. package/.agent/skills/playwright-ai-e2e/SKILL.md +92 -20
  255. package/.agent/skills/playwright-best-practices/SKILL.md +85 -27
  256. package/.agent/skills/polish/SKILL.md +92 -22
  257. package/.agent/skills/powershell-windows/SKILL.md +92 -22
  258. package/.agent/skills/pricing-page/SKILL.md +92 -22
  259. package/.agent/skills/product-aware-heuristics/SKILL.md +93 -23
  260. package/.agent/skills/progressive-blur/SKILL.md +92 -22
  261. package/.agent/skills/project-idioms/SKILL.md +93 -23
  262. package/.agent/skills/property-based-testing/SKILL.md +92 -20
  263. package/.agent/skills/python-patterns/SKILL.md +84 -26
  264. package/.agent/skills/python-pro/SKILL.md +83 -22
  265. package/.agent/skills/quieter/SKILL.md +92 -22
  266. package/.agent/skills/react-doctor/SKILL.md +92 -22
  267. package/.agent/skills/react-specialist/SKILL.md +83 -22
  268. package/.agent/skills/readme-builder/SKILL.md +84 -26
  269. package/.agent/skills/realtime-patterns/SKILL.md +92 -22
  270. package/.agent/skills/red-team-tactics/SKILL.md +83 -22
  271. package/.agent/skills/redesign-skill/SKILL.md +92 -22
  272. package/.agent/skills/review-animations/SKILL.md +92 -22
  273. package/.agent/skills/rust-pro/SKILL.md +83 -22
  274. package/.agent/skills/semantic-filesystem-navigation/SKILL.md +79 -24
  275. package/.agent/skills/seo-fundamentals/SKILL.md +84 -26
  276. package/.agent/skills/server-management/SKILL.md +84 -26
  277. package/.agent/skills/session-log-interrogation/SKILL.md +81 -29
  278. package/.agent/skills/shadcn-ui-expert/SKILL.md +84 -26
  279. package/.agent/skills/shape/SKILL.md +93 -23
  280. package/.agent/skills/skill-creator/SKILL.md +88 -20
  281. package/.agent/skills/soft-skill/SKILL.md +92 -22
  282. package/.agent/skills/sounds-on-the-web/SKILL.md +92 -22
  283. package/.agent/skills/sql-pro/SKILL.md +83 -22
  284. package/.agent/skills/subagent-driven-development/SKILL.md +92 -32
  285. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +83 -22
  286. package/.agent/skills/svg-animation/SKILL.md +93 -24
  287. package/.agent/skills/swiftui-expert/SKILL.md +84 -26
  288. package/.agent/skills/swiss-design/SKILL.md +92 -22
  289. package/.agent/skills/system-design-pro/SKILL.md +90 -16
  290. package/.agent/skills/systematic-debugging/SKILL.md +85 -27
  291. package/.agent/skills/tailwind-patterns/SKILL.md +92 -22
  292. package/.agent/skills/taste-skill/SKILL.md +92 -22
  293. package/.agent/skills/tdd-workflow/SKILL.md +84 -23
  294. package/.agent/skills/test-result-analyzer/SKILL.md +93 -23
  295. package/.agent/skills/testing-patterns/SKILL.md +93 -23
  296. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +92 -22
  297. package/.agent/skills/thinking-protocol/SKILL.md +79 -21
  298. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +92 -22
  299. package/.agent/skills/train-sentence-transformers/SKILL.md +86 -8
  300. package/.agent/skills/transformers-js/SKILL.md +86 -15
  301. package/.agent/skills/transitions-dev/SKILL.md +92 -22
  302. package/.agent/skills/trend-researcher/SKILL.md +92 -22
  303. package/.agent/skills/tribunal-instincts-memory/SKILL.md +86 -31
  304. package/.agent/skills/trl-training/SKILL.md +86 -16
  305. package/.agent/skills/typescript-advanced/SKILL.md +83 -22
  306. package/.agent/skills/typeset/SKILL.md +92 -22
  307. package/.agent/skills/ui-reasoning-engine/SKILL.md +93 -23
  308. package/.agent/skills/ui-skill-packs/SKILL.md +94 -24
  309. package/.agent/skills/ui-skills-root/SKILL.md +94 -24
  310. package/.agent/skills/ui-ux-pro-max/SKILL.md +93 -23
  311. package/.agent/skills/ui-ux-researcher/SKILL.md +92 -22
  312. package/.agent/skills/vector-search-pgvector/SKILL.md +91 -19
  313. package/.agent/skills/verification-before-completion/SKILL.md +90 -18
  314. package/.agent/skills/vue-expert/SKILL.md +83 -22
  315. package/.agent/skills/vulnerability-scanner/SKILL.md +93 -26
  316. package/.agent/skills/web-accessibility-auditor/SKILL.md +84 -26
  317. package/.agent/skills/web-design-guidelines/SKILL.md +92 -22
  318. package/.agent/skills/web-quality-audit/SKILL.md +92 -22
  319. package/.agent/skills/webapp-testing/SKILL.md +85 -27
  320. package/.agent/skills/webgpu-performance/SKILL.md +92 -22
  321. package/.agent/skills/whimsy-injector/SKILL.md +93 -23
  322. package/.agent/skills/workflow-optimizer/SKILL.md +93 -23
  323. package/.agent/skills/zero-trust-passkeys/SKILL.md +91 -19
  324. package/.agent/skills_inventory.json +4272 -0
  325. package/.agent/workflows/arch.md +96 -0
  326. package/.agent/workflows/assimilate.md +4 -1
  327. package/.agent/workflows/audit.md +0 -1
  328. package/.agent/workflows/generate.md +26 -21
  329. package/.agent/workflows/htop.md +5 -1
  330. package/.agent/workflows/marathon.md +0 -1
  331. package/.agent/workflows/resume.md +5 -2
  332. package/.agent/workflows/skill-enhancement-engine.md +1 -1
  333. package/.agent/workflows/skill-intelligence.md +216 -0
  334. package/.agent/workflows/team-mode.md +4 -1
  335. package/.agent/workflows/tribunal-backend.md +19 -7
  336. package/.agent/workflows/tribunal-frontend.md +6 -0
  337. package/.agent/workflows/tribunal-ui.md +5 -0
  338. package/.agents/skills/12-principles-of-animation/SKILL.md +92 -22
  339. package/.agents/skills/60fps-animation/SKILL.md +83 -26
  340. package/.agents/skills/accessible-animation/SKILL.md +93 -31
  341. package/.agents/skills/adapt/SKILL.md +92 -22
  342. package/.agents/skills/adr-generation/SKILL.md +88 -12
  343. package/.agents/skills/advanced-rag-pipelines/SKILL.md +83 -22
  344. package/.agents/skills/agent-organizer/SKILL.md +85 -27
  345. package/.agents/skills/agent-syscall-guidelines/SKILL.md +100 -25
  346. package/.agents/skills/agentic-patterns/SKILL.md +93 -23
  347. package/.agents/skills/agentic-workflows-2026/SKILL.md +92 -20
  348. package/.agents/skills/agentshield-security/SKILL.md +85 -26
  349. package/.agents/skills/ai-app-hardening/SKILL.md +92 -20
  350. package/.agents/skills/ai-prompt-injection-defense/SKILL.md +83 -22
  351. package/.agents/skills/animation-on-scroll/SKILL.md +93 -31
  352. package/.agents/skills/animation-systems/SKILL.md +93 -31
  353. package/.agents/skills/antfu-conventions/SKILL.md +92 -22
  354. package/.agents/skills/anti-slop-enforcement/SKILL.md +118 -0
  355. package/.agents/skills/api-patterns/SKILL.md +83 -22
  356. package/.agents/skills/api-security-auditor/SKILL.md +102 -24
  357. package/.agents/skills/app-builder/SKILL.md +85 -30
  358. package/.agents/skills/appflow-wireframe/SKILL.md +78 -18
  359. package/.agents/skills/apple-design/SKILL.md +92 -22
  360. package/.agents/skills/architecture/SKILL.md +83 -22
  361. package/.agents/skills/architecture-drift/SKILL.md +88 -12
  362. package/.agents/skills/architecture-intelligence/SKILL.md +53 -0
  363. package/.agents/skills/audit-and-fix/SKILL.md +95 -25
  364. package/.agents/skills/authentication-best-practices/SKILL.md +92 -22
  365. package/.agents/skills/autonomous-execution/SKILL.md +86 -8
  366. package/.agents/skills/backend-alembic/SKILL.md +91 -0
  367. package/.agents/skills/backend-architecture-auditor/SKILL.md +101 -0
  368. package/.agents/skills/backend-mongodb/SKILL.md +133 -0
  369. package/.agents/skills/backend-mysql/SKILL.md +84 -0
  370. package/.agents/skills/backend-performance-auditor/SKILL.md +100 -0
  371. package/.agents/skills/backend-postgresql/SKILL.md +117 -0
  372. package/.agents/skills/backend-redis/SKILL.md +122 -0
  373. package/.agents/skills/backend-security-expert/SKILL.md +83 -22
  374. package/.agents/skills/backend-sqlalchemy/SKILL.md +107 -0
  375. package/.agents/skills/backend-sqlite/SKILL.md +93 -0
  376. package/.agents/skills/backend-testing-auditor/SKILL.md +113 -0
  377. package/.agents/skills/baseline-ui/SKILL.md +92 -22
  378. package/.agents/skills/bash-linux/SKILL.md +84 -26
  379. package/.agents/skills/behavioral-modes/SKILL.md +93 -23
  380. package/.agents/skills/better-colors/SKILL.md +92 -22
  381. package/.agents/skills/better-typography/SKILL.md +88 -18
  382. package/.agents/skills/better-ui/SKILL.md +83 -22
  383. package/.agents/skills/bolder/SKILL.md +92 -22
  384. package/.agents/skills/brainstorming/SKILL.md +83 -23
  385. package/.agents/skills/browser-audit/SKILL.md +94 -24
  386. package/.agents/skills/browser-native-ai/SKILL.md +92 -22
  387. package/.agents/skills/build-primitive/SKILL.md +92 -22
  388. package/.agents/skills/building-native-ui/SKILL.md +83 -22
  389. package/.agents/skills/cicd-pro/SKILL.md +83 -22
  390. package/.agents/skills/clarify/SKILL.md +92 -22
  391. package/.agents/skills/clean-code/SKILL.md +83 -22
  392. package/.agents/skills/cloud-architect/SKILL.md +83 -22
  393. package/.agents/skills/cobejs/SKILL.md +92 -22
  394. package/.agents/skills/code-review-checklist/SKILL.md +92 -22
  395. package/.agents/skills/codebase-design/SKILL.md +83 -22
  396. package/.agents/skills/colorize/SKILL.md +92 -22
  397. package/.agents/skills/compact-landing/SKILL.md +92 -22
  398. package/.agents/skills/company-logos/SKILL.md +92 -22
  399. package/.agents/skills/config-validator/SKILL.md +84 -26
  400. package/.agents/skills/containerization-pro/SKILL.md +83 -22
  401. package/.agents/skills/context-engineering-pro/SKILL.md +92 -20
  402. package/.agents/skills/create-design-md/SKILL.md +92 -22
  403. package/.agents/skills/critique/SKILL.md +93 -23
  404. package/.agents/skills/csharp-developer/SKILL.md +92 -22
  405. package/.agents/skills/data-validation-schemas/SKILL.md +84 -26
  406. package/.agents/skills/database-design/SKILL.md +83 -22
  407. package/.agents/skills/delight/SKILL.md +92 -22
  408. package/.agents/skills/deployment-procedures/SKILL.md +84 -26
  409. package/.agents/skills/design-lab/SKILL.md +93 -23
  410. package/.agents/skills/devops-engineer/SKILL.md +92 -22
  411. package/.agents/skills/devops-incident-responder/SKILL.md +84 -26
  412. package/.agents/skills/diagnosing-bugs/SKILL.md +93 -23
  413. package/.agents/skills/distill/SKILL.md +92 -22
  414. package/.agents/skills/documentation-templates/SKILL.md +84 -26
  415. package/.agents/skills/domain-modeling/SKILL.md +92 -22
  416. package/.agents/skills/duckdb-analytical-sql/SKILL.md +91 -19
  417. package/.agents/skills/edge-ai-mobile/SKILL.md +91 -19
  418. package/.agents/skills/edge-computing/SKILL.md +84 -26
  419. package/.agents/skills/emil-design-eng/SKILL.md +92 -22
  420. package/.agents/skills/error-resilience/SKILL.md +83 -22
  421. package/.agents/skills/expo-router-v4/SKILL.md +90 -18
  422. package/.agents/skills/extract-design-system/SKILL.md +84 -26
  423. package/.agents/skills/fabel-protocol/SKILL.md +93 -23
  424. package/.agents/skills/failure-mode-analysis/SKILL.md +88 -12
  425. package/.agents/skills/fastapi-pro/SKILL.md +123 -0
  426. package/.agents/skills/fixing-accessibility/SKILL.md +92 -22
  427. package/.agents/skills/fixing-metadata/SKILL.md +92 -22
  428. package/.agents/skills/fixing-motion-performance/SKILL.md +92 -22
  429. package/.agents/skills/framer-motion-expert/SKILL.md +85 -30
  430. package/.agents/skills/frontend-design/SKILL.md +92 -22
  431. package/.agents/skills/frontend-security-expert/SKILL.md +83 -22
  432. package/.agents/skills/game-design-expert/SKILL.md +84 -26
  433. package/.agents/skills/game-engineering-expert/SKILL.md +84 -26
  434. package/.agents/skills/generative-ui-expert/SKILL.md +92 -22
  435. package/.agents/skills/geo-fundamentals/SKILL.md +84 -26
  436. package/.agents/skills/git-pro/SKILL.md +83 -22
  437. package/.agents/skills/github-operations/SKILL.md +92 -22
  438. package/.agents/skills/gpt-taste/SKILL.md +92 -22
  439. package/.agents/skills/graph-engineering/SKILL.md +116 -28
  440. package/.agents/skills/gsap-core/SKILL.md +92 -22
  441. package/.agents/skills/gsap-frameworks/SKILL.md +92 -22
  442. package/.agents/skills/gsap-performance/SKILL.md +92 -22
  443. package/.agents/skills/gsap-plugins/SKILL.md +92 -22
  444. package/.agents/skills/gsap-react/SKILL.md +92 -22
  445. package/.agents/skills/gsap-scrolltrigger/SKILL.md +92 -22
  446. package/.agents/skills/gsap-timeline/SKILL.md +92 -22
  447. package/.agents/skills/gsap-utils/SKILL.md +92 -22
  448. package/.agents/skills/harden/SKILL.md +92 -22
  449. package/.agents/skills/harness-protocol/SKILL.md +93 -23
  450. package/.agents/skills/hf-cli/SKILL.md +86 -6
  451. package/.agents/skills/hf-cloud-aws-context-discovery/SKILL.md +86 -8
  452. package/.agents/skills/hf-cloud-python-env-setup/SKILL.md +86 -8
  453. package/.agents/skills/hf-cloud-sagemaker-deployment-planner/SKILL.md +86 -8
  454. package/.agents/skills/hf-cloud-sagemaker-iam-preflight/SKILL.md +86 -8
  455. package/.agents/skills/hf-cloud-sagemaker-production-defaults/SKILL.md +86 -8
  456. package/.agents/skills/hf-cloud-serving-image-selection/SKILL.md +86 -8
  457. package/.agents/skills/hf-mem/SKILL.md +86 -6
  458. package/.agents/skills/huggingface-best/SKILL.md +86 -16
  459. package/.agents/skills/huggingface-community-evals/SKILL.md +86 -8
  460. package/.agents/skills/huggingface-datasets/SKILL.md +86 -8
  461. package/.agents/skills/huggingface-gradio/SKILL.md +86 -8
  462. package/.agents/skills/huggingface-llm-trainer/SKILL.md +86 -9
  463. package/.agents/skills/huggingface-local-models/SKILL.md +86 -8
  464. package/.agents/skills/huggingface-lora-space-builder/SKILL.md +86 -8
  465. package/.agents/skills/huggingface-paper-publisher/SKILL.md +86 -7
  466. package/.agents/skills/huggingface-papers/SKILL.md +86 -8
  467. package/.agents/skills/huggingface-spaces/SKILL.md +86 -8
  468. package/.agents/skills/huggingface-tool-builder/SKILL.md +86 -8
  469. package/.agents/skills/huggingface-trackio/SKILL.md +77 -8
  470. package/.agents/skills/huggingface-vision-trainer/SKILL.md +86 -8
  471. package/.agents/skills/huggingface-zerogpu/SKILL.md +86 -8
  472. package/.agents/skills/human-gate-negotiation/SKILL.md +96 -30
  473. package/.agents/skills/i18n-localization/SKILL.md +84 -26
  474. package/.agents/skills/impeccable/SKILL.md +92 -22
  475. package/.agents/skills/improve-codebase-architecture/SKILL.md +92 -22
  476. package/.agents/skills/improve-ui/SKILL.md +92 -22
  477. package/.agents/skills/intelligent-routing/SKILL.md +81 -18
  478. package/.agents/skills/knowledge-graph/SKILL.md +94 -24
  479. package/.agents/skills/landing-page/SKILL.md +93 -23
  480. package/.agents/skills/lint-and-validate/SKILL.md +84 -26
  481. package/.agents/skills/llm-engineering/SKILL.md +92 -22
  482. package/.agents/skills/local-first/SKILL.md +84 -26
  483. package/.agents/skills/local-first-architecture/SKILL.md +83 -22
  484. package/.agents/skills/lottie-animation/SKILL.md +92 -22
  485. package/.agents/skills/marquee-loop/SKILL.md +92 -22
  486. package/.agents/skills/masked-reveal/SKILL.md +93 -24
  487. package/.agents/skills/mcp-builder/SKILL.md +84 -26
  488. package/.agents/skills/micro-interaction/SKILL.md +93 -31
  489. package/.agents/skills/mobile-design/SKILL.md +83 -22
  490. package/.agents/skills/monorepo-management/SKILL.md +84 -26
  491. package/.agents/skills/morphing-icons/SKILL.md +93 -24
  492. package/.agents/skills/motion-engineering/SKILL.md +84 -23
  493. package/.agents/skills/nextjs-react-expert/SKILL.md +83 -22
  494. package/.agents/skills/nodejs-best-practices/SKILL.md +83 -22
  495. package/.agents/skills/observability/SKILL.md +92 -22
  496. package/.agents/skills/opentelemetry-observability/SKILL.md +91 -19
  497. package/.agents/skills/page-transition-animation/SKILL.md +92 -22
  498. package/.agents/skills/parallel-agents/SKILL.md +85 -27
  499. package/.agents/skills/performance-profiling/SKILL.md +93 -23
  500. package/.agents/skills/plan-writing/SKILL.md +83 -22
  501. package/.agents/skills/platform-engineer/SKILL.md +84 -26
  502. package/.agents/skills/platform-engineering-opentofu/SKILL.md +91 -19
  503. package/.agents/skills/playwright-ai-e2e/SKILL.md +92 -20
  504. package/.agents/skills/playwright-best-practices/SKILL.md +85 -27
  505. package/.agents/skills/polish/SKILL.md +92 -22
  506. package/.agents/skills/powershell-windows/SKILL.md +92 -22
  507. package/.agents/skills/pricing-page/SKILL.md +92 -22
  508. package/.agents/skills/product-aware-heuristics/SKILL.md +93 -23
  509. package/.agents/skills/progressive-blur/SKILL.md +92 -22
  510. package/.agents/skills/project-idioms/SKILL.md +93 -23
  511. package/.agents/skills/property-based-testing/SKILL.md +92 -20
  512. package/.agents/skills/python-patterns/SKILL.md +84 -26
  513. package/.agents/skills/python-pro/SKILL.md +83 -22
  514. package/.agents/skills/quieter/SKILL.md +92 -22
  515. package/.agents/skills/react-doctor/SKILL.md +92 -22
  516. package/.agents/skills/react-specialist/SKILL.md +83 -22
  517. package/.agents/skills/readme-builder/SKILL.md +84 -26
  518. package/.agents/skills/realtime-patterns/SKILL.md +92 -22
  519. package/.agents/skills/red-team-tactics/SKILL.md +83 -22
  520. package/.agents/skills/redesign-skill/SKILL.md +92 -22
  521. package/.agents/skills/review-animations/SKILL.md +92 -22
  522. package/.agents/skills/rust-pro/SKILL.md +83 -22
  523. package/.agents/skills/semantic-filesystem-navigation/SKILL.md +79 -24
  524. package/.agents/skills/seo-fundamentals/SKILL.md +84 -26
  525. package/.agents/skills/server-management/SKILL.md +84 -26
  526. package/.agents/skills/session-log-interrogation/SKILL.md +81 -29
  527. package/.agents/skills/shadcn-ui-expert/SKILL.md +84 -26
  528. package/.agents/skills/shape/SKILL.md +93 -23
  529. package/.agents/skills/skill-creator/SKILL.md +88 -20
  530. package/.agents/skills/soft-skill/SKILL.md +92 -22
  531. package/.agents/skills/sounds-on-the-web/SKILL.md +92 -22
  532. package/.agents/skills/sql-pro/SKILL.md +83 -22
  533. package/.agents/skills/subagent-driven-development/SKILL.md +92 -32
  534. package/.agents/skills/supabase-postgres-best-practices/SKILL.md +83 -22
  535. package/.agents/skills/svg-animation/SKILL.md +93 -24
  536. package/.agents/skills/swiftui-expert/SKILL.md +84 -26
  537. package/.agents/skills/swiss-design/SKILL.md +92 -22
  538. package/.agents/skills/system-design-pro/SKILL.md +90 -16
  539. package/.agents/skills/systematic-debugging/SKILL.md +85 -27
  540. package/.agents/skills/tailwind-patterns/SKILL.md +92 -22
  541. package/.agents/skills/taste-skill/SKILL.md +92 -22
  542. package/.agents/skills/tdd-workflow/SKILL.md +84 -23
  543. package/.agents/skills/test-result-analyzer/SKILL.md +93 -23
  544. package/.agents/skills/testing-patterns/SKILL.md +93 -23
  545. package/.agents/skills/thermo-nuclear-code-quality-review/SKILL.md +92 -22
  546. package/.agents/skills/thinking-protocol/SKILL.md +79 -21
  547. package/.agents/skills/to-spring-or-not-to-spring/SKILL.md +92 -22
  548. package/.agents/skills/train-sentence-transformers/SKILL.md +86 -8
  549. package/.agents/skills/transformers-js/SKILL.md +86 -15
  550. package/.agents/skills/transitions-dev/SKILL.md +92 -22
  551. package/.agents/skills/trend-researcher/SKILL.md +92 -22
  552. package/.agents/skills/tribunal-instincts-memory/SKILL.md +86 -31
  553. package/.agents/skills/trl-training/SKILL.md +86 -16
  554. package/.agents/skills/typescript-advanced/SKILL.md +83 -22
  555. package/.agents/skills/typeset/SKILL.md +92 -22
  556. package/.agents/skills/ui-reasoning-engine/SKILL.md +93 -23
  557. package/.agents/skills/ui-skill-packs/SKILL.md +94 -24
  558. package/.agents/skills/ui-skills-root/SKILL.md +94 -24
  559. package/.agents/skills/ui-ux-pro-max/SKILL.md +93 -23
  560. package/.agents/skills/ui-ux-researcher/SKILL.md +92 -22
  561. package/.agents/skills/vector-search-pgvector/SKILL.md +91 -19
  562. package/.agents/skills/verification-before-completion/SKILL.md +90 -18
  563. package/.agents/skills/vue-expert/SKILL.md +83 -22
  564. package/.agents/skills/vulnerability-scanner/SKILL.md +93 -26
  565. package/.agents/skills/web-accessibility-auditor/SKILL.md +84 -26
  566. package/.agents/skills/web-design-guidelines/SKILL.md +92 -22
  567. package/.agents/skills/web-quality-audit/SKILL.md +92 -22
  568. package/.agents/skills/webapp-testing/SKILL.md +85 -27
  569. package/.agents/skills/webgpu-performance/SKILL.md +92 -22
  570. package/.agents/skills/whimsy-injector/SKILL.md +93 -23
  571. package/.agents/skills/workflow-optimizer/SKILL.md +93 -23
  572. package/.agents/skills/zero-trust-passkeys/SKILL.md +91 -19
  573. package/CONTRIBUTING.md +2 -2
  574. package/README.md +64 -42
  575. package/bin/adapter-install.js +1 -1
  576. package/bin/mcp-server.js +51 -42
  577. package/bin/wrapper.js +16 -0
  578. package/package.json +167 -169
  579. package/plugins/core-plugin.json +26 -26
  580. package/plugins/gemini/extension.json +6 -6
  581. package/skills/12-principles-of-animation/SKILL.md +92 -22
  582. package/skills/60fps-animation/SKILL.md +83 -26
  583. package/skills/accessible-animation/SKILL.md +93 -31
  584. package/skills/adapt/SKILL.md +92 -22
  585. package/skills/adr-generation/SKILL.md +88 -12
  586. package/skills/advanced-rag-pipelines/SKILL.md +83 -22
  587. package/skills/agent-organizer/SKILL.md +85 -27
  588. package/skills/agent-syscall-guidelines/SKILL.md +100 -25
  589. package/skills/agentic-patterns/SKILL.md +93 -23
  590. package/skills/agentic-workflows-2026/SKILL.md +92 -20
  591. package/skills/agentshield-security/SKILL.md +85 -26
  592. package/skills/ai-app-hardening/SKILL.md +92 -20
  593. package/skills/ai-prompt-injection-defense/SKILL.md +83 -22
  594. package/skills/animation-on-scroll/SKILL.md +93 -31
  595. package/skills/animation-systems/SKILL.md +93 -31
  596. package/skills/antfu-conventions/SKILL.md +92 -22
  597. package/skills/anti-slop-enforcement/SKILL.md +118 -0
  598. package/skills/api-patterns/SKILL.md +83 -22
  599. package/skills/api-security-auditor/SKILL.md +102 -24
  600. package/skills/app-builder/SKILL.md +85 -30
  601. package/skills/appflow-wireframe/SKILL.md +78 -18
  602. package/skills/apple-design/SKILL.md +92 -22
  603. package/skills/architecture/SKILL.md +83 -22
  604. package/skills/architecture-drift/SKILL.md +88 -12
  605. package/skills/architecture-intelligence/SKILL.md +53 -0
  606. package/skills/audit-and-fix/SKILL.md +95 -25
  607. package/skills/authentication-best-practices/SKILL.md +92 -22
  608. package/skills/autonomous-execution/SKILL.md +86 -8
  609. package/skills/backend-alembic/SKILL.md +91 -0
  610. package/skills/backend-architecture-auditor/SKILL.md +101 -0
  611. package/skills/backend-mongodb/SKILL.md +133 -0
  612. package/skills/backend-mysql/SKILL.md +84 -0
  613. package/skills/backend-performance-auditor/SKILL.md +100 -0
  614. package/skills/backend-postgresql/SKILL.md +117 -0
  615. package/skills/backend-redis/SKILL.md +122 -0
  616. package/skills/backend-security-expert/SKILL.md +83 -22
  617. package/skills/backend-sqlalchemy/SKILL.md +107 -0
  618. package/skills/backend-sqlite/SKILL.md +93 -0
  619. package/skills/backend-testing-auditor/SKILL.md +113 -0
  620. package/skills/baseline-ui/SKILL.md +92 -22
  621. package/skills/bash-linux/SKILL.md +84 -26
  622. package/skills/behavioral-modes/SKILL.md +93 -23
  623. package/skills/better-colors/SKILL.md +92 -22
  624. package/skills/better-typography/SKILL.md +88 -18
  625. package/skills/better-ui/SKILL.md +83 -22
  626. package/skills/bolder/SKILL.md +92 -22
  627. package/skills/brainstorming/SKILL.md +83 -23
  628. package/skills/browser-audit/SKILL.md +94 -24
  629. package/skills/browser-native-ai/SKILL.md +92 -22
  630. package/skills/build-primitive/SKILL.md +92 -22
  631. package/skills/building-native-ui/SKILL.md +83 -22
  632. package/skills/cicd-pro/SKILL.md +83 -22
  633. package/skills/clarify/SKILL.md +92 -22
  634. package/skills/clean-code/SKILL.md +83 -22
  635. package/skills/cloud-architect/SKILL.md +83 -22
  636. package/skills/cobejs/SKILL.md +92 -22
  637. package/skills/code-review-checklist/SKILL.md +92 -22
  638. package/skills/codebase-design/SKILL.md +83 -22
  639. package/skills/colorize/SKILL.md +92 -22
  640. package/skills/compact-landing/SKILL.md +92 -22
  641. package/skills/company-logos/SKILL.md +92 -22
  642. package/skills/config-validator/SKILL.md +84 -26
  643. package/skills/containerization-pro/SKILL.md +83 -22
  644. package/skills/context-engineering-pro/SKILL.md +92 -20
  645. package/skills/create-design-md/SKILL.md +92 -22
  646. package/skills/critique/SKILL.md +93 -23
  647. package/skills/csharp-developer/SKILL.md +92 -22
  648. package/skills/data-validation-schemas/SKILL.md +84 -26
  649. package/skills/database-design/SKILL.md +83 -22
  650. package/skills/delight/SKILL.md +92 -22
  651. package/skills/deployment-procedures/SKILL.md +84 -26
  652. package/skills/design-lab/SKILL.md +93 -23
  653. package/skills/devops-engineer/SKILL.md +92 -22
  654. package/skills/devops-incident-responder/SKILL.md +84 -26
  655. package/skills/diagnosing-bugs/SKILL.md +93 -23
  656. package/skills/distill/SKILL.md +92 -22
  657. package/skills/documentation-templates/SKILL.md +84 -26
  658. package/skills/domain-modeling/SKILL.md +92 -22
  659. package/skills/duckdb-analytical-sql/SKILL.md +91 -19
  660. package/skills/edge-ai-mobile/SKILL.md +91 -19
  661. package/skills/edge-computing/SKILL.md +84 -26
  662. package/skills/emil-design-eng/SKILL.md +92 -22
  663. package/skills/error-resilience/SKILL.md +83 -22
  664. package/skills/expo-router-v4/SKILL.md +90 -18
  665. package/skills/extract-design-system/SKILL.md +84 -26
  666. package/skills/fabel-protocol/SKILL.md +93 -23
  667. package/skills/failure-mode-analysis/SKILL.md +88 -12
  668. package/skills/fastapi-pro/SKILL.md +123 -0
  669. package/skills/fixing-accessibility/SKILL.md +92 -22
  670. package/skills/fixing-metadata/SKILL.md +92 -22
  671. package/skills/fixing-motion-performance/SKILL.md +92 -22
  672. package/skills/framer-motion-expert/SKILL.md +85 -30
  673. package/skills/frontend-design/SKILL.md +92 -22
  674. package/skills/frontend-security-expert/SKILL.md +83 -22
  675. package/skills/game-design-expert/SKILL.md +84 -26
  676. package/skills/game-engineering-expert/SKILL.md +84 -26
  677. package/skills/generative-ui-expert/SKILL.md +92 -22
  678. package/skills/geo-fundamentals/SKILL.md +84 -26
  679. package/skills/git-pro/SKILL.md +83 -22
  680. package/skills/github-operations/SKILL.md +92 -22
  681. package/skills/gpt-taste/SKILL.md +92 -22
  682. package/skills/graph-engineering/SKILL.md +116 -28
  683. package/skills/gsap-core/SKILL.md +92 -22
  684. package/skills/gsap-frameworks/SKILL.md +92 -22
  685. package/skills/gsap-performance/SKILL.md +92 -22
  686. package/skills/gsap-plugins/SKILL.md +92 -22
  687. package/skills/gsap-react/SKILL.md +92 -22
  688. package/skills/gsap-scrolltrigger/SKILL.md +92 -22
  689. package/skills/gsap-timeline/SKILL.md +92 -22
  690. package/skills/gsap-utils/SKILL.md +92 -22
  691. package/skills/harden/SKILL.md +92 -22
  692. package/skills/harness-protocol/SKILL.md +93 -23
  693. package/skills/hf-cli/SKILL.md +86 -6
  694. package/skills/hf-cloud-aws-context-discovery/SKILL.md +86 -8
  695. package/skills/hf-cloud-python-env-setup/SKILL.md +86 -8
  696. package/skills/hf-cloud-sagemaker-deployment-planner/SKILL.md +86 -8
  697. package/skills/hf-cloud-sagemaker-iam-preflight/SKILL.md +86 -8
  698. package/skills/hf-cloud-sagemaker-production-defaults/SKILL.md +86 -8
  699. package/skills/hf-cloud-serving-image-selection/SKILL.md +86 -8
  700. package/skills/hf-mem/SKILL.md +86 -6
  701. package/skills/huggingface-best/SKILL.md +86 -16
  702. package/skills/huggingface-community-evals/SKILL.md +86 -8
  703. package/skills/huggingface-datasets/SKILL.md +86 -8
  704. package/skills/huggingface-gradio/SKILL.md +86 -8
  705. package/skills/huggingface-llm-trainer/SKILL.md +86 -9
  706. package/skills/huggingface-local-models/SKILL.md +86 -8
  707. package/skills/huggingface-lora-space-builder/SKILL.md +86 -8
  708. package/skills/huggingface-paper-publisher/SKILL.md +86 -7
  709. package/skills/huggingface-papers/SKILL.md +86 -8
  710. package/skills/huggingface-spaces/SKILL.md +86 -8
  711. package/skills/huggingface-tool-builder/SKILL.md +86 -8
  712. package/skills/huggingface-trackio/SKILL.md +77 -8
  713. package/skills/huggingface-vision-trainer/SKILL.md +86 -8
  714. package/skills/huggingface-zerogpu/SKILL.md +86 -8
  715. package/skills/human-gate-negotiation/SKILL.md +96 -30
  716. package/skills/i18n-localization/SKILL.md +84 -26
  717. package/skills/impeccable/SKILL.md +92 -22
  718. package/skills/improve-codebase-architecture/SKILL.md +92 -22
  719. package/skills/improve-ui/SKILL.md +92 -22
  720. package/skills/intelligent-routing/SKILL.md +81 -18
  721. package/skills/knowledge-graph/SKILL.md +94 -24
  722. package/skills/landing-page/SKILL.md +93 -23
  723. package/skills/lint-and-validate/SKILL.md +84 -26
  724. package/skills/llm-engineering/SKILL.md +92 -22
  725. package/skills/local-first/SKILL.md +84 -26
  726. package/skills/local-first-architecture/SKILL.md +83 -22
  727. package/skills/lottie-animation/SKILL.md +92 -22
  728. package/skills/marquee-loop/SKILL.md +92 -22
  729. package/skills/masked-reveal/SKILL.md +93 -24
  730. package/skills/mcp-builder/SKILL.md +84 -26
  731. package/skills/micro-interaction/SKILL.md +93 -31
  732. package/skills/mobile-design/SKILL.md +83 -22
  733. package/skills/monorepo-management/SKILL.md +84 -26
  734. package/skills/morphing-icons/SKILL.md +93 -24
  735. package/skills/motion-engineering/SKILL.md +84 -23
  736. package/skills/nextjs-react-expert/SKILL.md +83 -22
  737. package/skills/nodejs-best-practices/SKILL.md +83 -22
  738. package/skills/observability/SKILL.md +92 -22
  739. package/skills/opentelemetry-observability/SKILL.md +91 -19
  740. package/skills/page-transition-animation/SKILL.md +92 -22
  741. package/skills/parallel-agents/SKILL.md +85 -27
  742. package/skills/performance-profiling/SKILL.md +93 -23
  743. package/skills/plan-writing/SKILL.md +83 -22
  744. package/skills/platform-engineer/SKILL.md +84 -26
  745. package/skills/platform-engineering-opentofu/SKILL.md +91 -19
  746. package/skills/playwright-ai-e2e/SKILL.md +92 -20
  747. package/skills/playwright-best-practices/SKILL.md +85 -27
  748. package/skills/polish/SKILL.md +92 -22
  749. package/skills/powershell-windows/SKILL.md +92 -22
  750. package/skills/pricing-page/SKILL.md +92 -22
  751. package/skills/product-aware-heuristics/SKILL.md +93 -23
  752. package/skills/progressive-blur/SKILL.md +92 -22
  753. package/skills/project-idioms/SKILL.md +93 -23
  754. package/skills/property-based-testing/SKILL.md +92 -20
  755. package/skills/python-patterns/SKILL.md +84 -26
  756. package/skills/python-pro/SKILL.md +83 -22
  757. package/skills/quieter/SKILL.md +92 -22
  758. package/skills/react-doctor/SKILL.md +92 -22
  759. package/skills/react-specialist/SKILL.md +83 -22
  760. package/skills/readme-builder/SKILL.md +84 -26
  761. package/skills/realtime-patterns/SKILL.md +92 -22
  762. package/skills/red-team-tactics/SKILL.md +83 -22
  763. package/skills/redesign-skill/SKILL.md +92 -22
  764. package/skills/review-animations/SKILL.md +92 -22
  765. package/skills/rust-pro/SKILL.md +83 -22
  766. package/skills/semantic-filesystem-navigation/SKILL.md +79 -24
  767. package/skills/seo-fundamentals/SKILL.md +84 -26
  768. package/skills/server-management/SKILL.md +84 -26
  769. package/skills/session-log-interrogation/SKILL.md +81 -29
  770. package/skills/shadcn-ui-expert/SKILL.md +84 -26
  771. package/skills/shape/SKILL.md +93 -23
  772. package/skills/skill-creator/SKILL.md +88 -20
  773. package/skills/soft-skill/SKILL.md +92 -22
  774. package/skills/sounds-on-the-web/SKILL.md +92 -22
  775. package/skills/sql-pro/SKILL.md +83 -22
  776. package/skills/subagent-driven-development/SKILL.md +92 -32
  777. package/skills/supabase-postgres-best-practices/SKILL.md +83 -22
  778. package/skills/svg-animation/SKILL.md +93 -24
  779. package/skills/swiftui-expert/SKILL.md +84 -26
  780. package/skills/swiss-design/SKILL.md +92 -22
  781. package/skills/system-design-pro/SKILL.md +90 -16
  782. package/skills/systematic-debugging/SKILL.md +85 -27
  783. package/skills/tailwind-patterns/SKILL.md +92 -22
  784. package/skills/taste-skill/SKILL.md +92 -22
  785. package/skills/tdd-workflow/SKILL.md +84 -23
  786. package/skills/test-result-analyzer/SKILL.md +93 -23
  787. package/skills/testing-patterns/SKILL.md +93 -23
  788. package/skills/thermo-nuclear-code-quality-review/SKILL.md +92 -22
  789. package/skills/thinking-protocol/SKILL.md +79 -21
  790. package/skills/to-spring-or-not-to-spring/SKILL.md +92 -22
  791. package/skills/train-sentence-transformers/SKILL.md +86 -8
  792. package/skills/transformers-js/SKILL.md +86 -15
  793. package/skills/transitions-dev/SKILL.md +92 -22
  794. package/skills/trend-researcher/SKILL.md +92 -22
  795. package/skills/tribunal-instincts-memory/SKILL.md +86 -31
  796. package/skills/trl-training/SKILL.md +86 -16
  797. package/skills/typescript-advanced/SKILL.md +83 -22
  798. package/skills/typeset/SKILL.md +92 -22
  799. package/skills/ui-reasoning-engine/SKILL.md +93 -23
  800. package/skills/ui-skill-packs/SKILL.md +94 -24
  801. package/skills/ui-skills-root/SKILL.md +94 -24
  802. package/skills/ui-ux-pro-max/SKILL.md +93 -23
  803. package/skills/ui-ux-researcher/SKILL.md +92 -22
  804. package/skills/vector-search-pgvector/SKILL.md +91 -19
  805. package/skills/verification-before-completion/SKILL.md +90 -18
  806. package/skills/vue-expert/SKILL.md +83 -22
  807. package/skills/vulnerability-scanner/SKILL.md +93 -26
  808. package/skills/web-accessibility-auditor/SKILL.md +84 -26
  809. package/skills/web-design-guidelines/SKILL.md +92 -22
  810. package/skills/web-quality-audit/SKILL.md +92 -22
  811. package/skills/webapp-testing/SKILL.md +85 -27
  812. package/skills/webgpu-performance/SKILL.md +92 -22
  813. package/skills/whimsy-injector/SKILL.md +93 -23
  814. package/skills/workflow-optimizer/SKILL.md +93 -23
  815. package/skills/zero-trust-passkeys/SKILL.md +91 -19
  816. package/src/browser/audit.js +11 -7
  817. package/src/browser/case_bridge.js +4 -3
  818. package/src/browser/cdp.js +60 -47
  819. package/src/browser/discovery.js +22 -12
  820. package/src/browser/idpi.js +6 -3
  821. package/src/browser/index.js +3 -2
  822. package/src/browser/launcher.js +49 -3
  823. package/src/browser/sentinel.js +13 -7
  824. package/src/browser/synapse.js +1 -1
  825. package/src/browser/trimmer.js +16 -7
  826. package/src/cli.js +404 -349
  827. package/src/commands/align.js +184 -177
  828. package/src/commands/arch.js +261 -0
  829. package/src/commands/audit-web.js +20 -6
  830. package/src/commands/browse.js +9 -3
  831. package/src/commands/case.js +93 -66
  832. package/src/commands/compare-web.js +12 -4
  833. package/src/commands/compile.js +81 -75
  834. package/src/commands/context.js +167 -63
  835. package/src/commands/contract.js +89 -106
  836. package/src/commands/deconstruct.js +18 -6
  837. package/src/commands/graph.js +47 -39
  838. package/src/commands/guardrail.js +45 -73
  839. package/src/commands/heal.js +15 -5
  840. package/src/commands/hook.js +29 -25
  841. package/src/commands/init.js +398 -329
  842. package/src/commands/learn.js +198 -107
  843. package/src/commands/marathon.js +65 -42
  844. package/src/commands/memory.js +501 -391
  845. package/src/commands/minimal.js +73 -59
  846. package/src/commands/mutate.js +31 -27
  847. package/src/commands/native.js +235 -81
  848. package/src/commands/optimize.js +303 -270
  849. package/src/commands/review.js +971 -0
  850. package/src/commands/sdd.js +65 -55
  851. package/src/commands/skill-intelligence.js +1165 -0
  852. package/src/commands/status.js +15 -5
  853. package/src/commands/sync.js +24 -22
  854. package/src/commands/system1.js +413 -0
  855. package/src/commands/uninstall.js +59 -50
  856. package/src/commands/update.js +41 -34
  857. package/src/commands/validate.js +13 -5
  858. package/src/context/ranker.js +337 -0
  859. package/src/esm/index.mjs +3 -1
  860. package/src/evolution/engine.js +296 -0
  861. package/src/mcp/server.js +2 -2
  862. package/src/synthesis/claim_check_separator.js +294 -0
  863. package/src/system1/browser_intelligence.js +300 -0
  864. package/src/system1/constants.js +49 -0
  865. package/src/system1/decision_engine.js +498 -0
  866. package/src/system1/evidence_engine.js +602 -0
  867. package/src/system1/evolution_pipeline.js +581 -0
  868. package/src/system1/index.d.ts +114 -0
  869. package/src/system1/index.js +102 -0
  870. package/src/system1/laya-package-lock.json +303 -0
  871. package/src/system1/laya-package.json +16 -0
  872. package/src/system1/provider.js +127 -0
  873. package/src/system1/reviewer_orchestrator.js +477 -0
  874. package/src/tui/banner.js +1 -1
  875. package/src/tui/reviewer-grid.js +3 -7
  876. package/src/tui/shimmer.js +1 -3
  877. package/src/tui/theme.js +20 -20
  878. package/src/tui/wizard.js +4 -8
  879. package/src/types.js +2 -2
  880. package/src/utils/fs.js +106 -78
  881. package/src/utils/hasher.js +90 -88
  882. package/src/utils/helpers.js +40 -41
  883. package/src/utils/logger.js +38 -31
  884. package/src/utils/version.js +120 -101
  885. package/scripts/apply-version.js +0 -57
  886. package/scripts/audit_skill_sdo.js +0 -89
  887. package/scripts/benchmark.js +0 -231
  888. package/scripts/build-graph.js +0 -71
  889. package/scripts/changelog.js +0 -190
  890. package/scripts/clean-pycache.js +0 -42
  891. package/scripts/context_compiler.js +0 -1143
  892. package/scripts/fix-vbc.js +0 -96
  893. package/scripts/fix-vbc.ps1 +0 -3
  894. package/scripts/modernize_skills.js +0 -268
  895. package/scripts/package-cores.js +0 -116
  896. package/scripts/skill_enhancement_engine.js +0 -608
  897. package/scripts/stress_benchmark.js +0 -358
  898. package/scripts/sync-skills.js +0 -61
  899. package/scripts/sync-version.js +0 -177
  900. package/scripts/telemetry_gc.js +0 -156
  901. package/scripts/validate-payload.js +0 -73
  902. package/scripts/visual_audit.js +0 -136
@@ -1,22 +1,49 @@
1
- ---
2
- name: playwright-ai-e2e
3
- description: "Use when Modern Playwright 1.45+ E2E web testing, resilient ARIA locators, visual regression testing, network mocking, and AI-assisted flakiness detection."
4
- version: 5.0.0
5
- last-updated: 2026-09-13
6
- skills:
7
- - playwright-best-practices
8
- - webapp-testing
9
- - testing-patterns
10
- tools: Read, Grep, Glob, Bash, Edit, Write
11
- scripts-binding:
12
- - .agent/scripts/test_runner.js
13
- - .agent/scripts/visual_audit.js
14
- - .agent/scripts/lint_runner.js
15
- - .agent/scripts/verify_all.js
16
- ---
17
-
18
- # Playwright AI E2E Testing โ€” 2026 Standards
19
-
1
+ ---
2
+ name: playwright-ai-e2e
3
+ description: "Use when writing, maintaining, executing, and auditing playwright ai e2e test suites, assertions, mocks, and verification gates."
4
+ version: 6.0.0
5
+ last-updated: 2026-09-29
6
+ skills:
7
+ - playwright-best-practices
8
+ - webapp-testing
9
+ - testing-patterns
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/test_runner.js
13
+ - .agent/scripts/visual_audit.js
14
+ - .agent/scripts/lint_runner.js
15
+ - .agent/scripts/verify_all.js
16
+ ---
17
+
18
+ # Playwright AI E2E Testing โ€” 2026 Standards
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+ Before reading, generating, or refactoring code in the `playwright-ai-e2e` domain, inspect these 5 critical parameters:
22
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
23
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
24
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
25
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
26
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
27
+
28
+
29
+ ## Activation Boundaries
30
+ - **Activate when:** Use when writing, maintaining, executing, and auditing playwright ai e2e test suites, assertions, mocks, and verification gates.
31
+ - **DO NOT activate when:** The task falls outside the `playwright-ai-e2e` domain or is managed by a different dedicated specialist agent.
32
+
33
+
34
+ ## ๐Ÿ” Multi-Pass Execution Protocol
35
+
36
+ | Pass | Phase | Core Action | Adaptive Depth |
37
+ |:---|:---|:---|:---|
38
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. | Fast / Standard / Deep |
39
+ | **Pass 2** | **Plan** | Decompose task into smallest logical steps; map dependencies, affected files, and tool calls. | Standard / Deep |
40
+ | **Pass 3** | **Execute** | Implement solution with production-grade craft, zero placeholders, and strict typing. | All Modes |
41
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. | All Modes |
42
+ | **Pass 5** | **Attack & Falsify** | Perform adversarial search for edge-case failures, counterexamples, race conditions, and traps. | Standard / Deep |
43
+ | **Pass 6** | **Harden** | Eliminate discovered friction, optimize performance, and harden error boundaries. | Standard / Deep |
44
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. | All Modes |
45
+
46
+
20
47
  ---
21
48
 
22
49
  ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
@@ -49,4 +76,49 @@ test.describe('Dashboard Features', () => {
49
76
  await expect(visitsText).toBeVisible();
50
77
  });
51
78
  });
52
- ```
79
+ ```
80
+
81
+ ## ๐Ÿšจ Edge-Case & Failure Mode Matrix
82
+
83
+ | Scenario | Risk | Production Mitigation |
84
+ |:---|:---|:---|
85
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
86
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
87
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
88
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
89
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
90
+
91
+
92
+ ## ๐Ÿค– LLM-Specific Traps Table
93
+
94
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
95
+ |:---|:---|:---|
96
+ | **Testing Implementation Details** | Asserting on private component state or internal helper functions | Assert on observable user behaviors, DOM roles, and network outcomes |
97
+ | **Flaky Async Assertion** | Using arbitrary setTimeout delays before asserting on asynchronous state | Use waitFor or condition-based queries that poll with timeout bounds |
98
+ | **Shared Mutable State** | Reusing database records across concurrent test runners | Isolate test databases per worker or execute in rolled-back transactions |
99
+
100
+
101
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
102
+
103
+ **Active Reviewers:** `test-engineer` ยท `qa-automation-engineer` ยท `logic-reviewer`
104
+ **Slash Command:** `/review` or `/tribunal-full`
105
+
106
+ ### ๐Ÿ”ฌ Evidence Standard (Tri-State Verification)
107
+ Every finding, audit statement, or completion claim must classify its factual certainty:
108
+ - **`[OBSERVED]`**: Directly confirmed in the codebase or verified via executed terminal command.
109
+ - **`[INFERRED]`**: Logically deduced from code patterns, architectural data flow, or schema relations.
110
+ - **`[UNVERIFIED]`**: Speculative hypothesis or runtime possibility requiring active testing or measurement.
111
+
112
+ ### โœ… Pre-Flight Self-Audit Checklist
113
+ ```
114
+ โœ… Do tests follow behavioral GIVEN/WHEN/THEN specifications?
115
+ โœ… Are happy path, failure paths, and boundary conditions (0, null, max, unicode) covered?
116
+ โœ… Are test mocks isolated and reset between successive test cases?
117
+ โœ… Do E2E locators rely on stable ARIA attributes instead of brittle CSS selectors?
118
+ โœ… Did I verify test suite passes deterministically without flaky race conditions?
119
+ ```
120
+
121
+ ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
122
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
123
+ - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
124
+ - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
@@ -1,27 +1,52 @@
1
- ---
2
- name: playwright-best-practices
3
- description: "Use when 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
- version: 5.0.0
5
- last-updated: 2026-09-13
6
- skills:
7
- - testing-patterns
8
- - webapp-testing
9
- - qa-automation-engineer
10
- tools: Read, Grep, Glob, Bash, Edit, Write
11
- scripts-binding:
12
- - .agent/scripts/test_runner.js
13
- - .agent/scripts/verify_all.js
14
- - .agent/scripts/lint_runner.js
15
- ---
16
-
17
- # Playwright E2E โ€” Bulletproof Testing Mastery
18
-
19
- ---
20
-
21
- ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
22
-
1
+ ---
2
+ name: playwright-best-practices
3
+ description: "Use when writing, maintaining, executing, and auditing playwright best practices test suites, assertions, mocks, and verification gates."
4
+ version: 6.0.0
5
+ last-updated: 2026-09-29
6
+ skills:
7
+ - testing-patterns
8
+ - webapp-testing
9
+ - qa-automation-engineer
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/test_runner.js
13
+ - .agent/scripts/verify_all.js
14
+ - .agent/scripts/lint_runner.js
15
+ ---
16
+
17
+ # Playwright E2E โ€” Bulletproof Testing Mastery
18
+
19
+ ## Mandatory Pre-Flight Context Inspection
20
+ Before reading, generating, or refactoring code in the `playwright-best-practices` domain, inspect these 5 critical parameters:
21
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
22
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
23
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
24
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
25
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
26
+
27
+
28
+ ## Activation Boundaries
29
+ - **Activate when:** Use when writing, maintaining, executing, and auditing playwright best practices test suites, assertions, mocks, and verification gates.
30
+ - **DO NOT activate when:** The task falls outside the `playwright-best-practices` domain or is managed by a different dedicated specialist agent.
31
+
32
+
33
+ ## ๐Ÿ” Multi-Pass Execution Protocol
34
+
35
+ | Pass | Phase | Core Action | Adaptive Depth |
36
+ |:---|:---|:---|:---|
37
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. | Fast / Standard / Deep |
38
+ | **Pass 2** | **Plan** | Decompose task into smallest logical steps; map dependencies, affected files, and tool calls. | Standard / Deep |
39
+ | **Pass 3** | **Execute** | Implement solution with production-grade craft, zero placeholders, and strict typing. | All Modes |
40
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. | All Modes |
41
+ | **Pass 5** | **Attack & Falsify** | Perform adversarial search for edge-case failures, counterexamples, race conditions, and traps. | Standard / Deep |
42
+ | **Pass 6** | **Harden** | Eliminate discovered friction, optimize performance, and harden error boundaries. | Standard / Deep |
43
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. | All Modes |
44
+
45
+
23
46
  ---
24
47
 
48
+ ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
49
+
25
50
  ## Hallucination Traps (Read First)
26
51
 
27
52
  - โŒ Using `page.waitForTimeout(3000)` for synchronization -> โœ… Use `page.waitForSelector()`, `expect(locator).toBeVisible()`, or auto-waiting locators
@@ -29,10 +54,7 @@ scripts-binding:
29
54
  - โŒ Running tests without `--workers=1` in CI debug mode -> โœ… Parallel tests with shared state cause flaky failures; isolate tests properly
30
55
  - โŒ Not using `test.describe.configure({ mode: 'serial' })` when tests have ordering dependencies -> โœ… Explicitly mark serial when needed
31
56
 
32
- ---
33
-
34
- ---
35
-
57
+ ---
36
58
  ## 1. Resilience & Auto-Waiting
37
59
 
38
60
  Playwright automatically waits for elements to be actionable (visible, stable, not obscured).
@@ -146,4 +168,40 @@ export default defineConfig({
146
168
  reuseExistingServer: !process.env.CI,
147
169
  },
148
170
  });
149
- ```
171
+ ```
172
+
173
+ ## ๐Ÿšจ Edge-Case & Failure Mode Matrix
174
+
175
+ | Scenario | Risk | Production Mitigation |
176
+ |:---|:---|:---|
177
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
178
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
179
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
180
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
181
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
182
+
183
+
184
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
185
+
186
+ **Active Reviewers:** `test-engineer` ยท `qa-automation-engineer` ยท `logic-reviewer`
187
+ **Slash Command:** `/review` or `/tribunal-full`
188
+
189
+ ### ๐Ÿ”ฌ Evidence Standard (Tri-State Verification)
190
+ Every finding, audit statement, or completion claim must classify its factual certainty:
191
+ - **`[OBSERVED]`**: Directly confirmed in the codebase or verified via executed terminal command.
192
+ - **`[INFERRED]`**: Logically deduced from code patterns, architectural data flow, or schema relations.
193
+ - **`[UNVERIFIED]`**: Speculative hypothesis or runtime possibility requiring active testing or measurement.
194
+
195
+ ### โœ… Pre-Flight Self-Audit Checklist
196
+ ```
197
+ โœ… Do tests follow behavioral GIVEN/WHEN/THEN specifications?
198
+ โœ… Are happy path, failure paths, and boundary conditions (0, null, max, unicode) covered?
199
+ โœ… Are test mocks isolated and reset between successive test cases?
200
+ โœ… Do E2E locators rely on stable ARIA attributes instead of brittle CSS selectors?
201
+ โœ… Did I verify test suite passes deterministically without flaky race conditions?
202
+ ```
203
+
204
+ ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
205
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
206
+ - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
207
+ - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
@@ -1,26 +1,51 @@
1
- ---
2
- name: polish
3
- description: "Use when 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: 5.0.0
5
- last-updated: 2026-09-13
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
- ---
15
-
16
- # Polish โ€” Final Pre-Ship UI Quality Pass
17
-
18
- ---
19
-
20
- ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
21
-
1
+ ---
2
+ name: polish
3
+ description: "Use when building, styling, optimizing, and auditing polish components, responsive layouts, design systems, and frontend state."
4
+ version: 6.0.0
5
+ last-updated: 2026-09-29
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
+ ---
15
+
16
+ # Polish โ€” Final Pre-Ship UI Quality Pass
17
+
18
+ ## Mandatory Pre-Flight Context Inspection
19
+ Before reading, generating, or refactoring code in the `polish` domain, inspect these 5 critical parameters:
20
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
21
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
22
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
23
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
24
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
25
+
26
+
27
+ ## Activation Boundaries
28
+ - **Activate when:** Use when building, styling, optimizing, and auditing polish components, responsive layouts, design systems, and frontend state.
29
+ - **DO NOT activate when:** The task falls outside the `polish` domain or is managed by a different dedicated specialist agent.
30
+
31
+
32
+ ## ๐Ÿ” Multi-Pass Execution Protocol
33
+
34
+ | Pass | Phase | Core Action | Adaptive Depth |
35
+ |:---|:---|:---|:---|
36
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. | Fast / Standard / Deep |
37
+ | **Pass 2** | **Plan** | Decompose task into smallest logical steps; map dependencies, affected files, and tool calls. | Standard / Deep |
38
+ | **Pass 3** | **Execute** | Implement solution with production-grade craft, zero placeholders, and strict typing. | All Modes |
39
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. | All Modes |
40
+ | **Pass 5** | **Attack & Falsify** | Perform adversarial search for edge-case failures, counterexamples, race conditions, and traps. | Standard / Deep |
41
+ | **Pass 6** | **Harden** | Eliminate discovered friction, optimize performance, and harden error boundaries. | Standard / Deep |
42
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. | All Modes |
43
+
44
+
22
45
  ---
23
46
 
47
+ ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
48
+
24
49
  ---
25
50
 
26
51
  ## Pre-Ship 10-Point Polish Checklist
@@ -36,4 +61,49 @@ scripts-binding:
36
61
  | **7** | **Overflow Handling** | Long text strings, email addresses, and filenames use proper text truncation (`truncate` / `line-clamp`). |
37
62
  | **8** | **Empty States** | Lists, tables, and search results handle zero-item empty states gracefully. |
38
63
  | **9** | **Loading Skeletons** | Slow data loads show matching skeleton pulses instead of sudden layout shifts (CLS). |
39
- | **10** | **Reduced Motion** | CSS animations and JS motion respect `@media (prefers-reduced-motion: reduce)`. |
64
+ | **10** | **Reduced Motion** | CSS animations and JS motion respect `@media (prefers-reduced-motion: reduce)`. |
65
+
66
+ ## ๐Ÿšจ Edge-Case & Failure Mode Matrix
67
+
68
+ | Scenario | Risk | Production Mitigation |
69
+ |:---|:---|:---|
70
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
71
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
72
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
73
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
74
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
75
+
76
+
77
+ ## ๐Ÿค– LLM-Specific Traps Table
78
+
79
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
80
+ |:---|:---|:---|
81
+ | **Uncontrolled Re-render Loop** | Mutating state inside render bodies or omitting hook dependencies | Wrap effects with explicit deps and isolate reactive derivations in useMemo |
82
+ | **Accessibility Neglect** | Interactive <div> without role="button", tabIndex, or onKeyDown | Use semantic <button> or provide ARIA role, keyboard handlers, and focus ring |
83
+ | **Layout Shift Flash** | Images/dynamic content without aspect-ratio or explicit dimensions | Enforce aspect-ratio or skeleton placeholders to guarantee zero CLS |
84
+
85
+
86
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
87
+
88
+ **Active Reviewers:** `frontend-reviewer` ยท `type-safety` ยท `ui-ux-auditor` ยท `complexity-reviewer`
89
+ **Slash Command:** `/review` or `/tribunal-full`
90
+
91
+ ### ๐Ÿ”ฌ Evidence Standard (Tri-State Verification)
92
+ Every finding, audit statement, or completion claim must classify its factual certainty:
93
+ - **`[OBSERVED]`**: Directly confirmed in the codebase or verified via executed terminal command.
94
+ - **`[INFERRED]`**: Logically deduced from code patterns, architectural data flow, or schema relations.
95
+ - **`[UNVERIFIED]`**: Speculative hypothesis or runtime possibility requiring active testing or measurement.
96
+
97
+ ### โœ… Pre-Flight Self-Audit Checklist
98
+ ```
99
+ โœ… Are all component props strictly typed with zero implicit "any"?
100
+ โœ… Are responsive breakpoints, fluid typography, and optical balance verified?
101
+ โœ… Is accessibility (ARIA labels, keyboard navigation, contrast ratio >= 4.5:1) validated?
102
+ โœ… Are re-renders minimized and state lifecycles cleanly separated?
103
+ โœ… Did I verify all imported UI components and icon sets actually exist?
104
+ ```
105
+
106
+ ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
107
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
108
+ - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
109
+ - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
@@ -1,26 +1,51 @@
1
- ---
2
- name: powershell-windows
3
- description: "Use when 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
- version: 5.0.0
5
- last-updated: 2026-09-13
6
- skills:
7
- - server-management
8
- - devops-engineer
9
- - bash-linux
10
- tools: Read, Grep, Glob, Bash, Edit, Write
11
- scripts-binding:
12
- - .agent/scripts/lint_runner.js
13
- - .agent/scripts/verify_all.js
14
- ---
15
-
16
- # PowerShell โ€” Windows Automation Mastery
17
-
18
- ---
19
-
20
- ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
21
-
1
+ ---
2
+ name: powershell-windows
3
+ description: "Use when configuring, automating, deploying, and debugging powershell windows pipelines, containers, servers, and cloud infrastructure."
4
+ version: 6.0.0
5
+ last-updated: 2026-09-29
6
+ skills:
7
+ - server-management
8
+ - devops-engineer
9
+ - bash-linux
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
+ ---
15
+
16
+ # PowerShell โ€” Windows Automation Mastery
17
+
18
+ ## Mandatory Pre-Flight Context Inspection
19
+ Before reading, generating, or refactoring code in the `powershell-windows` domain, inspect these 5 critical parameters:
20
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
21
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
22
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
23
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
24
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
25
+
26
+
27
+ ## Activation Boundaries
28
+ - **Activate when:** Use when configuring, automating, deploying, and debugging powershell windows pipelines, containers, servers, and cloud infrastructure.
29
+ - **DO NOT activate when:** The task falls outside the `powershell-windows` domain or is managed by a different dedicated specialist agent.
30
+
31
+
32
+ ## ๐Ÿ” Multi-Pass Execution Protocol
33
+
34
+ | Pass | Phase | Core Action | Adaptive Depth |
35
+ |:---|:---|:---|:---|
36
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. | Fast / Standard / Deep |
37
+ | **Pass 2** | **Plan** | Decompose task into smallest logical steps; map dependencies, affected files, and tool calls. | Standard / Deep |
38
+ | **Pass 3** | **Execute** | Implement solution with production-grade craft, zero placeholders, and strict typing. | All Modes |
39
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. | All Modes |
40
+ | **Pass 5** | **Attack & Falsify** | Perform adversarial search for edge-case failures, counterexamples, race conditions, and traps. | Standard / Deep |
41
+ | **Pass 6** | **Harden** | Eliminate discovered friction, optimize performance, and harden error boundaries. | Standard / Deep |
42
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. | All Modes |
43
+
44
+
22
45
  ---
23
46
 
47
+ ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
48
+
24
49
  ---
25
50
 
26
51
  ## 1. The Object Pipeline
@@ -119,4 +144,49 @@ Get-ChildItem -Path "HKLM:\Software\Microsoft\Windows\CurrentVersion\Run"
119
144
 
120
145
  # Certificates (Cert: drive)
121
146
  Get-ChildItem -Path "Cert:\LocalMachine\My" | Where-Object Subject -match "example.com"
122
- ```
147
+ ```
148
+
149
+ ## ๐Ÿšจ Edge-Case & Failure Mode Matrix
150
+
151
+ | Scenario | Risk | Production Mitigation |
152
+ |:---|:---|:---|
153
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
154
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
155
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
156
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
157
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
158
+
159
+
160
+ ## ๐Ÿค– LLM-Specific Traps Table
161
+
162
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
163
+ |:---|:---|:---|
164
+ | **Silent Pipeline Failure** | Executing shell steps without set -euo pipefail, ignoring errors | Always initialize shell scripts with set -euo pipefail and trap handlers |
165
+ | **Unpinned Dependency Shift** | Installing packages with npm install or using :latest docker tags | Lock dependencies with npm ci / lockfiles and use immutable SHA256 image digests |
166
+ | **Leaking Build Secrets** | Passing secrets as Docker build arguments baked into image layers | Use Docker BuildKit secret mounts (--mount=type=secret) or runtime injection |
167
+
168
+
169
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
170
+
171
+ **Active Reviewers:** `pipeline-reviewer` ยท `devops-engineer` ยท `resilience-reviewer`
172
+ **Slash Command:** `/review` or `/tribunal-full`
173
+
174
+ ### ๐Ÿ”ฌ Evidence Standard (Tri-State Verification)
175
+ Every finding, audit statement, or completion claim must classify its factual certainty:
176
+ - **`[OBSERVED]`**: Directly confirmed in the codebase or verified via executed terminal command.
177
+ - **`[INFERRED]`**: Logically deduced from code patterns, architectural data flow, or schema relations.
178
+ - **`[UNVERIFIED]`**: Speculative hypothesis or runtime possibility requiring active testing or measurement.
179
+
180
+ ### โœ… Pre-Flight Self-Audit Checklist
181
+ ```
182
+ โœ… Are strict execution modes (set -euo pipefail) active on all scripts?
183
+ โœ… Are container images pinned to immutable digest/SHA tags instead of "latest"?
184
+ โœ… Are deployment health checks, liveness probes, and rollback baselines configured?
185
+ โœ… Are CI secrets masked and unexposed to untrusted pull requests?
186
+ โœ… Did I verify environment compatibility across target runtimes?
187
+ ```
188
+
189
+ ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
190
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
191
+ - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
192
+ - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
@@ -1,26 +1,51 @@
1
- ---
2
- name: pricing-page
3
- description: "Use when SaaS pricing table architecture, billing cycle toggles (Monthly/Annual), feature comparison matrices, tier highlighting, and conversion optimization."
4
- version: 5.0.0
5
- last-updated: 2026-09-13
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
- ---
15
-
16
- # Pricing Page โ€” SaaS Pricing Architecture & Comparison Grids
17
-
18
- ---
19
-
20
- ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
21
-
1
+ ---
2
+ name: pricing-page
3
+ description: "Use when building, styling, optimizing, and auditing pricing page components, responsive layouts, design systems, and frontend state."
4
+ version: 6.0.0
5
+ last-updated: 2026-09-29
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
+ ---
15
+
16
+ # Pricing Page โ€” SaaS Pricing Architecture & Comparison Grids
17
+
18
+ ## Mandatory Pre-Flight Context Inspection
19
+ Before reading, generating, or refactoring code in the `pricing-page` domain, inspect these 5 critical parameters:
20
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
21
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
22
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
23
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
24
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
25
+
26
+
27
+ ## Activation Boundaries
28
+ - **Activate when:** Use when building, styling, optimizing, and auditing pricing page components, responsive layouts, design systems, and frontend state.
29
+ - **DO NOT activate when:** The task falls outside the `pricing-page` domain or is managed by a different dedicated specialist agent.
30
+
31
+
32
+ ## ๐Ÿ” Multi-Pass Execution Protocol
33
+
34
+ | Pass | Phase | Core Action | Adaptive Depth |
35
+ |:---|:---|:---|:---|
36
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. | Fast / Standard / Deep |
37
+ | **Pass 2** | **Plan** | Decompose task into smallest logical steps; map dependencies, affected files, and tool calls. | Standard / Deep |
38
+ | **Pass 3** | **Execute** | Implement solution with production-grade craft, zero placeholders, and strict typing. | All Modes |
39
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. | All Modes |
40
+ | **Pass 5** | **Attack & Falsify** | Perform adversarial search for edge-case failures, counterexamples, race conditions, and traps. | Standard / Deep |
41
+ | **Pass 6** | **Harden** | Eliminate discovered friction, optimize performance, and harden error boundaries. | Standard / Deep |
42
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. | All Modes |
43
+
44
+
22
45
  ---
23
46
 
47
+ ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
48
+
24
49
  ---
25
50
 
26
51
  ## 4 Pricing Table Rules
@@ -45,4 +70,49 @@ scripts-binding:
45
70
  ### 4. Feature Checklist Consistency
46
71
 
47
72
  - Group bullet points with green checkmark icons (`โœ“`).
48
- - Explicitly list features included vs excluded (using muted dashed icons or opacity for missing features).
73
+ - Explicitly list features included vs excluded (using muted dashed icons or opacity for missing features).
74
+
75
+ ## ๐Ÿšจ Edge-Case & Failure Mode Matrix
76
+
77
+ | Scenario | Risk | Production Mitigation |
78
+ |:---|:---|:---|
79
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
80
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
81
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
82
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
83
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
84
+
85
+
86
+ ## ๐Ÿค– LLM-Specific Traps Table
87
+
88
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
89
+ |:---|:---|:---|
90
+ | **Uncontrolled Re-render Loop** | Mutating state inside render bodies or omitting hook dependencies | Wrap effects with explicit deps and isolate reactive derivations in useMemo |
91
+ | **Accessibility Neglect** | Interactive <div> without role="button", tabIndex, or onKeyDown | Use semantic <button> or provide ARIA role, keyboard handlers, and focus ring |
92
+ | **Layout Shift Flash** | Images/dynamic content without aspect-ratio or explicit dimensions | Enforce aspect-ratio or skeleton placeholders to guarantee zero CLS |
93
+
94
+
95
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
96
+
97
+ **Active Reviewers:** `frontend-reviewer` ยท `type-safety` ยท `ui-ux-auditor` ยท `complexity-reviewer`
98
+ **Slash Command:** `/review` or `/tribunal-full`
99
+
100
+ ### ๐Ÿ”ฌ Evidence Standard (Tri-State Verification)
101
+ Every finding, audit statement, or completion claim must classify its factual certainty:
102
+ - **`[OBSERVED]`**: Directly confirmed in the codebase or verified via executed terminal command.
103
+ - **`[INFERRED]`**: Logically deduced from code patterns, architectural data flow, or schema relations.
104
+ - **`[UNVERIFIED]`**: Speculative hypothesis or runtime possibility requiring active testing or measurement.
105
+
106
+ ### โœ… Pre-Flight Self-Audit Checklist
107
+ ```
108
+ โœ… Are all component props strictly typed with zero implicit "any"?
109
+ โœ… Are responsive breakpoints, fluid typography, and optical balance verified?
110
+ โœ… Is accessibility (ARIA labels, keyboard navigation, contrast ratio >= 4.5:1) validated?
111
+ โœ… Are re-renders minimized and state lifecycles cleanly separated?
112
+ โœ… Did I verify all imported UI components and icon sets actually exist?
113
+ ```
114
+
115
+ ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
116
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
117
+ - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
118
+ - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.