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
@@ -2,8 +2,8 @@
2
2
  name: seo-fundamentals
3
3
  description: Search Engine Optimization (SEO) mastery. Metadata implementation, Open Graph (OG) social card rendering, semantic HTML5 structuring, canonicalization, Core Web Vitals performance mapping, Sitemap/Robots configurations, structured data (JSON-LD), and Next.js SSR SEO implementations. Use when auditing site visibility or building consumer-facing web architectures.
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
  - fixing-metadata
9
9
  - web-quality-audit
@@ -25,6 +25,12 @@ Before implementing metadata or search optimization, you MUST inspect:
25
25
  2. Server-Side Rendering (SSR/SSG) Rule (Section 18) → Use SSR/SSG for indexable pages; ban client-side-only rendering for public SEO content
26
26
  3. JSON-LD Structured Data Injection (Section 86) → Inject Schema.org JSON-LD scripts (`application/ld+json`) for rich entity indexing
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Search Engine Optimization (SEO) mastery. Metadata implementation, Open Graph (OG) social card rendering, semantic HTML5 structuring, canonicalization, Core Web Vitals performance mapping, Sitemap/Robots configurations, structured data (JSON-LD), and Next.js SSR SEO implementations. Use when auditing site visibility or building consumer-facing web architectures..
32
+ - **DO NOT activate when:** The task falls strictly outside seo-fundamentals domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ Using `<div>` for everything instead of semantic HTML -> ✅ Use `<main>`, `<article>`, `<nav>`, `<section>` for crawler comprehension
@@ -34,8 +40,6 @@ Before implementing metadata or search optimization, you MUST inspect:
34
40
 
35
41
  ---
36
42
 
37
- # SEO Fundamentals — Visibility & Discoverability Mastery
38
-
39
43
  ---
40
44
 
41
45
  ## 1. Core Meta Architecture (The Next.js 15 Standard)
@@ -158,69 +162,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
158
162
 
159
163
  ---
160
164
 
161
- **Slash command: `/review` or `/tribunal-full`**
162
- **Active reviewers: `logic-reviewer` · `security-auditor`**
163
-
164
- ### ❌ Forbidden AI Tropes
165
-
166
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
167
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
168
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
169
-
170
- Review these questions before confirming output:
171
-
172
- ```
173
- ✅ Did I rely ONLY on real, verified tools and methods?
174
- ✅ Is this solution appropriately scoped to the user's constraints?
175
- ✅ Did I handle potential failure modes and edge cases?
176
- ✅ Have I avoided generic boilerplate that doesn't add value?
177
- ```
178
-
179
- ### 🛑 Verification-Before-Completion (VBC) Protocol
180
-
181
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
182
-
183
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
184
- - ✅ **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.
185
-
186
- ## Pre-Flight Checklist
187
-
188
- - [ ] Have I reviewed the user's specific constraints and requests?
189
- - [ ] Have I checked the environment for relevant existing implementations?
190
-
191
- ## VBC Protocol (Verification-Before-Completion)
192
-
193
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
194
-
195
- ---
196
-
197
- ## 🤖 LLM-Specific Traps
198
-
199
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
200
-
201
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
202
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
203
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
204
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
205
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
206
-
207
- ---
208
-
209
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
165
+ ## 🏛️ Tribunal Verification & Guardrails
210
166
 
211
167
  **Slash command: `/review` or `/tribunal-full`**
212
168
  **Active reviewers: `logic-reviewer` · `security-auditor`**
213
169
 
214
170
  ### ❌ Forbidden AI Tropes
215
-
216
171
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
217
172
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
218
173
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
219
174
 
220
175
  ### ✅ Pre-Flight Self-Audit
221
-
222
- Review these questions before confirming output:
223
-
224
176
  ```
225
177
  ✅ Did I rely ONLY on real, verified tools and methods?
226
178
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -229,8 +181,6 @@ Review these questions before confirming output:
229
181
  ```
230
182
 
231
183
  ### 🛑 Verification-Before-Completion (VBC) Protocol
232
-
233
184
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
234
-
235
185
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
236
186
  - ✅ **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: server-management
3
3
  description: Production Linux server administration mastery. Systemd services, Nginx reverse proxy architecture, UFW firewalls, SSH key security, cron scheduling, log rotation, and server hardening. Use when configuring bare-metal, VPS instances, or reviewing deployment architecture.
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
  - devops-engineer
9
9
  - backend-security-expert
@@ -25,6 +25,12 @@ Before configuring Linux servers, Nginx, or systemd services, you MUST inspect:
25
25
  2. Nginx Syntax Verification (`nginx -t`) (Section 17) → Always verify Nginx configuration (`sudo nginx -t`) BEFORE reloading systemd services
26
26
  3. SSH & UFW Hardening Defaults (Section 126) → Disable password auth & root login (`PermitRootLogin no`), and configure UFW default deny incoming
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Production Linux server administration mastery. Systemd services, Nginx reverse proxy architecture, UFW firewalls, SSH key security, cron scheduling, log rotation, and server hardening. Use when configuring bare-metal, VPS instances, or reviewing deployment architecture..
32
+ - **DO NOT activate when:** The task falls strictly outside server-management domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ Running services as root -> ✅ Create a dedicated service user with minimal permissions; never run as root
@@ -33,8 +39,6 @@ Before configuring Linux servers, Nginx, or systemd services, you MUST inspect:
33
39
 
34
40
  ---
35
41
 
36
- # Server Management — Production Linux Mastery
37
-
38
42
  ---
39
43
 
40
44
  ## 1. Systemd Service Architecture (Process Guard)
@@ -197,69 +201,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
197
201
 
198
202
  ---
199
203
 
200
- **Slash command: `/review` or `/tribunal-full`**
201
- **Active reviewers: `logic-reviewer` · `security-auditor`**
202
-
203
- ### ❌ Forbidden AI Tropes
204
-
205
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
206
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
207
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
208
-
209
- Review these questions before confirming output:
210
-
211
- ```
212
- ✅ Did I rely ONLY on real, verified tools and methods?
213
- ✅ Is this solution appropriately scoped to the user's constraints?
214
- ✅ Did I handle potential failure modes and edge cases?
215
- ✅ Have I avoided generic boilerplate that doesn't add value?
216
- ```
217
-
218
- ### 🛑 Verification-Before-Completion (VBC) Protocol
219
-
220
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
221
-
222
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
223
- - ✅ **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.
224
-
225
- ## Pre-Flight Checklist
226
-
227
- - [ ] Have I reviewed the user's specific constraints and requests?
228
- - [ ] Have I checked the environment for relevant existing implementations?
229
-
230
- ## VBC Protocol (Verification-Before-Completion)
231
-
232
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
233
-
234
- ---
235
-
236
- ## 🤖 LLM-Specific Traps
237
-
238
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
239
-
240
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
241
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
242
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
243
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
244
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
245
-
246
- ---
247
-
248
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
204
+ ## 🏛️ Tribunal Verification & Guardrails
249
205
 
250
206
  **Slash command: `/review` or `/tribunal-full`**
251
207
  **Active reviewers: `logic-reviewer` · `security-auditor`**
252
208
 
253
209
  ### ❌ Forbidden AI Tropes
254
-
255
210
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
256
211
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
257
212
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
258
213
 
259
214
  ### ✅ Pre-Flight Self-Audit
260
-
261
- Review these questions before confirming output:
262
-
263
215
  ```
264
216
  ✅ Did I rely ONLY on real, verified tools and methods?
265
217
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -268,8 +220,6 @@ Review these questions before confirming output:
268
220
  ```
269
221
 
270
222
  ### 🛑 Verification-Before-Completion (VBC) Protocol
271
-
272
223
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
273
-
274
224
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
275
225
  - ✅ **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: shadcn-ui-expert
3
3
  description: shadcn/ui mastery. Installation, customization via tailwind.config, component extraction, state management with Radix Primitives, theme variables (CSS custom properties), dark mode implementations, and overriding default designs. Use when building or modifying shadcn/ui components in React/Next.js projects.
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
  - build-primitive
9
9
  - react-specialist
@@ -25,6 +25,12 @@ Before using or customizing shadcn/ui components, you MUST inspect:
25
25
  2. `cn` Utility Usage (Section 144) → Use `cn(...)` (combining `clsx` + `tailwind-merge`) for all conditional and overridden class names
26
26
  3. Client Component Boundaries (Section 166) → Add `"use client"` on interactive Radix primitives (Dialog, Select, Popover) before rendering in App Router
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring shadcn/ui mastery. Installation, customization via tailwind.config, component extraction, state management with Radix Primitives, theme variables (CSS custom properties), dark mode implementations, and overriding default designs. Use when building or modifying shadcn/ui components in React/Next.js projects..
32
+ - **DO NOT activate when:** The task falls strictly outside shadcn-ui-expert domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ `import { Button } from 'shadcn-ui'` -> ✅ shadcn/ui is NOT a package; components are copied into YOUR project. Import from `@/components/ui/button`
@@ -34,8 +40,6 @@ Before using or customizing shadcn/ui components, you MUST inspect:
34
40
 
35
41
  ---
36
42
 
37
- # shadcn/ui Expert — Component Architecture Mastery
38
-
39
43
  ---
40
44
 
41
45
  ## 1. Core Architecture
@@ -215,69 +219,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
215
219
 
216
220
  ---
217
221
 
218
- **Slash command: `/review` or `/tribunal-full`**
219
- **Active reviewers: `logic-reviewer` · `security-auditor`**
220
-
221
- ### ❌ Forbidden AI Tropes
222
-
223
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
224
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
225
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
226
-
227
- Review these questions before confirming output:
228
-
229
- ```
230
- ✅ Did I rely ONLY on real, verified tools and methods?
231
- ✅ Is this solution appropriately scoped to the user's constraints?
232
- ✅ Did I handle potential failure modes and edge cases?
233
- ✅ Have I avoided generic boilerplate that doesn't add value?
234
- ```
235
-
236
- ### 🛑 Verification-Before-Completion (VBC) Protocol
237
-
238
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
239
-
240
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
241
- - ✅ **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.
242
-
243
- ## Pre-Flight Checklist
244
-
245
- - [ ] Have I reviewed the user's specific constraints and requests?
246
- - [ ] Have I checked the environment for relevant existing implementations?
247
-
248
- ## VBC Protocol (Verification-Before-Completion)
249
-
250
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
251
-
252
- ---
253
-
254
- ## 🤖 LLM-Specific Traps
255
-
256
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
257
-
258
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
259
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
260
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
261
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
262
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
263
-
264
- ---
265
-
266
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
222
+ ## 🏛️ Tribunal Verification & Guardrails
267
223
 
268
224
  **Slash command: `/review` or `/tribunal-full`**
269
225
  **Active reviewers: `logic-reviewer` · `security-auditor`**
270
226
 
271
227
  ### ❌ Forbidden AI Tropes
272
-
273
228
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
274
229
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
275
230
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
276
231
 
277
232
  ### ✅ Pre-Flight Self-Audit
278
-
279
- Review these questions before confirming output:
280
-
281
233
  ```
282
234
  ✅ Did I rely ONLY on real, verified tools and methods?
283
235
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -286,8 +238,6 @@ Review these questions before confirming output:
286
238
  ```
287
239
 
288
240
  ### 🛑 Verification-Before-Completion (VBC) Protocol
289
-
290
241
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
291
-
292
242
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
293
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: shape
3
3
  description: Plan feature UX before writing code via structured Socratic design interviews. Use when a user asks to plan a new screen, onboarding flow, feature UX, or user interaction before implementation.
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
  - brainstorming
8
8
  - plan-writing
@@ -27,6 +27,12 @@ Before generating UI component code for new features, you MUST inspect:
27
27
 
28
28
  Uncover core requirements, define interaction boundaries, and lock down screen flows BEFORE writing frontend code.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring Plan feature UX before writing code via structured Socratic design interviews. Use when a user asks to plan a new screen, onboarding flow, feature UX, or user interaction before implementation..
34
+ - **DO NOT activate when:** The task falls strictly outside shape domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## The 3-Step Shaping Workflow
@@ -62,28 +68,25 @@ Summarize the screen contract in a concise visual outline before coding:
62
68
 
63
69
  ---
64
70
 
65
- ## 🤖 LLM-Specific Traps
71
+ ## 🏛️ Tribunal Verification & Guardrails
66
72
 
67
- 1. **Jumping straight to code**: Writing CSS/React components without clarifying user goals or entry/exit points.
68
- 2. **Over-asking questions**: Asking more than 2-3 questions. Prioritize only blocking architectural ambiguities.
69
-
70
- ---
73
+ **Slash command: `/review` or `/tribunal-full`**
74
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
71
75
 
72
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
73
-
74
- **Active reviewers: `ui-ux-auditor`**
76
+ ### Forbidden AI Tropes
77
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
78
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
79
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
75
80
 
76
81
  ### ✅ Pre-Flight Self-Audit
77
-
78
82
  ```
79
- Are the entry and exit points of the screen explicitly defined?
80
- Are all 5 screen states (default, empty, loading, error, success) planned?
81
- Has the user confirmed the core interaction boundary before code generation?
83
+ Did I rely ONLY on real, verified tools and methods?
84
+ Is this solution appropriately scoped to the user's constraints?
85
+ Did I handle potential failure modes and edge cases?
86
+ ✅ Have I avoided generic boilerplate that doesn't add value?
82
87
  ```
83
88
 
84
89
  ### 🛑 Verification-Before-Completion (VBC) Protocol
85
-
86
90
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
87
-
88
91
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
89
92
  - ✅ **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: skill-creator
3
3
  description: Meta-agent specialized in expanding the framework's procedural knowledge by creating new, highly-structured SKILL.md files.
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
  - documentation-templates
@@ -21,114 +21,66 @@ scripts-binding:
21
21
 
22
22
  Before creating a new skill module, you MUST inspect:
23
23
 
24
- 1. `.agent/skills/` directory → Check if a skill in the same domain already exists to prevent duplication
25
- 2. Option A+C Hybrid Skill Schema (Section 26) → Enforce frontmatter with `version: 3.0.0`, `scripts-binding`, `Pre-Flight Checklist`, and `VBC Protocol`
26
- 3. Target skill path (`.agent/skills/<skill-name>/SKILL.md`) Verify destination directory structure before creation
24
+ 1. Target Skill Directory Inventory (`.agent/skills/`) → Check if a skill in the same domain already exists to prevent duplication
25
+ 2. V4 Hybrid Skill Schema Compliance → Enforce frontmatter with `version: 4.0.0`, `scripts-binding`, `Activation Boundaries`, `2026 Invariants`, and `VBC Protocol`
26
+ 3. Domain Specificity Rule → One skill = one domain. Never create monolithic multi-domain skills; split if content exceeds 12KB
27
27
 
28
- ## Hallucination Traps (Read First)
28
+ ## Activation Boundaries
29
29
 
30
- - Creating skills without frontmatter (name, description, version) -> Every SKILL.md MUST start with YAML frontmatter
31
- - Making skills too broad (covering multiple unrelated domains) -> One skill = one domain; split if content exceeds 10KB
32
- - ❌ Creating skills that duplicate existing skills -> ✅ Always check the skills directory before creating a new skill
30
+ - **Activate when:** Creating new skills for the Tribunal Kit ecosystem, expanding domain capabilities, or hardening existing skill definitions.
31
+ - **DO NOT activate when:** Writing application domain code (e.g. React components or SQL schemas).
33
32
 
34
- ---
35
-
36
- # Skill Creator
37
-
38
- You are a Meta-Agent tasked with defining the capabilities of future AI agents by creating rigorous `SKILL.md` files.
39
-
40
- ## Designing a Skill
41
-
42
- When asked to generate a new skill, strictly follow this layout:
43
-
44
- 1. **Frontmatter**: Must include `name`, `description` (short, punchy), and `allowed-tools`.
45
- 2. **Title & Identity**: A clear markdown `# Title` and an introductory paragraph specifying the agent's persona.
46
- 3. **Core Directives**: 3-5 rigid bullet points explaining the specific techniques, rules, or anti-patterns for the domain.
47
- 4. **Execution Rules**: How the agent must behave (e.g., verifying inputs prior to writing code, mandatory formatting).
48
-
49
- ## Crucial Principle
33
+ ## The V4 Hybrid Skill Specification
50
34
 
51
- Make the skill files actionable. Abstract advice ("be efficient", "write good code") wastes context window. Define what "good" means by providing strict code constraints (e.g., "Max line length is 100", "Never use global state without an ADR").
52
-
53
- When you render the file, ensure it is written to `.agent/skills/<skill-name>/SKILL.md`.
54
-
55
- ---
35
+ Every newly authored `SKILL.md` must strictly adhere to this 6-part structure:
56
36
 
37
+ ### 1. YAML Frontmatter
38
+ ```yaml
57
39
  ---
58
-
59
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
60
-
61
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
62
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
63
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
64
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
65
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
66
-
40
+ name: [skill-name]
41
+ description: [Clear, punchy semantic description for 2-tier lazy routing]
42
+ tools: Read, Grep, Glob, Bash, Edit, Write
43
+ version: 4.0.0
44
+ last-updated: 2026-09-07
45
+ skills:
46
+ - [dependency-skill-1]
47
+ - [dependency-skill-2]
48
+ scripts-binding:
49
+ - .agent/scripts/lint_runner.js
50
+ - .agent/scripts/verify_all.js
67
51
  ---
68
-
69
- **Slash command: `/review` or `/tribunal-full`**
70
- **Active reviewers: `logic-reviewer` · `security-auditor`**
71
-
72
- ### ❌ Forbidden AI Tropes
73
-
74
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
75
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
76
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
77
-
78
- Review these questions before confirming output:
79
-
80
- ```
81
- ✅ Did I rely ONLY on real, verified tools and methods?
82
- ✅ Is this solution appropriately scoped to the user's constraints?
83
- ✅ Did I handle potential failure modes and edge cases?
84
- ✅ Have I avoided generic boilerplate that doesn't add value?
85
52
  ```
86
53
 
87
- ### 🛑 Verification-Before-Completion (VBC) Protocol
88
-
89
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
90
-
91
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
92
- - ✅ **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.
93
-
94
- ## Pre-Flight Checklist
95
-
96
- - [ ] Have I reviewed the user's specific constraints and requests?
97
- - [ ] Have I checked the environment for relevant existing implementations?
98
-
99
- ## VBC Protocol (Verification-Before-Completion)
100
-
101
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
54
+ ### 2. Mandatory Pre-Flight Context Inspection
55
+ Provide 3-4 numbered, actionable checkpoints requiring inspection of target config files (`package.json`, `tsconfig.json`, `pyproject.toml`) or architectural invariants before code generation.
102
56
 
103
- ---
57
+ ### 3. Activation Boundaries
58
+ Explicitly define:
59
+ - `- **Activate when:** [Exact stack, problem type, or file pattern]`
60
+ - `- **DO NOT activate when:** [Out-of-scope scenarios; specify which specialist/skill to defer to]`
104
61
 
105
- ## 🤖 LLM-Specific Traps
62
+ ### 4. 2026 Performance & Logic Invariants
63
+ Provide 3-5 hard technical invariants for the domain (e.g., O(1) lookups, streaming backpressure, React 19 direct ref, Python 3.12 PEP 695 generics, zero `.unwrap()` in Rust).
106
64
 
107
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
65
+ ### 5. Hallucination Trap Table (Read First)
66
+ Provide concrete `❌ BAD (Deprecated / Inefficient)` vs `✅ GOOD (2026 Standard)` patterns. Never use abstract advice.
108
67
 
109
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
110
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
111
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
112
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
113
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
68
+ ### 6. Actionable Implementation Rules & Code Blocks
69
+ Provide copy-paste ready, production-grade code snippets showcasing idiomatic modern patterns.
114
70
 
115
71
  ---
116
72
 
117
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
73
+ ## 🏛️ Tribunal Verification & Guardrails
118
74
 
119
75
  **Slash command: `/review` or `/tribunal-full`**
120
76
  **Active reviewers: `logic-reviewer` · `security-auditor`**
121
77
 
122
78
  ### ❌ Forbidden AI Tropes
123
-
124
79
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
125
80
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
126
81
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
127
82
 
128
83
  ### ✅ Pre-Flight Self-Audit
129
-
130
- Review these questions before confirming output:
131
-
132
84
  ```
133
85
  ✅ Did I rely ONLY on real, verified tools and methods?
134
86
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -137,8 +89,6 @@ Review these questions before confirming output:
137
89
  ```
138
90
 
139
91
  ### 🛑 Verification-Before-Completion (VBC) Protocol
140
-
141
92
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
142
-
143
93
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
144
94
  - ✅ **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: soft-skill
3
3
  description: High-end visual design guidance for premium typography, spacing, depth, and animation systems.
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
  - taste-skill
8
8
  - progressive-blur
@@ -27,6 +27,12 @@ Before engineering luxury or soft-depth UI interfaces, you MUST inspect:
27
27
 
28
28
  Craft high-end, luxury interfaces featuring soft depth, gentle surface transitions, quiet typography, and tactile spatial rhythm.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring High-end visual design guidance for premium typography, spacing, depth, and animation systems..
34
+ - **DO NOT activate when:** The task falls strictly outside soft-skill domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## 4 Soft Design Rules
@@ -60,28 +66,25 @@ Craft high-end, luxury interfaces featuring soft depth, gentle surface transitio
60
66
 
61
67
  ---
62
68
 
63
- ## 🤖 LLM-Specific Traps
69
+ ## 🏛️ Tribunal Verification & Guardrails
64
70
 
65
- 1. **Muddy Dark Shadows**: Using heavy `rgba(0,0,0,0.5)` drop shadows on light surfaces.
66
- 2. **Cramped Containers**: Packing text elements tightly inside small containers with minimal padding.
67
-
68
- ---
71
+ **Slash command: `/review` or `/tribunal-full`**
72
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
69
73
 
70
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
71
-
72
- **Active reviewers: `frontend-reviewer` · `ui-ux-auditor`**
74
+ ### Forbidden AI Tropes
75
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
76
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
77
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
73
78
 
74
79
  ### ✅ Pre-Flight Self-Audit
75
-
76
80
  ```
77
- Are drop shadows multi-layered with opacity under 6% per layer?
78
- ✅ Is container padding generous ($\ge 24\text{px}$)?
79
- Is color palette subdued and monochromatic?
81
+ Did I rely ONLY on real, verified tools and methods?
82
+ ✅ Is this solution appropriately scoped to the user's constraints?
83
+ Did I handle potential failure modes and edge cases?
84
+ ✅ Have I avoided generic boilerplate that doesn't add value?
80
85
  ```
81
86
 
82
87
  ### 🛑 Verification-Before-Completion (VBC) Protocol
83
-
84
88
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
85
-
86
89
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
87
90
  - ✅ **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.