tribunal-kit 5.8.5 → 6.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (315) hide show
  1. package/.agent/.manifest.json +78 -0
  2. package/.agent/ARCHITECTURE.md +32 -253
  3. package/.agent/agents/accessibility-reviewer.md +66 -151
  4. package/.agent/agents/ai-code-reviewer.md +22 -2
  5. package/.agent/agents/anti-pattern-reviewer.md +99 -0
  6. package/.agent/agents/api-architect.md +19 -2
  7. package/.agent/agents/backend-specialist.md +25 -3
  8. package/.agent/agents/cloud-engineer.md +21 -0
  9. package/.agent/agents/code-archaeologist.md +20 -3
  10. package/.agent/agents/complexity-reviewer.md +22 -2
  11. package/.agent/agents/database-architect.md +24 -3
  12. package/.agent/agents/db-latency-auditor.md +22 -2
  13. package/.agent/agents/debugger.md +19 -3
  14. package/.agent/agents/dependency-reviewer.md +19 -2
  15. package/.agent/agents/devops-engineer.md +24 -3
  16. package/.agent/agents/documentation-writer.md +21 -3
  17. package/.agent/agents/explorer-agent.md +21 -3
  18. package/.agent/agents/frontend-reviewer.md +19 -3
  19. package/.agent/agents/frontend-specialist.md +72 -224
  20. package/.agent/agents/game-developer.md +22 -3
  21. package/.agent/agents/interaction-reviewer.md +118 -0
  22. package/.agent/agents/logic-reviewer.md +18 -3
  23. package/.agent/agents/minimalist-reviewer.md +98 -0
  24. package/.agent/agents/mobile-developer.md +21 -3
  25. package/.agent/agents/mobile-reviewer.md +22 -2
  26. package/.agent/agents/orchestrator.md +19 -3
  27. package/.agent/agents/penetration-tester.md +22 -3
  28. package/.agent/agents/performance-optimizer.md +21 -3
  29. package/.agent/agents/performance-reviewer.md +2 -0
  30. package/.agent/agents/precedence-reviewer.md +19 -5
  31. package/.agent/agents/product-manager.md +20 -3
  32. package/.agent/agents/product-owner.md +22 -1
  33. package/.agent/agents/product-reviewer.md +98 -0
  34. package/.agent/agents/project-planner.md +19 -3
  35. package/.agent/agents/qa-automation-engineer.md +24 -3
  36. package/.agent/agents/resilience-reviewer.md +21 -2
  37. package/.agent/agents/schema-reviewer.md +21 -2
  38. package/.agent/agents/security-auditor.md +7 -1
  39. package/.agent/agents/seo-specialist.md +18 -3
  40. package/.agent/agents/sql-reviewer.md +22 -2
  41. package/.agent/agents/supervisor-agent.md +22 -3
  42. package/.agent/agents/swarm-worker-registry.md +7 -0
  43. package/.agent/agents/system-architect.md +19 -0
  44. package/.agent/agents/test-coverage-reviewer.md +22 -2
  45. package/.agent/agents/test-engineer.md +21 -2
  46. package/.agent/agents/throughput-optimizer.md +22 -2
  47. package/.agent/agents/type-safety-reviewer.md +21 -2
  48. package/.agent/agents/ui-ux-auditor.md +44 -242
  49. package/.agent/agents/ui-visual-auditor.md +99 -0
  50. package/.agent/agents/ux-reviewer.md +104 -0
  51. package/.agent/agents/visual-reviewer.md +98 -0
  52. package/.agent/agents/vitals-reviewer.md +23 -2
  53. package/.agent/history/README.md +53 -0
  54. package/.agent/history/case-law/cases/template-case.json +19 -0
  55. package/.agent/history/integrity_manifest.json +63 -33
  56. package/.agent/history/memory/.memory.idx +2701 -1
  57. package/.agent/history/memory/MEMORY.md +179 -1
  58. package/.agent/routing_index.json +273 -690
  59. package/.agent/rules/GEMINI.md +11 -13
  60. package/.agent/rules/GEMINI_PLANNER.md +84 -0
  61. package/.agent/scripts/case_law_manager.js +2 -0
  62. package/.agent/scripts/context_broker.js +152 -0
  63. package/.agent/scripts/guardrail_engine.js +59 -4
  64. package/.agent/scripts/impact_classifier.js +167 -0
  65. package/.agent/scripts/minimal_change_engine.js +437 -0
  66. package/.agent/scripts/pipeline_engine.js +856 -0
  67. package/.agent/scripts/socratic_gate_policy.js +60 -0
  68. package/.agent/scripts/token_budget_broker.js +52 -0
  69. package/.agent/scripts/verify_all.js +13 -0
  70. package/.agent/scripts/visual_audit.js +92 -0
  71. package/.agent/skill_topic_map.json +218 -0
  72. package/.agent/skills/12-principles-of-animation/SKILL.md +19 -10
  73. package/.agent/skills/60fps-animation/SKILL.md +19 -10
  74. package/.agent/skills/accessible-animation/SKILL.md +19 -10
  75. package/.agent/skills/adapt/SKILL.md +19 -10
  76. package/.agent/skills/advanced-rag-pipelines/SKILL.md +21 -3
  77. package/.agent/skills/agent-organizer/SKILL.md +21 -7
  78. package/.agent/skills/agentic-patterns/SKILL.md +19 -7
  79. package/.agent/skills/agentic-workflows-2026/SKILL.md +76 -0
  80. package/.agent/skills/ai-app-hardening/SKILL.md +58 -0
  81. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +21 -7
  82. package/.agent/skills/animation-on-scroll/SKILL.md +19 -10
  83. package/.agent/skills/animation-systems/SKILL.md +19 -10
  84. package/.agent/skills/antfu-conventions/SKILL.md +21 -10
  85. package/.agent/skills/api-patterns/SKILL.md +21 -7
  86. package/.agent/skills/api-security-auditor/SKILL.md +21 -7
  87. package/.agent/skills/app-builder/SKILL.md +21 -7
  88. package/.agent/skills/apple-design/SKILL.md +19 -10
  89. package/.agent/skills/architecture/SKILL.md +21 -7
  90. package/.agent/skills/audit-and-fix/SKILL.md +19 -10
  91. package/.agent/skills/authentication-best-practices/SKILL.md +21 -7
  92. package/.agent/skills/backend-security-expert/SKILL.md +21 -7
  93. package/.agent/skills/baseline-ui/SKILL.md +19 -10
  94. package/.agent/skills/bash-linux/SKILL.md +21 -7
  95. package/.agent/skills/behavioral-modes/SKILL.md +19 -7
  96. package/.agent/skills/better-colors/SKILL.md +19 -10
  97. package/.agent/skills/better-ui/SKILL.md +19 -10
  98. package/.agent/skills/bolder/SKILL.md +19 -10
  99. package/.agent/skills/brainstorming/SKILL.md +17 -7
  100. package/.agent/skills/browser-native-ai/SKILL.md +19 -3
  101. package/.agent/skills/build-primitive/SKILL.md +19 -10
  102. package/.agent/skills/building-native-ui/SKILL.md +21 -7
  103. package/.agent/skills/cicd-pro/SKILL.md +21 -10
  104. package/.agent/skills/clarify/SKILL.md +19 -10
  105. package/.agent/skills/clean-code/SKILL.md +21 -7
  106. package/.agent/skills/cloud-architect/SKILL.md +21 -10
  107. package/.agent/skills/cobejs/SKILL.md +19 -10
  108. package/.agent/skills/code-review-checklist/SKILL.md +21 -7
  109. package/.agent/skills/codebase-design/SKILL.md +21 -10
  110. package/.agent/skills/colorize/SKILL.md +19 -10
  111. package/.agent/skills/compact-landing/SKILL.md +19 -10
  112. package/.agent/skills/company-logos/SKILL.md +19 -10
  113. package/.agent/skills/config-validator/SKILL.md +21 -7
  114. package/.agent/skills/containerization-pro/SKILL.md +21 -10
  115. package/.agent/skills/context-engineering-pro/SKILL.md +69 -0
  116. package/.agent/skills/create-design-md/SKILL.md +19 -10
  117. package/.agent/skills/critique/SKILL.md +19 -10
  118. package/.agent/skills/csharp-developer/SKILL.md +21 -7
  119. package/.agent/skills/data-validation-schemas/SKILL.md +21 -7
  120. package/.agent/skills/database-design/SKILL.md +21 -7
  121. package/.agent/skills/delight/SKILL.md +19 -10
  122. package/.agent/skills/deployment-procedures/SKILL.md +21 -7
  123. package/.agent/skills/design-lab/SKILL.md +21 -10
  124. package/.agent/skills/devops-engineer/SKILL.md +21 -7
  125. package/.agent/skills/devops-incident-responder/SKILL.md +21 -7
  126. package/.agent/skills/diagnosing-bugs/SKILL.md +21 -10
  127. package/.agent/skills/distill/SKILL.md +19 -10
  128. package/.agent/skills/documentation-templates/SKILL.md +21 -7
  129. package/.agent/skills/domain-modeling/SKILL.md +21 -10
  130. package/.agent/skills/duckdb-analytical-sql/SKILL.md +55 -0
  131. package/.agent/skills/edge-ai-mobile/SKILL.md +46 -0
  132. package/.agent/skills/edge-computing/SKILL.md +21 -7
  133. package/.agent/skills/emil-design-eng/SKILL.md +19 -10
  134. package/.agent/skills/error-resilience/SKILL.md +21 -7
  135. package/.agent/skills/expo-router-v4/SKILL.md +80 -0
  136. package/.agent/skills/extract-design-system/SKILL.md +21 -7
  137. package/.agent/skills/fabel-protocol/SKILL.md +19 -2
  138. package/.agent/skills/fixing-accessibility/SKILL.md +19 -10
  139. package/.agent/skills/fixing-metadata/SKILL.md +19 -10
  140. package/.agent/skills/fixing-motion-performance/SKILL.md +19 -10
  141. package/.agent/skills/framer-motion-expert/SKILL.md +19 -6
  142. package/.agent/skills/frontend-design/SKILL.md +64 -201
  143. package/.agent/skills/frontend-security-expert/SKILL.md +21 -7
  144. package/.agent/skills/game-design-expert/SKILL.md +21 -7
  145. package/.agent/skills/game-engineering-expert/SKILL.md +21 -7
  146. package/.agent/skills/generative-ui-expert/SKILL.md +19 -3
  147. package/.agent/skills/geo-fundamentals/SKILL.md +21 -7
  148. package/.agent/skills/git-pro/SKILL.md +21 -10
  149. package/.agent/skills/github-operations/SKILL.md +21 -7
  150. package/.agent/skills/gpt-taste/SKILL.md +19 -10
  151. package/.agent/skills/gsap-core/SKILL.md +21 -4
  152. package/.agent/skills/gsap-frameworks/SKILL.md +21 -4
  153. package/.agent/skills/gsap-performance/SKILL.md +20 -5
  154. package/.agent/skills/gsap-plugins/SKILL.md +20 -5
  155. package/.agent/skills/gsap-react/SKILL.md +20 -5
  156. package/.agent/skills/gsap-scrolltrigger/SKILL.md +21 -4
  157. package/.agent/skills/gsap-timeline/SKILL.md +20 -5
  158. package/.agent/skills/gsap-utils/SKILL.md +20 -5
  159. package/.agent/skills/harden/SKILL.md +19 -10
  160. package/.agent/skills/harness-protocol/SKILL.md +20 -4
  161. package/.agent/skills/i18n-localization/SKILL.md +21 -7
  162. package/.agent/skills/impeccable/SKILL.md +19 -10
  163. package/.agent/skills/improve-codebase-architecture/SKILL.md +21 -10
  164. package/.agent/skills/improve-ui/SKILL.md +19 -10
  165. package/.agent/skills/intelligent-routing/SKILL.md +19 -7
  166. package/.agent/skills/knowledge-graph/SKILL.md +20 -4
  167. package/.agent/skills/landing-page/SKILL.md +20 -10
  168. package/.agent/skills/lint-and-validate/SKILL.md +21 -7
  169. package/.agent/skills/llm-engineering/SKILL.md +21 -7
  170. package/.agent/skills/local-first/SKILL.md +21 -7
  171. package/.agent/skills/local-first-architecture/SKILL.md +19 -10
  172. package/.agent/skills/lottie-animation/SKILL.md +19 -10
  173. package/.agent/skills/marquee-loop/SKILL.md +19 -10
  174. package/.agent/skills/masked-reveal/SKILL.md +19 -10
  175. package/.agent/skills/mcp-builder/SKILL.md +21 -7
  176. package/.agent/skills/micro-interaction/SKILL.md +19 -10
  177. package/.agent/skills/mobile-design/SKILL.md +21 -6
  178. package/.agent/skills/monorepo-management/SKILL.md +21 -7
  179. package/.agent/skills/morphing-icons/SKILL.md +19 -10
  180. package/.agent/skills/motion-engineering/SKILL.md +20 -7
  181. package/.agent/skills/nextjs-react-expert/SKILL.md +19 -7
  182. package/.agent/skills/nodejs-best-practices/SKILL.md +21 -7
  183. package/.agent/skills/observability/SKILL.md +21 -7
  184. package/.agent/skills/opentelemetry-observability/SKILL.md +58 -0
  185. package/.agent/skills/page-transition-animation/SKILL.md +19 -10
  186. package/.agent/skills/parallel-agents/SKILL.md +23 -7
  187. package/.agent/skills/performance-profiling/SKILL.md +21 -7
  188. package/.agent/skills/plan-writing/SKILL.md +21 -7
  189. package/.agent/skills/platform-engineer/SKILL.md +21 -7
  190. package/.agent/skills/platform-engineering-opentofu/SKILL.md +67 -0
  191. package/.agent/skills/playwright-ai-e2e/SKILL.md +59 -0
  192. package/.agent/skills/playwright-best-practices/SKILL.md +21 -7
  193. package/.agent/skills/polish/SKILL.md +19 -10
  194. package/.agent/skills/powershell-windows/SKILL.md +21 -7
  195. package/.agent/skills/pricing-page/SKILL.md +19 -10
  196. package/.agent/skills/product-aware-heuristics/SKILL.md +358 -0
  197. package/.agent/skills/progressive-blur/SKILL.md +19 -10
  198. package/.agent/skills/project-idioms/SKILL.md +20 -8
  199. package/.agent/skills/property-based-testing/SKILL.md +60 -0
  200. package/.agent/skills/python-patterns/SKILL.md +21 -7
  201. package/.agent/skills/python-pro/SKILL.md +21 -6
  202. package/.agent/skills/quieter/SKILL.md +19 -10
  203. package/.agent/skills/react-doctor/SKILL.md +19 -10
  204. package/.agent/skills/react-specialist/SKILL.md +19 -6
  205. package/.agent/skills/readme-builder/SKILL.md +21 -7
  206. package/.agent/skills/realtime-patterns/SKILL.md +21 -7
  207. package/.agent/skills/red-team-tactics/SKILL.md +21 -7
  208. package/.agent/skills/redesign-skill/SKILL.md +19 -10
  209. package/.agent/skills/review-animations/SKILL.md +21 -10
  210. package/.agent/skills/rust-pro/SKILL.md +21 -7
  211. package/.agent/skills/seo-fundamentals/SKILL.md +21 -7
  212. package/.agent/skills/server-management/SKILL.md +21 -7
  213. package/.agent/skills/shadcn-ui-expert/SKILL.md +21 -7
  214. package/.agent/skills/shape/SKILL.md +19 -10
  215. package/.agent/skills/skill-creator/SKILL.md +21 -7
  216. package/.agent/skills/soft-skill/SKILL.md +19 -10
  217. package/.agent/skills/sounds-on-the-web/SKILL.md +19 -10
  218. package/.agent/skills/sql-pro/SKILL.md +21 -7
  219. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +21 -7
  220. package/.agent/skills/svg-animation/SKILL.md +19 -10
  221. package/.agent/skills/swiftui-expert/SKILL.md +21 -7
  222. package/.agent/skills/swiss-design/SKILL.md +19 -10
  223. package/.agent/skills/system-design-pro/SKILL.md +21 -9
  224. package/.agent/skills/systematic-debugging/SKILL.md +21 -7
  225. package/.agent/skills/tailwind-patterns/SKILL.md +21 -7
  226. package/.agent/skills/taste-skill/SKILL.md +19 -10
  227. package/.agent/skills/tdd-workflow/SKILL.md +21 -10
  228. package/.agent/skills/test-result-analyzer/SKILL.md +18 -6
  229. package/.agent/skills/testing-patterns/SKILL.md +21 -7
  230. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +21 -10
  231. package/.agent/skills/thinking-protocol/SKILL.md +20 -8
  232. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -10
  233. package/.agent/skills/transitions-dev/SKILL.md +19 -10
  234. package/.agent/skills/trend-researcher/SKILL.md +17 -6
  235. package/.agent/skills/typescript-advanced/SKILL.md +21 -7
  236. package/.agent/skills/typeset/SKILL.md +19 -10
  237. package/.agent/skills/ui-reasoning-engine/SKILL.md +154 -0
  238. package/.agent/skills/ui-skill-packs/SKILL.md +77 -0
  239. package/.agent/skills/ui-skills-root/SKILL.md +21 -9
  240. package/.agent/skills/ui-ux-pro-max/SKILL.md +62 -583
  241. package/.agent/skills/ui-ux-researcher/SKILL.md +17 -6
  242. package/.agent/skills/vector-search-pgvector/SKILL.md +77 -0
  243. package/.agent/skills/vue-expert/SKILL.md +19 -6
  244. package/.agent/skills/vulnerability-scanner/SKILL.md +21 -7
  245. package/.agent/skills/web-accessibility-auditor/SKILL.md +21 -7
  246. package/.agent/skills/web-design-guidelines/SKILL.md +32 -206
  247. package/.agent/skills/web-quality-audit/SKILL.md +19 -10
  248. package/.agent/skills/webapp-testing/SKILL.md +21 -7
  249. package/.agent/skills/webgpu-performance/SKILL.md +19 -3
  250. package/.agent/skills/whimsy-injector/SKILL.md +20 -10
  251. package/.agent/skills/workflow-optimizer/SKILL.md +16 -6
  252. package/.agent/skills/zero-trust-passkeys/SKILL.md +85 -0
  253. package/.agent/templates/DESIGN.md +292 -0
  254. package/.agent/templates/design-tokens.json +137 -0
  255. package/.agent/workflows/acf.md +13 -6
  256. package/.agent/workflows/api-tester.md +15 -8
  257. package/.agent/workflows/audit.md +19 -8
  258. package/.agent/workflows/brainstorm.md +14 -9
  259. package/.agent/workflows/changelog.md +14 -8
  260. package/.agent/workflows/create.md +16 -8
  261. package/.agent/workflows/debug.md +15 -10
  262. package/.agent/workflows/deploy.md +16 -8
  263. package/.agent/workflows/enhance.md +15 -10
  264. package/.agent/workflows/fix.md +15 -8
  265. package/.agent/workflows/generate.md +17 -11
  266. package/.agent/workflows/marathon.md +15 -8
  267. package/.agent/workflows/migrate.md +16 -8
  268. package/.agent/workflows/minimal.md +94 -0
  269. package/.agent/workflows/orchestrate.md +15 -8
  270. package/.agent/workflows/performance-benchmarker.md +15 -8
  271. package/.agent/workflows/pipeline.md +155 -0
  272. package/.agent/workflows/plan.md +14 -10
  273. package/.agent/workflows/preview.md +14 -7
  274. package/.agent/workflows/refactor.md +16 -8
  275. package/.agent/workflows/review-ai.md +15 -7
  276. package/.agent/workflows/review.md +15 -7
  277. package/.agent/workflows/session.md +14 -7
  278. package/.agent/workflows/status.md +13 -7
  279. package/.agent/workflows/strengthen-skills.md +15 -6
  280. package/.agent/workflows/super-prompt.md +19 -10
  281. package/.agent/workflows/swarm.md +15 -7
  282. package/.agent/workflows/test.md +15 -8
  283. package/.agent/workflows/tribunal-backend.md +16 -9
  284. package/.agent/workflows/tribunal-database.md +15 -8
  285. package/.agent/workflows/tribunal-frontend.md +26 -11
  286. package/.agent/workflows/tribunal-full.md +41 -26
  287. package/.agent/workflows/tribunal-mobile.md +15 -8
  288. package/.agent/workflows/tribunal-performance.md +15 -8
  289. package/.agent/workflows/tribunal-speed.md +16 -9
  290. package/.agent/workflows/tribunal-ui.md +82 -0
  291. package/.agent/workflows/ui-ux-pro-max.md +51 -107
  292. package/CONTRIBUTING.md +2 -2
  293. package/README.md +82 -60
  294. package/SECURITY.md +3 -3
  295. package/bin/mcp-server.js +253 -57
  296. package/bin/wrapper.js +24 -10
  297. package/dist/cli.js +29 -1
  298. package/dist/commands/compile.js +7 -0
  299. package/dist/commands/context.js +8 -3
  300. package/dist/commands/graph.js +8 -2
  301. package/dist/commands/init.js +13 -2
  302. package/dist/commands/memory.js +120 -68
  303. package/dist/commands/minimal.js +71 -0
  304. package/dist/commands/native.js +36 -0
  305. package/dist/commands/optimize.js +15 -5
  306. package/dist/esm/index.mjs +58 -32
  307. package/dist/index.d.ts +50 -2
  308. package/dist/utils/fs.js +10 -4
  309. package/dist/utils/helpers.js +10 -1
  310. package/dist/utils/version.js +9 -2
  311. package/mcp_config.json +10 -1
  312. package/package.json +16 -10
  313. package/scripts/benchmark.js +16 -0
  314. package/scripts/sync-version.js +1 -1
  315. package/scripts/visual_audit.js +126 -0
@@ -0,0 +1,155 @@
1
+ ---
2
+ description: Hybrid 3-Pass Code Generation pipeline. Pass 1 (Planner) → Pass 2 (Builder) → Pass 3 (Zero-LLM Deterministic Validator). Maximizes code generation quality while keeping prompt context hyper-efficient.
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - clean-code
8
+ - codebase-design
9
+ - lint-and-validate
10
+ scripts-binding:
11
+ - .agent/scripts/pipeline_engine.js
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/security_scan.js
14
+ ---
15
+
16
+ # /pipeline — Hybrid 3-Pass Code Generation
17
+
18
+ $ARGUMENTS
19
+
20
+ ---
21
+
22
+ ## Mandatory Pre-Flight Context Inspection
23
+
24
+ Before running 3-pass pipeline generation, you MUST inspect:
25
+ 1. Pipeline Engine Script (`.agent/scripts/pipeline_engine.js`) → Verify availability and options (`--task`, `--file`, `--phase`)
26
+ 2. Context Token Allocation -> Keep Pass 2 builder prompt under 2,500 tokens (loading max 3 essential skill key-rules)
27
+ 3. Zero-LLM Pass 3 Validator → Run deterministic security, lint, and type checks on generated code prior to Human Gate submission
28
+
29
+ ## When to Use /pipeline
30
+
31
+ | Use `/pipeline` when... | Use something else when... |
32
+ | :---------------------------------------------- | :--------------------------------------------- |
33
+ | Code generation quality is the top priority | Quick single-line fix → direct edit |
34
+ | Context window saturation is causing weak output | Need full tribunal review → `/generate` |
35
+ | Building UI components, APIs, or complex logic | Exploring options → `/brainstorm` |
36
+ | You want maximum LLM attention on code synthesis | Planning architecture → `/plan` |
37
+
38
+ ---
39
+
40
+ ## Architecture
41
+
42
+ ```
43
+ User Task → Pass 1 (Planner) → Pass 2 (Builder) → Pass 3 (Validator) → Human Gate
44
+ ~1,500 tokens ~2,500 tokens 0 tokens (deterministic)
45
+ ```
46
+
47
+ **vs. monolithic /generate: ~12,000–18,000 tokens in a single pass**
48
+
49
+ ---
50
+
51
+ ## Phase 1 — Plan (Automatic)
52
+
53
+ The pipeline engine classifies the task, detects the stack, and selects 2-3 essential skills.
54
+
55
+ ```bash
56
+ node .agent/scripts/pipeline_engine.js --task "$TASK" --file "$FILE" --phase plan --output json
57
+ ```
58
+
59
+ Output: Structured spec JSON with task_type, stack, essential_skills, and constraints.
60
+
61
+ **Human Gate**: Review the spec before proceeding to generation.
62
+
63
+ ---
64
+
65
+ ## Phase 2 — Build (Focused Generation)
66
+
67
+ Assembles a minimal prompt containing ONLY:
68
+ - The spec from Phase 1
69
+ - 2-3 essential skill key-rules (condensed)
70
+ - Target file content (if modifying existing code)
71
+
72
+ ```bash
73
+ node .agent/scripts/pipeline_engine.js --task "$TASK" --file "$FILE" --phase build --output prompt
74
+ ```
75
+
76
+ **What is NOT in the prompt (saving ~10,000 tokens):**
77
+ - ❌ Full GEMINI.md master rules
78
+ - ❌ Agent persona definitions
79
+ - ❌ Tribunal gate rules
80
+ - ❌ Error recovery protocol
81
+ - ❌ Fabel Protocol cognitive loops
82
+ - ❌ Unrelated domain skills
83
+
84
+ The LLM receives a clean, focused prompt and can dedicate 75%+ of its attention to generating high-quality code.
85
+
86
+ ---
87
+
88
+ ## Phase 3 — Validate (Zero-LLM Deterministic)
89
+
90
+ After code is generated, run deterministic validation:
91
+
92
+ ```bash
93
+ node .agent/scripts/pipeline_engine.js --phase validate --code ./output.tsx
94
+ ```
95
+
96
+ Checks:
97
+ - ✅ OWASP security patterns (eval, innerHTML, hardcoded secrets, SQL injection)
98
+ - ✅ TypeScript `any` usage
99
+ - ✅ Empty catch blocks
100
+ - ✅ Console.log pollution
101
+ - ✅ Error handling gaps
102
+
103
+ If validation fails → structured feedback is generated for automated retry (max 3 attempts).
104
+
105
+ ---
106
+
107
+ ## Full Pipeline (All Phases)
108
+
109
+ ```bash
110
+ node .agent/scripts/pipeline_engine.js --task "$TASK" --file "$FILE" --output report
111
+ ```
112
+
113
+ Or in dry-run mode:
114
+ ```bash
115
+ node .agent/scripts/pipeline_engine.js --task "$TASK" --file "$FILE" --dry-run
116
+ ```
117
+
118
+ ---
119
+
120
+ ## Pipeline Guard
121
+
122
+ ```
123
+ ❌ Never load GEMINI.md into Pass 2 — the planner already distilled what's needed
124
+ ❌ Never skip Pass 3 validation — it's zero-cost (no LLM calls)
125
+ ❌ Never select more than 3 skills for a single generation pass
126
+ ❌ Never inject agent persona definitions into the builder prompt
127
+ ❌ Never bypass the Human Gate — even in pipeline mode
128
+ ```
129
+
130
+ ---
131
+
132
+ ## Comparison: /generate vs /pipeline
133
+
134
+ | Dimension | `/generate` (current) | `/pipeline` (new) |
135
+ | :---------------------------- | :-------------------- | :---------------------- |
136
+ | System prompt tokens | ~12,000–18,000 | ~2,500 (Pass 2) |
137
+ | % context for actual task | ~11% | ~75% |
138
+ | Governance overhead | ~89% | ~25% |
139
+ | Post-gen validation | LLM-based (expensive) | Deterministic (free) |
140
+ | Skills loaded per generation | 6–10 | 2–3 |
141
+ | Self-healing retry | Full re-generation | Targeted feedback loop |
142
+ | Backward compatibility | N/A | 100% (additive) |
143
+
144
+ ---
145
+
146
+ ## After /pipeline — Next Steps
147
+
148
+ | Outcome | Next Command |
149
+ | :---------------------------- | :---------------------------------- |
150
+ | Code generated, needs review | → `/review` for human audit |
151
+ | Code has issues after retry | → `/generate` with full tribunal |
152
+ | Code passed, ready to test | → `/test` for test generation |
153
+ | Code passed, ready to deploy | → `/deploy` with pre-flight checks |
154
+
155
+ ---
@@ -1,6 +1,14 @@
1
1
  ---
2
2
  description: Create project plan using project-planner agent. 4-phase approach: Analyze → Research → Plan Document → Human Gate. NO code writing — only plan file generation. Writing begins only after explicit human approval.
3
- required-skills: plan-writing, architecture
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - plan-writing
8
+ - architecture
9
+ - project-planner
10
+ scripts-binding:
11
+ - .agent/scripts/verify_all.js
4
12
  ---
5
13
 
6
14
  # /plan — Strategic Implementation Planning
@@ -9,16 +17,12 @@ $ARGUMENTS
9
17
 
10
18
  ---
11
19
 
12
- ## $CONTEXT_REQUIRED
20
+ ## Mandatory Pre-Flight Context Inspection
13
21
 
14
- ```
15
- Read BEFORE writing the plan:
16
- package.json Actual dependencies and scripts
17
- tsconfig.json TypeScript config and path aliases
18
- □ prisma/schema.prisma → If DB changes planned (skip if not applicable)
19
- □ src/ directory listing → Current project structure
20
- □ git log --oneline -5 → Recent work context
21
- ```
22
+ Before drafting implementation plans or technical blueprints, you MUST inspect:
23
+ 1. Workspace Context & Dependencies (`package.json`, `tsconfig.json`) → Confirm current stack capabilities and path mappings
24
+ 2. Existing Architecture & Directory Layout Review current module boundaries to prevent redundant architectural patterns
25
+ 3. Zero Code Modification Rule Restrict outputs in `/plan` mode to research, architectural design, and plan artifact generation; ban code generation before Plan approval
22
26
 
23
27
  ---
24
28
 
@@ -1,6 +1,14 @@
1
1
  ---
2
2
  description: Preview server start, stop, and status check. Local development server management. Uses auto_preview.js for automated lifecycle control. Shows current URL and hot-reload status.
3
- required-skills: bash-linux, frontend-specialist
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - bash-linux
8
+ - frontend-specialist
9
+ - devops-engineer
10
+ scripts-binding:
11
+ - .agent/scripts/auto_preview.js
4
12
  ---
5
13
 
6
14
  # /preview — Local Development Server
@@ -9,13 +17,12 @@ $ARGUMENTS
9
17
 
10
18
  ---
11
19
 
12
- ## $CONTEXT_REQUIRED
20
+ ## Mandatory Pre-Flight Context Inspection
13
21
 
14
- ```
15
- Read BEFORE managing preview:
16
- package.json → Check dev script command and environment
17
- .env Verify preview environment keys
18
- ```
22
+ Before managing dev server lifecycle or starting preview servers, you MUST inspect:
23
+ 1. Workspace Dev Script Configuration (`package.json`) → Verify `npm run dev` or equivalent start script and framework server port
24
+ 2. Environment Configuration (`.env`) → Check port bindings and dev server host configs
25
+ 3. Dev Server Lifecycle Script (`.agent/scripts/auto_preview.js`) Use automated script for process management, port collision detection, and health checks
19
26
 
20
27
  ---
21
28
 
@@ -1,6 +1,16 @@
1
1
  ---
2
2
  description: Structured code refactoring with dependency-safe execution and behavior preservation. Maps all dependents before touching any file. Refactoring changes structure without changing observable behavior. Tests must pass before and after every step.
3
- required-skills: clean-code, architecture
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - clean-code
8
+ - architecture
9
+ - codebase-design
10
+ - tdd-workflow
11
+ scripts-binding:
12
+ - .agent/scripts/test_runner.js
13
+ - .agent/scripts/lint_runner.js
4
14
  ---
5
15
 
6
16
  # /refactor — Dependency-Safe Structural Improvement
@@ -9,14 +19,12 @@ $ARGUMENTS
9
19
 
10
20
  ---
11
21
 
12
- ## $CONTEXT_REQUIRED
22
+ ## Mandatory Pre-Flight Context Inspection
13
23
 
14
- ```
15
- Read BEFORE refactoring:
16
- Target module Understand the structure to be extracted or renamed
17
- package.json Check test scripts to run after refactor
18
- □ grep search → Locate all importers of the target module
19
- ```
24
+ Before executing structural refactoring or extracting interfaces, you MUST inspect:
25
+ 1. Complete Dependent Map (Grep Importers) → Identify every file importing the target module before touching a single line
26
+ 2. Baseline Test Suite Verification (`test_runner.js`) Ensure all unit and integration tests pass BEFORE initiating refactor steps
27
+ 3. Observable Behavior Preservation Enforce zero change in public function behavior or API contracts; verify tests pass cleanly after every step
20
28
 
21
29
  ---
22
30
 
@@ -1,6 +1,15 @@
1
1
  ---
2
2
  description: Audit AI/LLM integration code for hallucinated model names, invented API parameters, prompt injection vulnerabilities, missing rate-limit handling, streaming error gaps, and cost explosion patterns. Uses ai-code-reviewer + logic + security.
3
- required-skills: llm-engineering, ai-prompt-injection-defense
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - llm-engineering
8
+ - ai-prompt-injection-defense
9
+ - generative-ui-expert
10
+ scripts-binding:
11
+ - .agent/scripts/security_scan.js
12
+ - .agent/scripts/lint_runner.js
4
13
  ---
5
14
 
6
15
  # /review-ai — AI Integration Code Audit
@@ -9,13 +18,12 @@ $ARGUMENTS
9
18
 
10
19
  ---
11
20
 
12
- ## $CONTEXT_REQUIRED
21
+ ## Mandatory Pre-Flight Context Inspection
13
22
 
14
- ```
15
- Read BEFORE reviewing:
16
- Target AI files The LLM integrations or prompts
17
- □ package.json → Which SDKs are used (e.g. ai, openai)
18
- ```
23
+ Before auditing LLM integrations, prompt templates, or AI API calls, you MUST inspect:
24
+ 1. Target AI Code & SDK Manifests (`package.json`) → Verify official AI SDK versions (Vercel AI SDK `ai`, `@langchain/core`, `openai`, `@google/genai`)
25
+ 2. Prompt Injection Boundary Check Confirm user inputs are strictly passed via message roles or delimited blocks; ban string concatenation into system prompts
26
+ 3. 3-Reviewer AI Integration Gate Run ai-code-reviewer, logic-reviewer, and security-auditor before approving AI code diffs
19
27
 
20
28
  ---
21
29
 
@@ -1,6 +1,15 @@
1
1
  ---
2
2
  description: Audit existing code for hallucinations. Runs Logic + Security reviewers on any code without generating anything new. The pure review mode — read, analyze, and report only.
3
- required-skills: code-review-checklist, vulnerability-scanner
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - code-review-checklist
8
+ - vulnerability-scanner
9
+ - clean-code
10
+ scripts-binding:
11
+ - .agent/scripts/security_scan.js
12
+ - .agent/scripts/lint_runner.js
4
13
  ---
5
14
 
6
15
  # /review — Hallucination Audit (Read-Only)
@@ -9,13 +18,12 @@ $ARGUMENTS
9
18
 
10
19
  ---
11
20
 
12
- ## $CONTEXT_REQUIRED
21
+ ## Mandatory Pre-Flight Context Inspection
13
22
 
14
- ```
15
- Read BEFORE reviewing:
16
- Target code files The files that need auditing
17
- package.json Check dependencies used by target files
18
- ```
23
+ Before auditing code for hallucinations or structural flaws, you MUST inspect:
24
+ 1. Target Source Code & Dependent Modules → Read target files and their import declarations
25
+ 2. Package Manifest (`package.json`) Cross-reference imported packages against installed dependencies
26
+ 3. Pure Read-Only Constraint Prohibit any file mutations or generation; output findings in structured audit tables strictly
19
27
 
20
28
  ---
21
29
 
@@ -1,6 +1,14 @@
1
1
  ---
2
2
  description: Interactive session state tracking for multi-conversation context continuity. Saves and restores agent context across separate sessions so work can be resumed without losing progress.
3
- required-skills: behavioral-modes, agent-organizer
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - behavioral-modes
8
+ - agent-organizer
9
+ - harness-protocol
10
+ scripts-binding:
11
+ - .agent/scripts/session_manager.js
4
12
  ---
5
13
 
6
14
  # /session — Session State Management
@@ -9,13 +17,12 @@ $ARGUMENTS
9
17
 
10
18
  ---
11
19
 
12
- ## $CONTEXT_REQUIRED
20
+ ## Mandatory Pre-Flight Context Inspection
13
21
 
14
- ```
15
- Read BEFORE managing session:
16
- .agent/scripts/session_manager.js Verify script exists and is executable
17
- Existing session files Check what previous sessions exist
18
- ```
22
+ Before saving, restoring, or clearing session state snapshots, you MUST inspect:
23
+ 1. Session Manager Executable (`.agent/scripts/session_manager.js`) → Confirm script availability and snapshot parameters
24
+ 2. Active Session History -> Read latest snapshot metadata (`session_id`, active task, modified files, open decisions)
25
+ 3. Zero Context Loss Rule Verify state snapshot contains explicit next steps and task status prior to terminating conversation
19
26
 
20
27
  ---
21
28
 
@@ -1,6 +1,13 @@
1
1
  ---
2
2
  description: Display agent and project status. Shows task.md progress, last audit results, CI status, and recently modified files. Read-only — no changes made.
3
- required-skills: bash-linux
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - bash-linux
8
+ - code-review-checklist
9
+ scripts-binding:
10
+ - .agent/scripts/verify_all.js
4
11
  ---
5
12
 
6
13
  # /status — Project Health Dashboard
@@ -9,13 +16,12 @@ $ARGUMENTS
9
16
 
10
17
  ---
11
18
 
12
- ## $CONTEXT_REQUIRED
19
+ ## Mandatory Pre-Flight Context Inspection
13
20
 
14
- ```
15
- Read BEFORE checking status:
16
- task.md Get the current active task progress
17
- git status Find recently modified files
18
- ```
21
+ Before rendering project status dashboards, you MUST inspect:
22
+ 1. Active Execution Ledger (`task.md`) → Read current wave progress, finished tasks, and active in-progress item
23
+ 2. Workspace Git Status (`git status`, `git diff --stat`) List uncommitted edits and modified files
24
+ 3. Read-Only Constraint Ban any file mutations or state updates during status reporting; report status strictly
19
25
 
20
26
  ---
21
27
 
@@ -1,6 +1,15 @@
1
1
  ---
2
2
  description: Strengthen skills by appending Tribunal guardrails (LLM Traps, Pre-Flight checklist, VBC Protocol) to any SKILL.md missing them. Reads each skill, checks for guardrails, appends if missing, skips if present.
3
- required-skills: skill-creator, llm-engineering
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - skill-creator
8
+ - llm-engineering
9
+ - clean-code
10
+ scripts-binding:
11
+ - .agent/scripts/skill_integrator.js
12
+ - .agent/scripts/lint_runner.js
4
13
  ---
5
14
 
6
15
  # /strengthen-skills — Skill Hardening Pipeline
@@ -9,12 +18,12 @@ $ARGUMENTS
9
18
 
10
19
  ---
11
20
 
12
- ## $CONTEXT_REQUIRED
21
+ ## Mandatory Pre-Flight Context Inspection
13
22
 
14
- ```
15
- Read BEFORE strengthening:
16
- .agent/skills/ Identify the skills that exist
17
- ```
23
+ Before auditing or hardening skill definitions, you MUST inspect:
24
+ 1. Target Skill Directory Inventory (`.agent/skills/`) → List all skill folders and inspect `SKILL.md` frontmatter
25
+ 2. Guardrail Idempotency Check Check if target `SKILL.md` already carries `## Mandatory Pre-Flight Context Inspection` or `## 🏛️ Tribunal Integration`; skip if present
26
+ 3. Skill Integrator Script (`.agent/scripts/skill_integrator.js`) → Run skill integrator script to update executable script bindings
18
27
 
19
28
  ---
20
29
 
@@ -1,18 +1,27 @@
1
- # /super-prompt — Tokenless Prompt Compiler
2
-
3
1
  ---
2
+ description: Tokenless Prompt Compiler. Converts conversational requests into hyper-dense YAML structures that LLMs process perfectly, reducing prompt tokens and improving response accuracy. Zero API tokens used during compilation.
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - llm-engineering
8
+ - clean-code
9
+ scripts-binding:
10
+ - .agent/scripts/prompt_compiler.js
11
+ ---
12
+
13
+ # /super-prompt — Tokenless Prompt Compiler
4
14
 
5
- ## required-skills: llm-engineering
15
+ $ARGUMENTS
6
16
 
7
- Converts conversational, fluffy requests into hyper-dense YAML structures that LLMs process perfectly, reducing prompt tokens and drastically improving response accuracy. **Zero API tokens are used during compilation.**
17
+ ---
8
18
 
9
- ## $CONTEXT_REQUIRED
19
+ ## Mandatory Pre-Flight Context Inspection
10
20
 
11
- ```
12
- Read BEFORE super-prompting:
13
- Target prompt Determine what the user wants to achieve
14
- .agent/scripts/prompt_compiler.jsVerify script exists
15
- ```
21
+ Before compiling prompts or running prompt compression, you MUST inspect:
22
+ 1. Target Input Request Text → Read target user request to strip conversational fillers
23
+ 2. Prompt Compiler Script (`.agent/scripts/prompt_compiler.js`) Verify availability of local prompt compiler script
24
+ 3. Zero Token Overhead Principle Ensure compilation executes locally without invoking LLM API calls
16
25
 
17
26
  ---
18
27
 
@@ -1,6 +1,15 @@
1
1
  ---
2
2
  description: Multi-Agent Swarm Orchestration. Supervisor decomposes a complex goal into sub-tasks, dispatches to specialist Workers via structured JSON contracts, collects results via allSettled fan-in, and synthesizes a unified deliverable. Validates payloads via swarm_dispatcher.js before dispatch.
3
- required-skills: parallel-agents, agent-organizer
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - parallel-agents
8
+ - agent-organizer
9
+ - swarm-dispatcher
10
+ scripts-binding:
11
+ - .agent/scripts/swarm_dispatcher.js
12
+ - .agent/scripts/verify_all.js
4
13
  ---
5
14
 
6
15
  # /swarm — Multi-Agent Swarm Execution
@@ -9,13 +18,12 @@ $ARGUMENTS
9
18
 
10
19
  ---
11
20
 
12
- ## $CONTEXT_REQUIRED
21
+ ## Mandatory Pre-Flight Context Inspection
13
22
 
14
- ```
15
- Read BEFORE swarming:
16
- Target scope Ensure tasks are non-overlapping
17
- .agent/scripts/swarm_dispatcher.jsValidate the dispatcher is available
18
- ```
23
+ Before decomposing goals into worker sub-tasks or triggering swarm execution, you MUST inspect:
24
+ 1. Swarm Dispatcher Validator (`.agent/scripts/swarm_dispatcher.js`) → Run payload validation script to ensure valid worker JSON payloads
25
+ 2. Non-Overlapping File Boundary Rule Verify worker tasks target disjoint file sets to prevent git write conflicts during parallel execution
26
+ 3. `Promise.allSettled()` Fan-In Protocol Collect all worker status reports and synthesize final deliverable before Human Gate confirmation
19
27
 
20
28
  ---
21
29
 
@@ -1,6 +1,15 @@
1
1
  ---
2
2
  description: Test generation and test running command. Creates and executes tests for code using the Testing Trophy strategy (unit → integration → E2E). Tests are behavioral (GIVEN/WHEN/THEN), not structural. Tests cannot be approved without covering happy path, error path, and boundary cases.
3
- required-skills: testing-patterns, tdd-workflow
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - testing-patterns
8
+ - tdd-workflow
9
+ - test-engineer
10
+ scripts-binding:
11
+ - .agent/scripts/test_runner.js
12
+ - .agent/scripts/verify_all.js
4
13
  ---
5
14
 
6
15
  # /test — Test Generation & Execution
@@ -9,14 +18,12 @@ $ARGUMENTS
9
18
 
10
19
  ---
11
20
 
12
- ## $CONTEXT_REQUIRED
21
+ ## Mandatory Pre-Flight Context Inspection
13
22
 
14
- ```
15
- Read BEFORE testing:
16
- Target files → Code to be tested
17
- Existing tests Understand testing patterns already used
18
- □ package.json → Check test frameworks (Jest, Vitest, etc.)
19
- ```
23
+ Before generating test suites or executing test runners, you MUST inspect:
24
+ 1. Workspace Test Runner Configuration (`package.json`, `jest.config.js`, `vitest.config.ts`, `pytest.ini`) → Verify installed runner & test environment
25
+ 2. Target Module Code & Contracts → Inspect function signatures, parameters, exceptions, and return types
26
+ 3. 3-Case Coverage Requirement Ensure test cases explicitly cover Happy Path, Error Handling Path, and Boundary Conditions before approving test files
20
27
 
21
28
  ---
22
29
 
@@ -1,6 +1,16 @@
1
1
  ---
2
2
  description: Backend-specific Tribunal. Runs Logic + Security + Dependency + Type Safety + Resilience + Schema reviewers. Use for API routes, server logic, auth code, middleware, Server Actions, and any server-side business logic.
3
- required-skills: backend-security-expert, nodejs-best-practices, api-patterns
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - backend-security-expert
8
+ - nodejs-best-practices
9
+ - api-patterns
10
+ scripts-binding:
11
+ - .agent/scripts/security_scan.js
12
+ - .agent/scripts/dependency_analyzer.js
13
+ - .agent/scripts/schema_validator.js
4
14
  ---
5
15
 
6
16
  # /tribunal-backend — Backend Code Audit
@@ -9,15 +19,12 @@ $ARGUMENTS
9
19
 
10
20
  ---
11
21
 
12
- ## $CONTEXT_REQUIRED
22
+ ## Mandatory Pre-Flight Context Inspection
13
23
 
14
- ```
15
- Read BEFORE backend review:
16
- Target backend files The code being audited
17
- package.json Verify dependency versions (express, next, etc.)
18
- □ prisma/schema.prisma → If ORM is used
19
- □ .env.example → Expected environment variables
20
- ```
24
+ Before auditing backend routes or server logic, you MUST inspect:
25
+ 1. Target Backend Source & Contracts → Read target route handlers, Server Actions, or controller methods
26
+ 2. Dependencies & Environment (`package.json`, `.env.example`) Check backend framework versions, secret key placeholders, and ORM schemas
27
+ 3. 6-Reviewer Parallel Gate Execute logic-reviewer, security-auditor, dependency-analyzer, type-safety, resilience-reviewer, and schema-reviewer before approving diffs
21
28
 
22
29
  ---
23
30
 
@@ -1,6 +1,15 @@
1
1
  ---
2
2
  description: Database-specific Tribunal. Runs Logic + Security + SQL reviewers. Use for Prisma queries, raw SQL, schema migrations, ORM operations, and database transaction code.
3
- required-skills: database-design
3
+ tools: Read, Grep, Glob, Bash, Edit, Write
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ required-skills:
7
+ - database-design
8
+ - sql-pro
9
+ - supabase-postgres-best-practices
10
+ scripts-binding:
11
+ - .agent/scripts/schema_validator.js
12
+ - .agent/scripts/security_scan.js
4
13
  ---
5
14
 
6
15
  # /tribunal-database — Database Code Audit
@@ -9,14 +18,12 @@ $ARGUMENTS
9
18
 
10
19
  ---
11
20
 
12
- ## $CONTEXT_REQUIRED
21
+ ## Mandatory Pre-Flight Context Inspection
13
22
 
14
- ```
15
- Read BEFORE database review:
16
- Target query/schema files The code being audited
17
- prisma/schema.prisma The single source of truth for schema
18
- □ Database migration files → History of schema changes
19
- ```
23
+ Before auditing database queries, migrations, or ORM transactions, you MUST inspect:
24
+ 1. ORM Schema Source of Truth (`prisma/schema.prisma` or SQL schema) → Verify active table schemas, indexes, and relations
25
+ 2. SQL Parameterization Inspection Flag all raw SQL queries attempting string interpolation; enforce parameterized queries
26
+ 3. 3-Reviewer Database Gate Execute logic-reviewer, security-auditor, and sql-pro before approving database modifications
20
27
 
21
28
  ---
22
29