tribunal-kit 7.0.0 โ†’ 9.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 (349) hide show
  1. package/.agent/ARCHITECTURE.md +2 -2
  2. package/.agent/config/claude.json +18 -0
  3. package/.agent/config/plugin.json +102 -0
  4. package/.agent/config/slash-commands.json +103 -0
  5. package/.agent/config/specialist-registry.json +415 -0
  6. package/.agent/config/system-prompt.md +244 -0
  7. package/.agent/history/architecture-graph.yaml +302 -3
  8. package/.agent/history/graph-cache.json +515 -45
  9. package/.agent/history/memory.db +0 -0
  10. package/.agent/history/snapshots/bin__adapter-install.js.json +13 -0
  11. package/.agent/history/snapshots/bin__global-store.js.json +15 -0
  12. package/.agent/history/snapshots/bin__mcp-server.js.json +19 -0
  13. package/.agent/history/snapshots/bin__proxy-server.js.json +20 -0
  14. package/.agent/history/snapshots/bin__spawn-agent.js.json +12 -0
  15. package/.agent/history/snapshots/bin__tk-proxy.js.json +21 -0
  16. package/.agent/history/snapshots/bin__tribunal-kit.js.json +9 -7
  17. package/.agent/history/snapshots/bin__wrapper.js.json +14 -0
  18. package/.agent/history/snapshots/eslint.config.js.json +1 -2
  19. package/.agent/history/snapshots/scripts__benchmark.js.json +14 -0
  20. package/.agent/history/snapshots/scripts__changelog.js.json +1 -2
  21. package/.agent/history/snapshots/scripts__fix-vbc.js.json +11 -0
  22. package/.agent/history/snapshots/scripts__stress_benchmark.js.json +15 -0
  23. package/.agent/history/snapshots/scripts__sync-version.js.json +1 -2
  24. package/.agent/history/snapshots/scripts__validate-payload.js.json +1 -2
  25. package/.agent/history/snapshots/scripts__visual_audit.js.json +11 -0
  26. package/.agent/history/snapshots/test__integration__bridges.test.js.json +1 -2
  27. package/.agent/history/snapshots/test__integration__graceful_degradation.test.js.json +12 -0
  28. package/.agent/history/snapshots/test__integration__init.test.js.json +1 -2
  29. package/.agent/history/snapshots/test__integration__minimal_change_pipeline.test.js.json +13 -0
  30. package/.agent/history/snapshots/test__integration__parallel_tribunal.test.js.json +12 -0
  31. package/.agent/history/snapshots/test__integration__routing.test.js.json +1 -2
  32. package/.agent/history/snapshots/test__integration__swarm_dispatcher.test.js.json +1 -2
  33. package/.agent/history/snapshots/test__integration__sync_status.test.js.json +13 -0
  34. package/.agent/history/snapshots/test__integration__wave2.test.js.json +1 -2
  35. package/.agent/history/snapshots/test__integration__wrapper.test.js.json +13 -0
  36. package/.agent/history/snapshots/test__unit__align.test.js.json +10 -0
  37. package/.agent/history/snapshots/test__unit__args.test.js.json +3 -3
  38. package/.agent/history/snapshots/test__unit__audit_release.test.js.json +16 -0
  39. package/.agent/history/snapshots/test__unit__case_law_manager.test.js.json +1 -2
  40. package/.agent/history/snapshots/test__unit__cicd_validator.test.js.json +12 -0
  41. package/.agent/history/snapshots/test__unit__compile.test.js.json +10 -0
  42. package/.agent/history/snapshots/test__unit__context_broker.test.js.json +1 -2
  43. package/.agent/history/snapshots/test__unit__contract_engine.test.js.json +13 -0
  44. package/.agent/history/snapshots/test__unit__copyDir.test.js.json +3 -3
  45. package/.agent/history/snapshots/test__unit__graph_tools.test.js.json +1 -2
  46. package/.agent/history/snapshots/test__unit__guardrail_engine.test.js.json +10 -0
  47. package/.agent/history/snapshots/test__unit__impact_classifier.test.js.json +12 -0
  48. package/.agent/history/snapshots/test__unit__init.test.js.json +14 -0
  49. package/.agent/history/snapshots/test__unit__inner_loop_validator.test.js.json +1 -2
  50. package/.agent/history/snapshots/test__unit__integrity_manifest.test.js.json +13 -0
  51. package/.agent/history/snapshots/test__unit__learn.test.js.json +11 -0
  52. package/.agent/history/snapshots/test__unit__marathon.test.js.json +22 -0
  53. package/.agent/history/snapshots/test__unit__mcp_server.test.js.json +16 -0
  54. package/.agent/history/snapshots/test__unit__memory.test.js.json +13 -0
  55. package/.agent/history/snapshots/test__unit__minimal_change.test.js.json +10 -0
  56. package/.agent/history/snapshots/test__unit__native.test.js.json +10 -0
  57. package/.agent/history/snapshots/test__unit__optimize.test.js.json +13 -0
  58. package/.agent/history/snapshots/test__unit__path_resolution.test.js.json +14 -0
  59. package/.agent/history/snapshots/test__unit__production_readiness_evidence.test.js.json +21 -0
  60. package/.agent/history/snapshots/test__unit__selfInstall.test.js.json +3 -3
  61. package/.agent/history/snapshots/test__unit__semver.test.js.json +3 -3
  62. package/.agent/history/snapshots/test__unit__skill_evolution.test.js.json +11 -0
  63. package/.agent/history/snapshots/test__unit__stress.test.js.json +15 -0
  64. package/.agent/history/snapshots/test__unit__swarm_dispatcher.test.js.json +3 -3
  65. package/.agent/history/snapshots/test__unit__utils.test.js.json +10 -0
  66. package/.agent/routing_index.json +2 -2
  67. package/.agent/scripts/ast_context_loader.js +137 -0
  68. package/.agent/scripts/memory_engine.js +581 -0
  69. package/.agent/scripts/payload_schemas.js +146 -0
  70. package/.agent/scripts/prompt_compiler.js +59 -11
  71. package/.agent/scripts/swarm_dispatcher.js +295 -67
  72. package/.agent/scripts/token_budget_broker.js +117 -6
  73. package/.agent/skills/12-principles-of-animation/SKILL.md +19 -16
  74. package/.agent/skills/60fps-animation/SKILL.md +47 -21
  75. package/.agent/skills/accessible-animation/SKILL.md +19 -16
  76. package/.agent/skills/adapt/SKILL.md +19 -16
  77. package/.agent/skills/advanced-rag-pipelines/SKILL.md +41 -40
  78. package/.agent/skills/agent-organizer/SKILL.md +9 -59
  79. package/.agent/skills/agentic-patterns/SKILL.md +9 -57
  80. package/.agent/skills/agentic-workflows-2026/SKILL.md +45 -8
  81. package/.agent/skills/ai-app-hardening/SKILL.md +31 -5
  82. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +28 -66
  83. package/.agent/skills/animation-on-scroll/SKILL.md +19 -16
  84. package/.agent/skills/animation-systems/SKILL.md +19 -15
  85. package/.agent/skills/antfu-conventions/SKILL.md +19 -18
  86. package/.agent/skills/api-patterns/SKILL.md +8 -58
  87. package/.agent/skills/api-security-auditor/SKILL.md +8 -58
  88. package/.agent/skills/app-builder/SKILL.md +9 -59
  89. package/.agent/skills/appflow-wireframe/SKILL.md +13 -57
  90. package/.agent/skills/apple-design/SKILL.md +22 -14
  91. package/.agent/skills/architecture/SKILL.md +9 -59
  92. package/.agent/skills/audit-and-fix/SKILL.md +19 -16
  93. package/.agent/skills/authentication-best-practices/SKILL.md +8 -58
  94. package/.agent/skills/backend-security-expert/SKILL.md +32 -65
  95. package/.agent/skills/baseline-ui/SKILL.md +22 -14
  96. package/.agent/skills/bash-linux/SKILL.md +9 -59
  97. package/.agent/skills/behavioral-modes/SKILL.md +9 -57
  98. package/.agent/skills/better-colors/SKILL.md +22 -14
  99. package/.agent/skills/better-typography/SKILL.md +26 -14
  100. package/.agent/skills/better-ui/SKILL.md +54 -19
  101. package/.agent/skills/bolder/SKILL.md +19 -16
  102. package/.agent/skills/brainstorming/SKILL.md +9 -57
  103. package/.agent/skills/browser-native-ai/SKILL.md +9 -28
  104. package/.agent/skills/build-primitive/SKILL.md +19 -16
  105. package/.agent/skills/building-native-ui/SKILL.md +9 -59
  106. package/.agent/skills/cicd-pro/SKILL.md +21 -28
  107. package/.agent/skills/clarify/SKILL.md +19 -16
  108. package/.agent/skills/clean-code/SKILL.md +18 -61
  109. package/.agent/skills/cloud-architect/SKILL.md +21 -28
  110. package/.agent/skills/cobejs/SKILL.md +19 -15
  111. package/.agent/skills/code-review-checklist/SKILL.md +8 -58
  112. package/.agent/skills/codebase-design/SKILL.md +33 -22
  113. package/.agent/skills/colorize/SKILL.md +19 -16
  114. package/.agent/skills/compact-landing/SKILL.md +19 -16
  115. package/.agent/skills/company-logos/SKILL.md +19 -16
  116. package/.agent/skills/config-validator/SKILL.md +9 -59
  117. package/.agent/skills/containerization-pro/SKILL.md +21 -28
  118. package/.agent/skills/context-engineering-pro/SKILL.md +31 -5
  119. package/.agent/skills/create-design-md/SKILL.md +22 -14
  120. package/.agent/skills/critique/SKILL.md +20 -11
  121. package/.agent/skills/csharp-developer/SKILL.md +8 -58
  122. package/.agent/skills/data-validation-schemas/SKILL.md +9 -59
  123. package/.agent/skills/database-design/SKILL.md +27 -67
  124. package/.agent/skills/delight/SKILL.md +19 -16
  125. package/.agent/skills/deployment-procedures/SKILL.md +9 -59
  126. package/.agent/skills/design-lab/SKILL.md +19 -16
  127. package/.agent/skills/devops-engineer/SKILL.md +8 -58
  128. package/.agent/skills/devops-incident-responder/SKILL.md +9 -59
  129. package/.agent/skills/diagnosing-bugs/SKILL.md +20 -21
  130. package/.agent/skills/distill/SKILL.md +19 -16
  131. package/.agent/skills/documentation-templates/SKILL.md +9 -59
  132. package/.agent/skills/domain-modeling/SKILL.md +19 -18
  133. package/.agent/skills/duckdb-analytical-sql/SKILL.md +31 -5
  134. package/.agent/skills/edge-ai-mobile/SKILL.md +31 -5
  135. package/.agent/skills/edge-computing/SKILL.md +9 -59
  136. package/.agent/skills/emil-design-eng/SKILL.md +21 -24
  137. package/.agent/skills/error-resilience/SKILL.md +31 -66
  138. package/.agent/skills/expo-router-v4/SKILL.md +31 -5
  139. package/.agent/skills/extract-design-system/SKILL.md +9 -59
  140. package/.agent/skills/fabel-protocol/SKILL.md +26 -8
  141. package/.agent/skills/fixing-accessibility/SKILL.md +22 -14
  142. package/.agent/skills/fixing-metadata/SKILL.md +19 -16
  143. package/.agent/skills/fixing-motion-performance/SKILL.md +22 -14
  144. package/.agent/skills/framer-motion-expert/SKILL.md +9 -57
  145. package/.agent/skills/frontend-design/SKILL.md +27 -7
  146. package/.agent/skills/frontend-security-expert/SKILL.md +8 -58
  147. package/.agent/skills/game-design-expert/SKILL.md +9 -59
  148. package/.agent/skills/game-engineering-expert/SKILL.md +9 -59
  149. package/.agent/skills/generative-ui-expert/SKILL.md +9 -28
  150. package/.agent/skills/geo-fundamentals/SKILL.md +9 -59
  151. package/.agent/skills/git-pro/SKILL.md +19 -30
  152. package/.agent/skills/github-operations/SKILL.md +8 -58
  153. package/.agent/skills/gpt-taste/SKILL.md +19 -16
  154. package/.agent/skills/gsap-core/SKILL.md +8 -78
  155. package/.agent/skills/gsap-frameworks/SKILL.md +8 -78
  156. package/.agent/skills/gsap-performance/SKILL.md +9 -77
  157. package/.agent/skills/gsap-plugins/SKILL.md +9 -77
  158. package/.agent/skills/gsap-react/SKILL.md +9 -21
  159. package/.agent/skills/gsap-scrolltrigger/SKILL.md +8 -78
  160. package/.agent/skills/gsap-timeline/SKILL.md +9 -77
  161. package/.agent/skills/gsap-utils/SKILL.md +9 -77
  162. package/.agent/skills/harden/SKILL.md +19 -16
  163. package/.agent/skills/harness-protocol/SKILL.md +9 -21
  164. package/.agent/skills/i18n-localization/SKILL.md +9 -59
  165. package/.agent/skills/impeccable/SKILL.md +19 -18
  166. package/.agent/skills/improve-codebase-architecture/SKILL.md +19 -17
  167. package/.agent/skills/improve-ui/SKILL.md +22 -14
  168. package/.agent/skills/intelligent-routing/SKILL.md +9 -23
  169. package/.agent/skills/knowledge-graph/SKILL.md +9 -21
  170. package/.agent/skills/landing-page/SKILL.md +19 -16
  171. package/.agent/skills/lint-and-validate/SKILL.md +9 -59
  172. package/.agent/skills/llm-engineering/SKILL.md +8 -58
  173. package/.agent/skills/local-first/SKILL.md +9 -59
  174. package/.agent/skills/local-first-architecture/SKILL.md +37 -20
  175. package/.agent/skills/lottie-animation/SKILL.md +19 -15
  176. package/.agent/skills/marquee-loop/SKILL.md +19 -16
  177. package/.agent/skills/masked-reveal/SKILL.md +19 -15
  178. package/.agent/skills/mcp-builder/SKILL.md +9 -59
  179. package/.agent/skills/micro-interaction/SKILL.md +19 -16
  180. package/.agent/skills/mobile-design/SKILL.md +8 -58
  181. package/.agent/skills/monorepo-management/SKILL.md +9 -59
  182. package/.agent/skills/morphing-icons/SKILL.md +19 -15
  183. package/.agent/skills/motion-engineering/SKILL.md +22 -15
  184. package/.agent/skills/nextjs-react-expert/SKILL.md +35 -67
  185. package/.agent/skills/nodejs-best-practices/SKILL.md +34 -61
  186. package/.agent/skills/observability/SKILL.md +8 -58
  187. package/.agent/skills/opentelemetry-observability/SKILL.md +31 -5
  188. package/.agent/skills/page-transition-animation/SKILL.md +19 -16
  189. package/.agent/skills/parallel-agents/SKILL.md +9 -59
  190. package/.agent/skills/performance-profiling/SKILL.md +8 -58
  191. package/.agent/skills/plan-writing/SKILL.md +36 -69
  192. package/.agent/skills/platform-engineer/SKILL.md +9 -59
  193. package/.agent/skills/platform-engineering-opentofu/SKILL.md +31 -5
  194. package/.agent/skills/playwright-ai-e2e/SKILL.md +31 -5
  195. package/.agent/skills/playwright-best-practices/SKILL.md +9 -59
  196. package/.agent/skills/polish/SKILL.md +19 -16
  197. package/.agent/skills/powershell-windows/SKILL.md +8 -58
  198. package/.agent/skills/pricing-page/SKILL.md +19 -16
  199. package/.agent/skills/product-aware-heuristics/SKILL.md +27 -8
  200. package/.agent/skills/progressive-blur/SKILL.md +19 -16
  201. package/.agent/skills/project-idioms/SKILL.md +9 -59
  202. package/.agent/skills/property-based-testing/SKILL.md +31 -5
  203. package/.agent/skills/python-patterns/SKILL.md +9 -59
  204. package/.agent/skills/python-pro/SKILL.md +35 -67
  205. package/.agent/skills/quieter/SKILL.md +19 -16
  206. package/.agent/skills/react-doctor/SKILL.md +19 -16
  207. package/.agent/skills/react-specialist/SKILL.md +26 -65
  208. package/.agent/skills/readme-builder/SKILL.md +9 -59
  209. package/.agent/skills/realtime-patterns/SKILL.md +8 -58
  210. package/.agent/skills/red-team-tactics/SKILL.md +9 -59
  211. package/.agent/skills/redesign-skill/SKILL.md +19 -16
  212. package/.agent/skills/review-animations/SKILL.md +21 -25
  213. package/.agent/skills/rust-pro/SKILL.md +30 -61
  214. package/.agent/skills/seo-fundamentals/SKILL.md +9 -59
  215. package/.agent/skills/server-management/SKILL.md +9 -59
  216. package/.agent/skills/shadcn-ui-expert/SKILL.md +9 -59
  217. package/.agent/skills/shape/SKILL.md +19 -16
  218. package/.agent/skills/skill-creator/SKILL.md +36 -86
  219. package/.agent/skills/soft-skill/SKILL.md +19 -16
  220. package/.agent/skills/sounds-on-the-web/SKILL.md +19 -16
  221. package/.agent/skills/sql-pro/SKILL.md +47 -62
  222. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +9 -59
  223. package/.agent/skills/svg-animation/SKILL.md +19 -15
  224. package/.agent/skills/swiftui-expert/SKILL.md +9 -59
  225. package/.agent/skills/swiss-design/SKILL.md +19 -16
  226. package/.agent/skills/system-design-pro/SKILL.md +21 -26
  227. package/.agent/skills/systematic-debugging/SKILL.md +19 -60
  228. package/.agent/skills/systematic-debugging/condition-based-waiting.md +115 -0
  229. package/.agent/skills/systematic-debugging/defense-in-depth.md +122 -0
  230. package/.agent/skills/systematic-debugging/root-cause-tracing.md +169 -0
  231. package/.agent/skills/tailwind-patterns/SKILL.md +8 -58
  232. package/.agent/skills/taste-skill/SKILL.md +19 -16
  233. package/.agent/skills/tdd-workflow/SKILL.md +65 -25
  234. package/.agent/skills/test-result-analyzer/SKILL.md +9 -59
  235. package/.agent/skills/testing-patterns/SKILL.md +8 -58
  236. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +19 -18
  237. package/.agent/skills/thinking-protocol/SKILL.md +33 -2
  238. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -15
  239. package/.agent/skills/transitions-dev/SKILL.md +19 -15
  240. package/.agent/skills/trend-researcher/SKILL.md +9 -59
  241. package/.agent/skills/typescript-advanced/SKILL.md +21 -64
  242. package/.agent/skills/typeset/SKILL.md +19 -16
  243. package/.agent/skills/ui-reasoning-engine/SKILL.md +27 -8
  244. package/.agent/skills/ui-skill-packs/SKILL.md +26 -16
  245. package/.agent/skills/ui-skills-root/SKILL.md +22 -14
  246. package/.agent/skills/ui-ux-pro-max/SKILL.md +38 -12
  247. package/.agent/skills/ui-ux-researcher/SKILL.md +9 -59
  248. package/.agent/skills/vector-search-pgvector/SKILL.md +31 -5
  249. package/.agent/skills/verification-before-completion/SKILL.md +125 -0
  250. package/.agent/skills/vue-expert/SKILL.md +9 -57
  251. package/.agent/skills/vulnerability-scanner/SKILL.md +8 -58
  252. package/.agent/skills/web-accessibility-auditor/SKILL.md +9 -59
  253. package/.agent/skills/web-design-guidelines/SKILL.md +27 -7
  254. package/.agent/skills/web-quality-audit/SKILL.md +19 -16
  255. package/.agent/skills/webapp-testing/SKILL.md +9 -59
  256. package/.agent/skills/webgpu-performance/SKILL.md +9 -28
  257. package/.agent/skills/whimsy-injector/SKILL.md +9 -57
  258. package/.agent/skills/workflow-optimizer/SKILL.md +9 -57
  259. package/.agent/skills/zero-trust-passkeys/SKILL.md +31 -5
  260. package/.agent/templates/DESIGN.md +680 -160
  261. package/.agent/templates/sdd/implementer-prompt.md +53 -0
  262. package/.agent/templates/sdd/re-review-prompt.md +28 -0
  263. package/.agent/templates/sdd/task-reviewer-prompt.md +59 -0
  264. package/.agent/workflows/acf.md +4 -0
  265. package/.agent/workflows/api-tester.md +5 -0
  266. package/.agent/workflows/audit.md +5 -0
  267. package/.agent/workflows/brainstorm.md +17 -1
  268. package/.agent/workflows/changelog.md +5 -0
  269. package/.agent/workflows/contract.md +19 -0
  270. package/.agent/workflows/create.md +6 -1
  271. package/.agent/workflows/debug.md +5 -0
  272. package/.agent/workflows/deploy.md +6 -1
  273. package/.agent/workflows/enhance.md +6 -1
  274. package/.agent/workflows/fix-ci.md +5 -0
  275. package/.agent/workflows/fix.md +5 -0
  276. package/.agent/workflows/generate.md +5 -0
  277. package/.agent/workflows/marathon.md +6 -1
  278. package/.agent/workflows/migrate.md +5 -0
  279. package/.agent/workflows/minimal.md +4 -0
  280. package/.agent/workflows/orchestrate.md +6 -1
  281. package/.agent/workflows/performance-benchmarker.md +6 -1
  282. package/.agent/workflows/pipeline.md +5 -0
  283. package/.agent/workflows/plan.md +6 -1
  284. package/.agent/workflows/preview.md +6 -1
  285. package/.agent/workflows/refactor.md +6 -0
  286. package/.agent/workflows/review-ai.md +5 -0
  287. package/.agent/workflows/review.md +5 -0
  288. package/.agent/workflows/sdd.md +122 -0
  289. package/.agent/workflows/session.md +5 -0
  290. package/.agent/workflows/status.md +4 -0
  291. package/.agent/workflows/super-prompt.md +4 -0
  292. package/.agent/workflows/swarm.md +6 -1
  293. package/.agent/workflows/test.md +6 -1
  294. package/.agent/workflows/tribunal-backend.md +5 -0
  295. package/.agent/workflows/tribunal-cicd.md +5 -0
  296. package/.agent/workflows/tribunal-database.md +5 -0
  297. package/.agent/workflows/tribunal-full.md +8 -0
  298. package/.agent/workflows/tribunal-mobile.md +5 -0
  299. package/.agent/workflows/tribunal-performance.md +5 -0
  300. package/.agent/workflows/tribunal-speed.md +5 -0
  301. package/.agent/workflows/tribunal-ui.md +7 -0
  302. package/.agents/plugins/marketplace.json +20 -0
  303. package/.claude/CLAUDE.md +442 -0
  304. package/.claude-plugin/marketplace.json +17 -0
  305. package/.claude-plugin/plugin.json +26 -0
  306. package/.codex-plugin/plugin.json +45 -0
  307. package/.cursor-plugin/plugin.json +26 -0
  308. package/.devin-plugin/plugin.json +14 -0
  309. package/.hermes-plugin/__init__.py +102 -0
  310. package/.hermes-plugin/plugin.yaml +6 -0
  311. package/.kimi-plugin/plugin.json +38 -0
  312. package/.opencode/INSTALL.md +41 -0
  313. package/.opencode/plugins/tribunal.js +101 -0
  314. package/.pi/extensions/tribunal.ts +133 -0
  315. package/CONTRIBUTING.md +1 -1
  316. package/README.md +253 -218
  317. package/SECURITY.md +3 -3
  318. package/bin/adapter-install.js +240 -0
  319. package/bin/global-store.js +48 -0
  320. package/bin/mcp-server.js +568 -252
  321. package/bin/proxy-server.js +113 -0
  322. package/bin/spawn-agent.js +39 -0
  323. package/bin/tk-proxy.js +34 -0
  324. package/bin/wrapper.js +1 -0
  325. package/dist/cli.js +355 -355
  326. package/dist/commands/init.js +8 -51
  327. package/dist/commands/status.js +61 -36
  328. package/dist/commands/validate.js +22 -31
  329. package/dist/esm/index.mjs +142 -142
  330. package/dist/index.d.ts +349 -343
  331. package/dist/tui/banner.js +77 -0
  332. package/dist/tui/index.js +21 -0
  333. package/dist/tui/reviewer-grid.js +90 -0
  334. package/dist/tui/shimmer.js +91 -0
  335. package/dist/tui/theme.js +130 -0
  336. package/dist/tui/tree.js +93 -0
  337. package/dist/tui/wizard.js +148 -0
  338. package/dist/utils/helpers.js +5 -41
  339. package/gemini-extension.json +6 -0
  340. package/hooks/hooks-cursor.json +16 -0
  341. package/hooks/hooks.json +16 -0
  342. package/hooks/session-start.js +77 -0
  343. package/package.json +165 -129
  344. package/scripts/audit_skill_sdo.js +87 -0
  345. package/scripts/build-graph.js +71 -0
  346. package/scripts/modernize_skills.js +254 -0
  347. package/.agent/history/snapshots/migrate_refs.js.json +0 -11
  348. package/.agent/scripts/compile_router.py +0 -5
  349. package/.agent/scripts/migrate_skills_frontmatter.py +0 -5
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: improve-ui
3
3
  description: Audit an existing product surface against its own design evidence, identify verified UI problems, and write self-contained implementation plans for another agent. Strictly read-only on product source. Use when asked to review, refine, improve, or clean up an interface without replacing its identity.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
4
+ version: 4.0.0
5
+ last-updated: 2026-09-07
6
6
  skills:
7
7
  - better-ui
8
8
  - baseline-ui
@@ -27,6 +27,12 @@ Before auditing UI surfaces or writing remediation plans, you MUST inspect:
27
27
 
28
28
  Audit a specific product surface against its governing design tokens and guidelines, identify verified UI defects, and generate self-contained implementation plans for remediation.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring Audit an existing product surface against its own design evidence, identify verified UI problems, and write self-contained implementation plans for another agent. Strictly read-only on product source. Use when asked to review, refine, improve, or clean up an interface without replacing its identity..
34
+ - **DO NOT activate when:** The task falls strictly outside improve-ui domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## 1. Operating Rules & Boundaries
@@ -77,23 +83,25 @@ Write a self-contained plan specifying:
77
83
 
78
84
  ---
79
85
 
80
- ## ๐Ÿค– LLM-Specific Traps
86
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
81
87
 
82
- 1. **Mutating Code During Audit**: Applying code changes immediately instead of generating a clean implementation plan.
83
- 2. **Re-architecting Scope**: Re-writing component state hooks when only CSS spacing and contrast fixes were requested.
88
+ **Slash command: `/review` or `/tribunal-full`**
89
+ **Active reviewers: `logic-reviewer` ยท `security-auditor`**
84
90
 
85
- ---
86
-
87
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
91
+ ### โŒ Forbidden AI Tropes
92
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
93
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
94
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
88
95
 
89
96
  ### โœ… Pre-Flight Self-Audit
90
-
91
97
  ```
92
- โœ… Is the audit strictly read-only on product source code?
93
- โœ… Are all reported findings supported by concrete token or layout evidence?
94
- โœ… Is the generated implementation plan self-contained and ready for execution?
98
+ โœ… Did I rely ONLY on real, verified tools and methods?
99
+ โœ… Is this solution appropriately scoped to the user's constraints?
100
+ โœ… Did I handle potential failure modes and edge cases?
101
+ โœ… Have I avoided generic boilerplate that doesn't add value?
95
102
  ```
96
103
 
97
104
  ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
98
-
99
- Confirm all plan recommendations match project CSS custom properties before delivery.
105
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
106
+ - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
107
+ - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: intelligent-routing
3
3
  description: LLM Intent Processing and Gateway Routing mastery. Request classification hierarchies, function routing, confidence scoring, fallback cascades, zero-shot vs few-shot classification patterns, and identifying specialized skills for delegation. Use when parsing raw user input to determine the architectural path of execution.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - fabel-protocol
9
9
  - agentic-patterns
@@ -23,6 +23,12 @@ Before routing user prompts to specialized skills or agents, you MUST inspect:
23
23
  2. Semantic Intent Schema (Section 1) โ†’ Classify request type (QUESTION, SURVEY, SIMPLE_EDIT, COMPLEX_BUILD, SECURITY_AUDIT, UNCLEAR_GIBBERISH)
24
24
  3. Confidence Threshold (Section 3 Socratic Yield Rule) โ†’ Yield back to user with clarifying question if confidence score is < 85s
25
25
 
26
+
27
+ ## Activation Boundaries
28
+
29
+ - **Activate when:** Operating in tasks requiring LLM Intent Processing and Gateway Routing mastery. Request classification hierarchies, function routing, confidence scoring, fallback cascades, zero-shot vs few-shot classification patterns, and identifying specialized skills for delegation. Use when parsing raw user input to determine the architectural path of execution..
30
+ - **DO NOT activate when:** The task falls strictly outside intelligent-routing domain or belongs to a different dedicated specialist.
31
+
26
32
  ## Hallucination Traps (Read First)
27
33
 
28
34
  - โŒ Routing based on exact keyword matching -> โœ… Use intent classification with confidence scores; keywords miss synonyms and context
@@ -32,8 +38,6 @@ Before routing user prompts to specialized skills or agents, you MUST inspect:
32
38
 
33
39
  ---
34
40
 
35
- # Intelligent Routing v4 โ€” Self-Describing Skill Graph
36
-
37
41
  ## Architecture Overview
38
42
 
39
43
  ```
@@ -215,33 +219,17 @@ This is idempotent โ€” running it multiple times produces the same output. The i
215
219
 
216
220
  ---
217
221
 
218
- ## ๐Ÿค– LLM-Specific Traps
219
-
220
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
221
-
222
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
223
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
224
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
225
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
226
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
227
-
228
- ---
229
-
230
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
222
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
231
223
 
232
224
  **Slash command: `/review` or `/tribunal-full`**
233
225
  **Active reviewers: `logic-reviewer` ยท `security-auditor`**
234
226
 
235
227
  ### โŒ Forbidden AI Tropes
236
-
237
228
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
238
229
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
239
230
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
240
231
 
241
232
  ### โœ… Pre-Flight Self-Audit
242
-
243
- Review these questions before confirming output:
244
-
245
233
  ```
246
234
  โœ… Did I rely ONLY on real, verified tools and methods?
247
235
  โœ… Is this solution appropriately scoped to the user's constraints?
@@ -250,8 +238,6 @@ Review these questions before confirming output:
250
238
  ```
251
239
 
252
240
  ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
253
-
254
241
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
255
-
256
242
  - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
257
243
  - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: knowledge-graph
3
3
  description: Understands the architecture, risk blast radius, and dependencies of the codebase without token bloat. Now includes Context Snapshots for 27x token reduction.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
4
+ version: 4.0.0
5
+ last-updated: 2026-09-07
6
6
  skills:
7
7
  - codebase-design
8
8
  - architecture
@@ -28,6 +28,12 @@ Before inspecting codebase architecture, you MUST inspect:
28
28
 
29
29
  Use this skill when the user types `/graph` or when you need to deeply understand the architecture of an unfamiliar codebase without suffering from context-window bloat.
30
30
 
31
+
32
+ ## Activation Boundaries
33
+
34
+ - **Activate when:** Operating in tasks requiring Understands the architecture, risk blast radius, and dependencies of the codebase without token bloat. Now includes Context Snapshots for 27x token reduction..
35
+ - **DO NOT activate when:** The task falls strictly outside knowledge-graph domain or belongs to a different dedicated specialist.
36
+
31
37
  ## The Token Reduction Protocol (Option C)
32
38
 
33
39
  **DO NOT READ RAW SOURCE FILES IF A SNAPSHOT EXISTS.**
@@ -77,33 +83,17 @@ You are explicitly forbidden from guessing or "hallucinating" what functions, pr
77
83
 
78
84
  ---
79
85
 
80
- ## ๐Ÿค– LLM-Specific Traps
81
-
82
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
83
-
84
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
85
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
86
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
87
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
88
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
89
-
90
- ---
91
-
92
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
86
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
93
87
 
94
88
  **Slash command: `/review` or `/tribunal-full`**
95
89
  **Active reviewers: `logic-reviewer` ยท `security-auditor`**
96
90
 
97
91
  ### โŒ Forbidden AI Tropes
98
-
99
92
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
100
93
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
101
94
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
102
95
 
103
96
  ### โœ… Pre-Flight Self-Audit
104
-
105
- Review these questions before confirming output:
106
-
107
97
  ```
108
98
  โœ… Did I rely ONLY on real, verified tools and methods?
109
99
  โœ… Is this solution appropriately scoped to the user's constraints?
@@ -112,8 +102,6 @@ Review these questions before confirming output:
112
102
  ```
113
103
 
114
104
  ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
115
-
116
105
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
117
-
118
106
  - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
119
107
  - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: landing-page
3
3
  description: High-converting landing page structure, hero section layout variance, CTA hierarchy, visual pacing, feature grid storytelling, and social proof placement.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
4
+ version: 4.0.0
5
+ last-updated: 2026-09-07
6
6
  skills:
7
7
  - compact-landing
8
8
  - company-logos
@@ -28,6 +28,12 @@ Before engineering full landing pages, you MUST inspect:
28
28
 
29
29
  Build high-converting, visually stunning landing pages that guide visitors from curiosity to conversion.
30
30
 
31
+
32
+ ## Activation Boundaries
33
+
34
+ - **Activate when:** Operating in tasks requiring High-converting landing page structure, hero section layout variance, CTA hierarchy, visual pacing, feature grid storytelling, and social proof placement..
35
+ - **DO NOT activate when:** The task falls strictly outside landing-page domain or belongs to a different dedicated specialist.
36
+
31
37
  ---
32
38
 
33
39
  ## The 6-Section Landing Page Blueprint
@@ -72,28 +78,25 @@ Avoid standard left-text / right-image templates on every project. Choose based
72
78
 
73
79
  ---
74
80
 
75
- ## ๐Ÿค– LLM-Specific Traps
81
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
76
82
 
77
- 1. **Standard Generic Left-Text / Right-Image Every Time**: Re-using the exact same layout template for every marketing page request.
78
- 2. **Multiple Equal Primary Buttons**: Displaying 3 solid colored buttons together, creating CTA confusion.
79
-
80
- ---
83
+ **Slash command: `/review` or `/tribunal-full`**
84
+ **Active reviewers: `logic-reviewer` ยท `security-auditor`**
81
85
 
82
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
83
-
84
- **Active reviewers: `frontend-reviewer` ยท `ui-ux-auditor`**
86
+ ### โŒ Forbidden AI Tropes
87
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
88
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
89
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
85
90
 
86
91
  ### โœ… Pre-Flight Self-Audit
87
-
88
92
  ```
89
- โœ… Is there a single, unambiguous primary CTA button above the fold?
90
- โœ… Is heading text balanced with `text-wrap: balance`?
91
- โœ… Is social proof placed immediately following the hero section?
93
+ โœ… Did I rely ONLY on real, verified tools and methods?
94
+ โœ… Is this solution appropriately scoped to the user's constraints?
95
+ โœ… Did I handle potential failure modes and edge cases?
96
+ โœ… Have I avoided generic boilerplate that doesn't add value?
92
97
  ```
93
98
 
94
99
  ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
95
-
96
100
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
97
-
98
101
  - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
99
102
  - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: lint-and-validate
3
3
  description: Linting and validation principles for code quality enforcement.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - clean-code
9
9
  - config-validator
@@ -25,6 +25,12 @@ Before running linting tools or modifying linter rules, you MUST inspect:
25
25
  2. Mandatory Strict Type Checks (Section 121) โ†’ Run static type checking (`tsc --noEmit` or `mypy`) alongside linters to catch non-linter type bugs
26
26
  3. Diff Review Before Auto-Fixing (Section 15) โ†’ Review diffs explicitly after auto-fixing (`eslint --fix`) to prevent accidental removal of side-effect code
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Linting and validation principles for code quality enforcement..
32
+ - **DO NOT activate when:** The task falls strictly outside lint-and-validate domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - โŒ Auto-fixing lint errors without reviewing the diff -> โœ… Some auto-fixes change logic (e.g., removing 'unused' variables that are side-effects)
@@ -33,8 +39,6 @@ Before running linting tools or modifying linter rules, you MUST inspect:
33
39
 
34
40
  ---
35
41
 
36
- # Linting & Validation
37
-
38
42
  ---
39
43
 
40
44
  ## Why Linting Matters
@@ -243,69 +247,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
243
247
 
244
248
  ---
245
249
 
246
- **Slash command: `/review` or `/tribunal-full`**
247
- **Active reviewers: `logic-reviewer` ยท `security-auditor`**
248
-
249
- ### โŒ Forbidden AI Tropes
250
-
251
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
252
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
253
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
254
-
255
- Review these questions before confirming output:
256
-
257
- ```
258
- โœ… Did I rely ONLY on real, verified tools and methods?
259
- โœ… Is this solution appropriately scoped to the user's constraints?
260
- โœ… Did I handle potential failure modes and edge cases?
261
- โœ… Have I avoided generic boilerplate that doesn't add value?
262
- ```
263
-
264
- ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
265
-
266
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
267
-
268
- - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
269
- - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
270
-
271
- ## Pre-Flight Checklist
272
-
273
- - [ ] Have I reviewed the user's specific constraints and requests?
274
- - [ ] Have I checked the environment for relevant existing implementations?
275
-
276
- ## VBC Protocol (Verification-Before-Completion)
277
-
278
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
279
-
280
- ---
281
-
282
- ## ๐Ÿค– LLM-Specific Traps
283
-
284
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
285
-
286
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
287
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
288
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
289
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
290
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
291
-
292
- ---
293
-
294
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
250
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
295
251
 
296
252
  **Slash command: `/review` or `/tribunal-full`**
297
253
  **Active reviewers: `logic-reviewer` ยท `security-auditor`**
298
254
 
299
255
  ### โŒ Forbidden AI Tropes
300
-
301
256
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
302
257
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
303
258
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
304
259
 
305
260
  ### โœ… Pre-Flight Self-Audit
306
-
307
- Review these questions before confirming output:
308
-
309
261
  ```
310
262
  โœ… Did I rely ONLY on real, verified tools and methods?
311
263
  โœ… Is this solution appropriately scoped to the user's constraints?
@@ -314,8 +266,6 @@ Review these questions before confirming output:
314
266
  ```
315
267
 
316
268
  ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
317
-
318
269
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
319
-
320
270
  - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
321
271
  - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: llm-engineering
3
3
  description: LLM engineering mastery for production AI systems. Prompt engineering, RAG pipeline design, vector store selection, embedding strategies, chunking, reranking, structured output, function calling, streaming, evals, guard-rails, cost optimization, and LLMOps. Use when building AI features, chat interfaces, semantic search, or any system calling an LLM API.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - ai-prompt-injection-defense
9
9
  - advanced-rag-pipelines
@@ -25,7 +25,11 @@ Before engineering LLM integrations or tool calling loops, you MUST inspect:
25
25
  2. Hybrid Vector + Keyword Search (Section 290) โ†’ Use hybrid vector + BM25 keyword search in RAG applications to prevent missing exact identifiers
26
26
  3. System Prompt Secret Isolation (Section 69) โ†’ Never put private API keys, database credentials, or secret internal URLs into system prompts
27
27
 
28
- # LLM Engineering โ€” Production AI Systems Mastery
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring LLM engineering mastery for production AI systems. Prompt engineering, RAG pipeline design, vector store selection, embedding strategies, chunking, reranking, structured output, function calling, streaming, evals, guard-rails, cost optimization, and LLMOps. Use when building AI features, chat interfaces, semantic search, or any system calling an LLM API..
32
+ - **DO NOT activate when:** The task falls strictly outside llm-engineering domain or belongs to a different dedicated specialist.
29
33
 
30
34
  ---
31
35
 
@@ -379,69 +383,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
379
383
 
380
384
  ---
381
385
 
382
- **Slash command: `/review` or `/tribunal-full`**
383
- **Active reviewers: `logic-reviewer` ยท `security-auditor`**
384
-
385
- ### โŒ Forbidden AI Tropes
386
-
387
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
388
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
389
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
390
-
391
- Review these questions before confirming output:
392
-
393
- ```
394
- โœ… Did I rely ONLY on real, verified tools and methods?
395
- โœ… Is this solution appropriately scoped to the user's constraints?
396
- โœ… Did I handle potential failure modes and edge cases?
397
- โœ… Have I avoided generic boilerplate that doesn't add value?
398
- ```
399
-
400
- ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
401
-
402
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
403
-
404
- - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
405
- - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
406
-
407
- ## Pre-Flight Checklist
408
-
409
- - [ ] Have I reviewed the user's specific constraints and requests?
410
- - [ ] Have I checked the environment for relevant existing implementations?
411
-
412
- ## VBC Protocol (Verification-Before-Completion)
413
-
414
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
415
-
416
- ---
417
-
418
- ## ๐Ÿค– LLM-Specific Traps
419
-
420
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
421
-
422
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
423
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
424
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
425
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
426
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
427
-
428
- ---
429
-
430
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
386
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
431
387
 
432
388
  **Slash command: `/review` or `/tribunal-full`**
433
389
  **Active reviewers: `logic-reviewer` ยท `security-auditor`**
434
390
 
435
391
  ### โŒ Forbidden AI Tropes
436
-
437
392
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
438
393
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
439
394
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
440
395
 
441
396
  ### โœ… Pre-Flight Self-Audit
442
-
443
- Review these questions before confirming output:
444
-
445
397
  ```
446
398
  โœ… Did I rely ONLY on real, verified tools and methods?
447
399
  โœ… Is this solution appropriately scoped to the user's constraints?
@@ -450,8 +402,6 @@ Review these questions before confirming output:
450
402
  ```
451
403
 
452
404
  ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
453
-
454
405
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
455
-
456
406
  - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
457
407
  - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: local-first
3
3
  description: Local-first software architecture mastery. CRDTs (Conflict-free Replicated Data Types), IndexedDB synchronization, sync engines (ElectricSQL, Replicache, PowerSync), offline-capable data fetching, optimistic UI, and SQLite in the browser (WASM). Use when building PWA offline capabilities, rapid UIs, or multiplayer collaborative tools.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - local-first-architecture
9
9
  - react-specialist
@@ -25,6 +25,12 @@ Before implementing local-first storage or CRDT synchronization, you MUST inspec
25
25
  2. Persistent Storage (Section 16) โ†’ Use IndexedDB (via Dexie/idb) or SQLite WASM for local persistence; ban localStorage for >5MB data
26
26
  3. Incremental Watermark Sync (Section 17) โ†’ Perform delta syncs using timestamps/watermarks rather than re-fetching full datasets
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Local-first software architecture mastery. CRDTs (Conflict-free Replicated Data Types), IndexedDB synchronization, sync engines (ElectricSQL, Replicache, PowerSync), offline-capable data fetching, optimistic UI, and SQLite in the browser (WASM). Use when building PWA offline capabilities, rapid UIs, or multiplayer collaborative tools..
32
+ - **DO NOT activate when:** The task falls strictly outside local-first domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - โŒ Assuming server data is always newer than local data -> โœ… Conflicts are inevitable; design merge strategy (LWW, CRDTs) before writing code
@@ -33,8 +39,6 @@ Before implementing local-first storage or CRDT synchronization, you MUST inspec
33
39
 
34
40
  ---
35
41
 
36
- # Local-First Architecture โ€” Offline-capable Mastery
37
-
38
42
  ---
39
43
 
40
44
  ## 1. Core Principles of Local-First
@@ -157,69 +161,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
157
161
 
158
162
  ---
159
163
 
160
- **Slash command: `/review` or `/tribunal-full`**
161
- **Active reviewers: `logic-reviewer` ยท `security-auditor`**
162
-
163
- ### โŒ Forbidden AI Tropes
164
-
165
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
166
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
167
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
168
-
169
- Review these questions before confirming output:
170
-
171
- ```
172
- โœ… Did I rely ONLY on real, verified tools and methods?
173
- โœ… Is this solution appropriately scoped to the user's constraints?
174
- โœ… Did I handle potential failure modes and edge cases?
175
- โœ… Have I avoided generic boilerplate that doesn't add value?
176
- ```
177
-
178
- ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
179
-
180
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
181
-
182
- - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
183
- - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
184
-
185
- ## Pre-Flight Checklist
186
-
187
- - [ ] Have I reviewed the user's specific constraints and requests?
188
- - [ ] Have I checked the environment for relevant existing implementations?
189
-
190
- ## VBC Protocol (Verification-Before-Completion)
191
-
192
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
193
-
194
- ---
195
-
196
- ## ๐Ÿค– LLM-Specific Traps
197
-
198
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
199
-
200
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
201
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
202
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
203
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
204
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
205
-
206
- ---
207
-
208
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
164
+ ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
209
165
 
210
166
  **Slash command: `/review` or `/tribunal-full`**
211
167
  **Active reviewers: `logic-reviewer` ยท `security-auditor`**
212
168
 
213
169
  ### โŒ Forbidden AI Tropes
214
-
215
170
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
216
171
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
217
172
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
218
173
 
219
174
  ### โœ… Pre-Flight Self-Audit
220
-
221
- Review these questions before confirming output:
222
-
223
175
  ```
224
176
  โœ… Did I rely ONLY on real, verified tools and methods?
225
177
  โœ… Is this solution appropriately scoped to the user's constraints?
@@ -228,8 +180,6 @@ Review these questions before confirming output:
228
180
  ```
229
181
 
230
182
  ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
231
-
232
183
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
233
-
234
184
  - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
235
185
  - โœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.