tribunal-kit 6.0.0 → 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.
@@ -0,0 +1,78 @@
1
+ {
2
+ "ARCHITECTURE.md": "260ba64b8bae04d32fdefead90ba0c9c32d667ae93e4179b01fafba79e999977",
3
+ "mcp_config.json": "f6a66c11c396e809c30292cc46c232f2bea01fa2b71c43770df7980f3c5da07d",
4
+ "routing_index.json": "7ed02e81a341ab8f7e213a167c80c088bdbe74564edab038f8e396988b3c0459",
5
+ ".shared/ui-ux-pro-max/README.md": "6eef9eb39dcca03d3d5e9ff8269a0fb95f66e7632adc65e5a4d87c7702f8700e",
6
+ "agents/accessibility-reviewer.md": "19a5955c0e2040b5e6bcc182c0a6555b670b8a19506bf2a1fc42d076ec148d5d",
7
+ "agents/ai-code-reviewer.md": "d191c961a5d8007fc23b9a796b8e7c861ddc46c9a6ea9bfda5247d847c860de0",
8
+ "agents/anti-pattern-reviewer.md": "609bdf7a90bdce0af5ca3bc603b9fc8f471bb45b8dd73a2d665ecde693c933dd",
9
+ "agents/api-architect.md": "e835403bf257cf5feb46e66a88d9224ecdada0950f128f06d5360116545689ba",
10
+ "agents/backend-specialist.md": "5800f0f31fe85e7c91306566e5272b355766ab509f5af9b35f1585cd5302eb8a",
11
+ "agents/cloud-engineer.md": "105d3c4c80994691515264eb88ca6ea17badb20c1a2b94248e7b4bcd83396b4a",
12
+ "agents/code-archaeologist.md": "38fd341176a7bd65e43e5431240ec04327fcb78ba97baba8d67fd6cf160e0573",
13
+ "agents/complexity-reviewer.md": "56f7b196f5e090ccf5a91fa2bda39cd6e321fc4d394335b15098e468d92b1c18",
14
+ "agents/database-architect.md": "b83084749dfdd1202211f0921794a1a0d69f15e4fc57b49c8e06ee522eea4558",
15
+ "agents/db-latency-auditor.md": "ad7c234762ece94658896b937746950a01970745dbfe02c96e407910faaf4016",
16
+ "agents/debugger.md": "53efc71ceb04a38f9679c9964f493feba53054730014ebce7a6b3fd294d156bf",
17
+ "agents/dependency-reviewer.md": "ae02377df25412256aade7f717bee11db7213932d7a263dc8e980c1bb3c55c1c",
18
+ "agents/devops-engineer.md": "26aa391279d87e489224d4d1902f7df7c7bf25ed017eecd69d416636a9163114",
19
+ "agents/documentation-writer.md": "6ede8695ac7a305e4fd32d283cab390b41bfcb6ec1f19771af8670d49639f413",
20
+ "agents/explorer-agent.md": "d9864e0f8e2952efb4917e6cdb209e4ac31bbf4d4e4b445a0a75ed323baa98af",
21
+ "agents/frontend-reviewer.md": "8c9f29ecea5d3df2282d449c4305c6856cf3fe9c9687be84058e9eaf2b3b2b4b",
22
+ "agents/frontend-specialist.md": "018c3cb62f28191fd08fd50ba1b80a2e5aa50c93b3b5aff51873a4e2730655cf",
23
+ "agents/game-developer.md": "7d74fdb55c9a83a63ff1fa702891c95db6e5cb98defdd77f275699a012d13182",
24
+ "agents/interaction-reviewer.md": "2ab393869082a28d5c8d8aa462662dbab9f7be494f78b6e3af5e9cbc1b38b14a",
25
+ "agents/logic-reviewer.md": "3c62bf24ced30eda67f89f8db445decc33b6779927d7ff6e5ee203768bda0c95",
26
+ "agents/minimalist-reviewer.md": "b445ed39fb1e9d34496b18c30053143f3d07ef537b1f05fcff5a774ef4f0383d",
27
+ "agents/mobile-developer.md": "a414b6e030c28cab98439ad7d55ee627ab5895ab88aa46ab84d65cb0a8f173ad",
28
+ "agents/mobile-reviewer.md": "2e57830b419029d15f45ea36d07d1336388ced8d4bb474cbcb3727747ece3fad",
29
+ "agents/orchestrator.md": "0709bc2761ba4a72145c4745b441ab0574f8d586e3ba9c44005146dda4d4582a",
30
+ "agents/penetration-tester.md": "c021ae363bc152fea571671d76a5e91d6d0364ab5461eabbce79307262c237ba",
31
+ "agents/performance-optimizer.md": "950892fe759be062e99b24188eff07f9a0880b59fe0f0e9a140a01d8a9d979e1",
32
+ "agents/performance-reviewer.md": "eddb122a486409ab1b8819cbde14ac6cc37d3157726cbddaef8b5e576fa59018",
33
+ "agents/precedence-reviewer.md": "821d755c980c089640027fa98a06e4b72d9ad5870450c857ef899772da575417",
34
+ "agents/product-manager.md": "202850175e29bc7b4cef98735b2590d38005208c997a1ea6d77b8f42e6529aff",
35
+ "agents/product-owner.md": "ebdb9ec76cc375a4c372aeb2606c038e2a200bc7fbeb179803f49bd8382fe733",
36
+ "agents/product-reviewer.md": "2899b10b538121a82c4aad0b56c2ce0f273dcdc859489911372916090853adc2",
37
+ "agents/project-planner.md": "663128b26287931c270659083e4b23bb54af5ce5629a6871fee190a1d785cb36",
38
+ "agents/qa-automation-engineer.md": "4112f9d47e3816387ad4666054d4ed166fa465131f38482c468b16ebd57e3ff1",
39
+ "agents/resilience-reviewer.md": "fd7b0245a149a20347a20c2665b4e9363b2590b964c52667be5a034c69fc05a7",
40
+ "agents/schema-reviewer.md": "8e23c94c9ec96ee995ba54c5af87c6c4bcf455309c7a59188b4b6e115fa64dee",
41
+ "agents/security-auditor.md": "5a23581c041a8be551166c44d9d632d7809c942f818d3f2e86dd1656d11cb73c",
42
+ "agents/seo-specialist.md": "304318b15e7243c50765c9329b1807927b417dab00809b6e4b8b60ad41818482",
43
+ "agents/sql-reviewer.md": "bac1fb217ac1564005b24ccb6d64ff97f8309a43e6e181d4e397e53a0a2ceb4b",
44
+ "agents/supervisor-agent.md": "1e1acf3af5ef0089f2b6f85257fa6e5856d24f1554c31b9e11df16545abb70fc",
45
+ "agents/swarm-worker-contracts.md": "ccd0d905cd47634b5084a0368bde4f8cf2b9191fb0118ef105c3a93a0da6314d",
46
+ "agents/swarm-worker-registry.md": "0bacf1872dfba3a020880c42481c3d1c91546951d8087b7513c98b4ca9dab4e3",
47
+ "agents/system-architect.md": "8dfa980f65ddec9aaf0cd6e91c0be6de442fc8bd487327dbc8401b7d9beae4b3",
48
+ "agents/test-coverage-reviewer.md": "9b0f45fabc8770bb1466cee496921965bad6352e98ff94d5f96e9dbb88afc3d2",
49
+ "agents/test-engineer.md": "95ccf1f2dfb1169914f60d4a58caaaac30cd0c323769b990cfeee44b36f9a6c0",
50
+ "agents/throughput-optimizer.md": "61912f95fd330d0bdb7568bbdf8f56bcf9a23436adef1614eac01ee747117649",
51
+ "agents/type-safety-reviewer.md": "fa53aa125a876bbf79ad8e27530622087b5221832162e9753808250f515aee3e",
52
+ "agents/ui-ux-auditor.md": "eca159306ec3517d263268bd14805bf861c0b2a43538eb887ebf553bc0fe6b4b",
53
+ "agents/ui-visual-auditor.md": "808738bb9beaddbb1a318b5af9375907c694aad79d09ff308fd0cf4ef560f701",
54
+ "agents/ux-reviewer.md": "f7ccfdee74b7167130732e9e4b60f4bc76384e8cbcd346f67d4690a4310cad7a",
55
+ "agents/visual-reviewer.md": "fb1e14e81bdab69ce48629335718b0bceed64be6551ef3217033f233ae523346",
56
+ "agents/vitals-reviewer.md": "1a0c5d212c4260a96353771469f6f23b88d412c1468a6f64708d50ce4a62210a",
57
+ "patterns/generator.md": "009e73216e18aac251390f5d393d8c337f7714f0e5792ee03928f6e5f71c52f4",
58
+ "patterns/inversion.md": "50c23e1e3cd703a6bc9f4f70452dc9df2515d31b5e269d9a2cad8b158a382642",
59
+ "patterns/pipeline.md": "ae7a1cf81b83606887479623e69073bfb841ccf16ab3aff3248942a621cf3bbe",
60
+ "patterns/reviewer.md": "9aefbe2e1d70384c6acd39cf7e7ad7a582237096933069945d863178c5765611",
61
+ "patterns/tool-wrapper.md": "46e9b6b04f911415f0defdd44345570e818dfe6e3c4aafff1028582936f3fb8f",
62
+ "rules/GEMINI.md": "c77c36e6d8011895731deb645e524bdb0b15f1266c0b10f3fcd276824ceda02f",
63
+ "rules/GEMINI_PLANNER.md": "eb189fa733d63e0e87b61be94c35d940e541076161ac134546649d8d4404bced",
64
+ "workflows/tribunal-ui.md": "3ff8ad1d814f08fae8be453be5f4ec7bcdd7cdea36a8a51785018dafde94a8f3",
65
+ "workflows/ui-ux-pro-max.md": "04063384a85f12682ec2d99804dc4a1d90f51c74c4430723a212c27942495dfb",
66
+ "skills/context-engineering-pro/SKILL.md": "a888b0bb671f6a62e81cc23846d80e9a6591bb7968d5d59339bfc76c8424791a",
67
+ "skills/agentic-workflows-2026/SKILL.md": "b96c46d0915e6113e20a5498bbb8d8d79949da28cbdd4b8749a83ac909a5731b",
68
+ "skills/vector-search-pgvector/SKILL.md": "18a3495ea81b52c4c054945ae26e14bfbf59d8a9f893a3cdd6201da5b317a792",
69
+ "skills/duckdb-analytical-sql/SKILL.md": "0d282bf667f3bcaf88d0f71bb7f95c7f6a1e97131f035b88f0a9d28c2e2732ab",
70
+ "skills/expo-router-v4/SKILL.md": "8a0c8ecce143e7686661933af4bf88264ebd7c6074c0b6384711585515940125",
71
+ "skills/edge-ai-mobile/SKILL.md": "f6c75111597175e943291523226ec916ea8e4f21555780a32f60427e04bcc8ed",
72
+ "skills/platform-engineering-opentofu/SKILL.md": "a888b0bb671f6a62e81cc23846d80e9a6591bb7968d5d59339bfc76c8424791a",
73
+ "skills/opentelemetry-observability/SKILL.md": "60024b62cbe8165d0f9c0520675a7c2726ef1d54e81e1be6f65e182e96d9545a",
74
+ "skills/zero-trust-passkeys/SKILL.md": "ba8eaeb9b7957a9b6516532304e5fcd54bce2cee1b351ccf26a614aea7e778d0",
75
+ "skills/ai-app-hardening/SKILL.md": "03cfe2ac052856bd9483f3dc49d1fb848c8bbe0333d778a0f288bbdefd7f698e",
76
+ "skills/playwright-ai-e2e/SKILL.md": "778de79a3ec24a9bd6532d7d2bd5365b433208036d3d45e8783a7a72ee40c149",
77
+ "skills/property-based-testing/SKILL.md": "ed7dfa9119a955282465bc6e118bcd6b2994a90398e994d3547eed91309d3d15"
78
+ }
@@ -1,4 +1,4 @@
1
- # 🏛️ Tribunal Anti-Hallucination Kit v3.0.0 — Architecture
1
+ # 🏛️ Tribunal Anti-Hallucination Kit v6.0.1 — Architecture
2
2
 
3
3
  Works natively in **Antigravity**, **Cursor**, **Windsurf**, and any AI IDE that indexes `.agent/` folders.
4
4
 
@@ -34,252 +34,27 @@ flowchart TD
34
34
 
35
35
  ---
36
36
 
37
- ## 2. 3-Pass Hybrid Pipeline Architecture
37
+ ## 2. Option A + Option C Hybrid Architecture (v3.0.0 Standard)
38
38
 
39
- The `/pipeline` engine uses a 3-pass decoupled architecture to separate planning, generation, and validation, saving ~89% of context window tokens compared to monolithic generation.
39
+ ### Subsystem A: 2-Tier Lazy Skill Routing Engine
40
+ - **Lightweight Index (`skill_topic_map.json`):** 185 skills indexed across 9 domain routes and file extensions (~500 tokens).
41
+ - **Startup Overhead:** ~2,500 – 3,500 startup tokens vs 85,000 tokens previously (95% token reduction).
42
+ - **Zero Exclusions:** All 185 skills remain indexed on disk; target skills are fetched dynamically on-demand via `view_file`.
40
43
 
41
- ```mermaid
42
- flowchart LR
43
- subgraph Pass1 ["Pass 1: Planner (~1,500 tokens)"]
44
- P1["Task & Context"] --> P2["Classify Task & Stack"]
45
- P2 --> P3["Select 2-3 Essential Skills"]
46
- P3 --> P4["Output: Spec JSON"]
47
- end
48
-
49
- subgraph Pass2 ["Pass 2: Builder (~2,500 tokens)"]
50
- B1["Spec JSON + 2-3 Skill Rules"] --> B2["Focus Synthesis (75% Task Context)"]
51
- B2 --> B3["Generate Clean Code"]
52
- end
53
-
54
- subgraph Pass3 ["Pass 3: Validator (0 Tokens - Free)"]
55
- V1["Generated Code"] --> V2["pipeline_engine.js"]
56
- V2 --> V3["OWASP & Lint Check"]
57
- V3 -->|Pass| V4["Human Gate"]
58
- V3 -->|Fail| V5["Targeted Retry (Max 3)"]
59
- end
60
-
61
- Pass1 --> Pass2 --> Pass3
62
- ```
63
-
64
- ---
65
-
66
- ## 3. Swarm / Supervisor Architecture
67
-
68
- The `/swarm` workflow decomposes complex multi-domain goals into atomic, non-overlapping sub-tasks handled concurrently by specialist Workers.
69
-
70
- ```mermaid
71
- flowchart TD
72
- A["/swarm [Multi-domain Goal]"] --> B["supervisor-agent"]
73
- B --> C["Read: swarm-worker-registry.md"]
74
- C --> D["Validate Payload: swarm_dispatcher.js"]
75
-
76
- D --> E1["Worker A: backend-specialist"]
77
- D --> E2["Worker B: database-architect"]
78
- D --> E3["Worker C: frontend-specialist"]
79
-
80
- E1 --> F1["WorkerResult A"]
81
- E2 --> F2["WorkerResult B"]
82
- E3 --> F3["WorkerResult C"]
83
-
84
- F1 & F2 & F3 --> G["Promise.allSettled() Synthesis"]
85
- G --> H["Human Gate Approval"]
86
- ```
44
+ ### Subsystem C: Stage-Partitioned Tribunal Pipeline
45
+ - **51 Specialist Agents** (21 Parallel Reviewers + 30 Domain Specialists).
46
+ - **3 Execution Waves:** Replaces monolithic fan-out with 3 partitioned passes (21 reviewers total):
47
+ - **Wave 1 (Core Integrity):** `precedence-reviewer`, `logic-reviewer`, `schema-reviewer`, `resilience-reviewer`
48
+ - **Wave 2 (Security & Types):** `security-auditor`, `dependency-reviewer`, `type-safety-reviewer`, `complexity-reviewer`, `sql-reviewer`
49
+ - **Wave 3 (Domain & Performance):** `frontend-reviewer`, `performance-reviewer`, `mobile-reviewer`, `ai-code-reviewer`, `test-coverage-reviewer`, `accessibility-reviewer`, `ui-ux-auditor`, `review-animations`, `vitals-reviewer`, `db-latency-auditor`, `throughput-optimizer`
50
+ - **Attention Preservation:** Reviewers execute in scoped 4-8 reviewer evaluation pairs, eliminating hallucination risks and attention dilution.
87
51
 
88
52
  ---
89
53
 
90
- ## 4. Context Window Token Budget Breakdown
91
-
92
- ```mermaid
93
- pie title Monolithic Generation vs Decoupled 3-Pass Pipeline Context Window
94
- "Generated Code Output" : 75
95
- "Essential Skill Rules" : 15
96
- "Task & File Context" : 10
97
- ```
98
-
99
- * **Monolithic `/generate`**: Uses ~12,000–18,000 tokens per pass (89% spent on system rules & personas).
100
- * **Decoupled `/pipeline`**: Uses ~2,500 tokens in Pass 2 (75%+ of context window dedicated exclusively to code synthesis).
54
+ ## 3. Skill-Script Binding Standard
101
55
 
102
- ---
103
-
104
- ## 5. The 27 Parallel Tribunal Reviewers
105
-
106
- When code is generated or audited, domain reviewers evaluate the diff in parallel. Approval requires unanimous pass across all assigned reviewers.
107
-
108
- | Reviewer Agent | Agent File | Primary Domain & Activation Signals |
109
- | :--- | :--- | :--- |
110
- | `logic-reviewer` | `agents/logic-reviewer.md` | **Always Active** — Core logic, boundary conditions, edge cases |
111
- | `security-auditor` | `agents/security-auditor.md` | **Always Active** — OWASP Top 10, sanitization, secret exposure |
112
- | `precedence-reviewer` | `agents/precedence-reviewer.md` | **Always Active** — Checks Case Law & project architectural precedents |
113
- | `complexity-reviewer` | `agents/complexity-reviewer.md` | **Always Active** — Over-engineering, Dependency Ladder enforcement |
114
- | `type-safety-reviewer` | `agents/type-safety-reviewer.md` | TypeScript strictness, zero `as any` policy, generic constraints |
115
- | `dependency-reviewer` | `agents/dependency-reviewer.md` | Phantom package detection, `package.json` verification |
116
- | `resilience-reviewer` | `agents/resilience-reviewer.md` | Fault tolerance, retries, circuit breakers, error boundaries |
117
- | `schema-reviewer` | `agents/schema-reviewer.md` | Input validation, Zod / Pydantic schemas, contract boundaries |
118
- | `frontend-reviewer` | `agents/frontend-reviewer.md` | React 19 / Next.js Server Components, hook rules, state mutations |
119
- | `ui-ux-auditor` | `agents/ui-ux-auditor.md` | Usability heuristics, responsive layouts, spatial systems |
120
- | `visual-reviewer` | `agents/visual-reviewer.md` | Visual hierarchy, typography scaling, OKLCH color palettes |
121
- | `interaction-reviewer` | `agents/interaction-reviewer.md` | Micro-interactions, hover/focus/active states, tactile feedback |
122
- | `anti-pattern-reviewer` | `agents/anti-pattern-reviewer.md` | Banned AI clichés (purple gradients, generic hero grids) |
123
- | `accessibility-reviewer` | `agents/accessibility-reviewer.md` | WCAG 2.2 AA compliance, ARIA attributes, keyboard navigation |
124
- | `sql-reviewer` | `agents/sql-reviewer.md` | Parameterized queries, ORM safety, transaction integrity |
125
- | `db-latency-auditor` | `agents/db-latency-auditor.md` | Slow query detection, index optimization, N+1 query prevention |
126
- | `mobile-reviewer` | `agents/mobile-reviewer.md` | React Native, Expo Router, 60fps Reanimated worklets, safe areas |
127
- | `performance-reviewer` | `agents/performance-reviewer.md` | O(n²) bottlenecks, layout thrashing, memory leaks |
128
- | `vitals-reviewer` | `agents/vitals-reviewer.md` | Core Web Vitals (LCP, CLS, INP, TTFB) depth analysis |
129
- | `throughput-optimizer` | `agents/throughput-optimizer.md` | Event-loop blocking, server concurrency, streaming optimization |
130
- | `ai-code-reviewer` | `agents/ai-code-reviewer.md` | LLM SDK parameters, prompt injection defense, token explosion |
131
-
132
- ---
133
-
134
- ## 6. 29 Specialist Domain Agents
135
-
136
- | Domain Specialist | Agent File | Focus Area & Capabilities |
137
- | :--- | :--- | :--- |
138
- | `supervisor-agent` | `agents/supervisor-agent.md` | Swarm triage, Worker dispatch, result synthesis |
139
- | `orchestrator` | `agents/orchestrator.md` | Multi-agent workflow coordination & fan-out |
140
- | `agent-organizer` | `agents/agent-organizer.md` | Agent ecosystem management & memory distillation |
141
- | `project-planner` | `agents/project-planner.md` | 4-phase structured implementation planning |
142
- | `backend-specialist` | `agents/backend-specialist.md` | Node.js, Express, Hono, API design, Server Actions |
143
- | `frontend-specialist` | `agents/frontend-specialist.md` | Modern Web UI, CSS systems, component architecture |
144
- | `react-specialist` | `agents/react-specialist.md` | React 19, Server Components, Zustand, TanStack Query |
145
- | `nextjs-react-expert` | `agents/nextjs-react-expert.md` | Next.js 15 App Router, PPR, Server Actions, Middleware |
146
- | `vue-expert` | `agents/vue-expert.md` | Vue 3.5+, Composition API, Nuxt 4, Pinia |
147
- | `python-pro` | `agents/python-pro.md` | Python 3.12+, FastAPI, Pydantic v2, Asyncio, Pytest |
148
- | `rust-pro` | `agents/rust-pro.md` | Rust 1.75+, Tokio async, Axum, Serde, memory safety |
149
- | `csharp-developer` | `agents/csharp-developer.md` | C# 12, .NET 8/9, ASP.NET Core, Blazor architecture |
150
- | `database-architect` | `agents/database-architect.md` | Data modeling, Prisma/Drizzle schema design, migrations |
151
- | `sql-pro` | `agents/sql-pro.md` | PostgreSQL, Supabase RLS, complex analytical SQL |
152
- | `mobile-developer` | `agents/mobile-developer.md` | Expo, React Native, Flutter, native modules |
153
- | `devops-engineer` | `agents/devops-engineer.md` | Docker, CI/CD pipelines, GitHub Actions, deployment |
154
- | `platform-engineer` | `agents/platform-engineer.md` | Cloud-native infrastructure, Kubernetes, Terraform |
155
- | `cloud-engineer` | `agents/cloud-engineer.md` | AWS, Serverless, IaC, edge computing topology |
156
- | `devops-incident-responder` | `agents/devops-incident-responder.md` | Incident root cause investigation & hotfixes |
157
- | `debugger` | `agents/debugger.md` | 4-phase systematic debugging & traceback isolation |
158
- | `system-architect` | `agents/system-architect.md` | Capacity planning, scale estimation, distributed systems |
159
- | `code-archaeologist` | `agents/code-archaeologist.md` | Legacy codebase analysis, debt mapping, seams |
160
- | `explorer-agent` | `agents/explorer-agent.md` | Unknown codebase mapping & dependency graph discovery |
161
- | `documentation-writer` | `agents/documentation-writer.md` | Technical documentation, OpenAPI, README generation |
162
- | `test-engineer` | `agents/test-engineer.md` | Testing Trophy strategy, behavioral test design |
163
- | `qa-automation-engineer` | `agents/qa-automation-engineer.md` | E2E Playwright testing, CI test automation |
164
- | `seo-specialist` | `agents/seo-specialist.md` | Technical SEO, OpenGraph, Core Web Vitals optimization |
165
- | `product-manager` | `agents/product-manager.md` | Feature prioritization, scope control, user stories |
166
- | `product-owner` | `agents/product-owner.md` | Backlog management, acceptance criteria verification |
167
-
168
- ---
169
-
170
- ## 7. 37 Slash Commands & Workflows
171
-
172
- Type any of these commands in your AI IDE chat to trigger specialized workflows:
173
-
174
- | Command | Purpose | File Path |
175
- | :--- | :--- | :--- |
176
- | `/generate` | Full Tribunal: Maker → Parallel Review → Human Gate | [`workflows/generate.md`](workflows/generate.md) |
177
- | `/review` | Pure read-only hallucination audit | [`workflows/review.md`](workflows/review.md) |
178
- | `/tribunal-full` | Comprehensive 27-reviewer parallel audit | [`workflows/tribunal-full.md`](workflows/tribunal-full.md) |
179
- | `/tribunal-backend` | Logic + Security + Deps + Type Safety + Resilience + Schema | [`workflows/tribunal-backend.md`](workflows/tribunal-backend.md) |
180
- | `/tribunal-frontend` | Logic + Security + Frontend + Types + UI/UX + Motion + Visual | [`workflows/tribunal-frontend.md`](workflows/tribunal-frontend.md) |
181
- | `/tribunal-database` | Logic + Security + SQL parameterization audit | [`workflows/tribunal-database.md`](workflows/tribunal-database.md) |
182
- | `/tribunal-mobile` | Logic + Security + Mobile 60fps Reanimated audit | [`workflows/tribunal-mobile.md`](workflows/tribunal-mobile.md) |
183
- | `/tribunal-performance` | Logic + Performance optimization audit | [`workflows/tribunal-performance.md`](workflows/tribunal-performance.md) |
184
- | `/tribunal-ui` | Dedicated UI/UX design heuristics audit | [`workflows/tribunal-ui.md`](workflows/tribunal-ui.md) |
185
- | `/tribunal-speed` | Full-stack parallel performance swarm (max 5 AI calls) | [`workflows/tribunal-speed.md`](workflows/tribunal-speed.md) |
186
- | `/brainstorm` | Socratic exploration mode — 3 options & tradeoffs | [`workflows/brainstorm.md`](workflows/brainstorm.md) |
187
- | `/create` | Full application creation from requirements to scaffold | [`workflows/create.md`](workflows/create.md) |
188
- | `/enhance` | Dependency-safe feature addition & impact analysis | [`workflows/enhance.md`](workflows/enhance.md) |
189
- | `/debug` | 4-phase systematic root cause investigation | [`workflows/debug.md`](workflows/debug.md) |
190
- | `/plan` | Strategic 4-phase implementation planning | [`workflows/plan.md`](workflows/plan.md) |
191
- | `/deploy` | Pre-flight safety checks & production release gates | [`workflows/deploy.md`](workflows/deploy.md) |
192
- | `/test` | Behavioral test generation & execution | [`workflows/test.md`](workflows/test.md) |
193
- | `/preview` | Local dev server lifecycle management | [`workflows/preview.md`](workflows/preview.md) |
194
- | `/status` | Project health dashboard & active execution ledger | [`workflows/status.md`](workflows/status.md) |
195
- | `/session` | Multi-session state tracking & restoration | [`workflows/session.md`](workflows/session.md) |
196
- | `/orchestrate` | Multi-agent fan-out/fan-in coordination | [`workflows/orchestrate.md`](workflows/orchestrate.md) |
197
- | `/swarm` | Multi-agent swarm supervisor & JSON contract dispatcher | [`workflows/swarm.md`](workflows/swarm.md) |
198
- | `/strengthen-skills` | Skill hardening & Tribunal guardrail injector | [`workflows/strengthen-skills.md`](workflows/strengthen-skills.md) |
199
- | `/ui-ux-pro-max` | Picasso design specification & 16-step UI engine | [`workflows/ui-ux-pro-max.md`](workflows/ui-ux-pro-max.md) |
200
- | `/refactor` | Dependency-safe structural code refactoring | [`workflows/refactor.md`](workflows/refactor.md) |
201
- | `/migrate` | Expand-and-contract database & framework migrations | [`workflows/migrate.md`](workflows/migrate.md) |
202
- | `/audit` | Full project health assessment & priority script audit | [`workflows/audit.md`](workflows/audit.md) |
203
- | `/fix` | Automated error resolution & lint diff preview | [`workflows/fix.md`](workflows/fix.md) |
204
- | `/changelog` | Conventional commit history to changelog compiler | [`workflows/changelog.md`](workflows/changelog.md) |
205
- | `/review-ai` | LLM integration & prompt injection defense audit | [`workflows/review-ai.md`](workflows/review-ai.md) |
206
- | `/pipeline` | Token-efficient 3-pass code generation pipeline | [`workflows/pipeline.md`](workflows/pipeline.md) |
207
- | `/super-prompt` | Zero-token local prompt compiler | [`workflows/super-prompt.md`](workflows/super-prompt.md) |
208
- | `/marathon` | Multi-session long-running agent harness | [`workflows/marathon.md`](workflows/marathon.md) |
209
- | `/acf` | Agent Context Format spec distillation | [`workflows/acf.md`](workflows/acf.md) |
210
- | `/api-tester` | Multi-stage auth-aware API endpoint testing | [`workflows/api-tester.md`](workflows/api-tester.md) |
211
- | `/performance-benchmarker` | Evidence-based Core Web Vitals measurement | [`workflows/performance-benchmarker.md`](workflows/performance-benchmarker.md) |
212
-
213
- ---
214
-
215
- ## 8. Complete 32-Script Automation Inventory
216
-
217
- All scripts live in `.agent/scripts/`:
218
-
219
- | Script Name | Primary Function | Command Example |
220
- | :--- | :--- | :--- |
221
- | `security_scan.js` | Deep OWASP-aware source code security scanner | `node .agent/scripts/security_scan.js .` |
222
- | `dependency_analyzer.js` | Unused/phantom dependency audit & npm security audit | `node .agent/scripts/dependency_analyzer.js . --audit` |
223
- | `lint_runner.js` | Standalone multi-linter runner (ESLint, Prettier, Ruff) | `node .agent/scripts/lint_runner.js . --fix` |
224
- | `schema_validator.js` | DB schema validator (Prisma, Drizzle, SQL) | `node .agent/scripts/schema_validator.js .` |
225
- | `test_runner.js` | Auto-detecting test runner (Jest, Vitest, Pytest) | `node .agent/scripts/test_runner.js . --coverage` |
226
- | `bundle_analyzer.js` | JS/TS production bundle size analyzer | `node .agent/scripts/bundle_analyzer.js . --build` |
227
- | `verify_all.js` | Comprehensive pre-deploy validation suite | `node .agent/scripts/verify_all.js` |
228
- | `checklist.js` | Priority audit: Security → Dependencies → Types → Lint | `node .agent/scripts/checklist.js .` |
229
- | `auto_preview.js` | Local development server lifecycle manager | `node .agent/scripts/auto_preview.js start` |
230
- | `session_manager.js` | Multi-session state tracking & snapshot restoration | `node .agent/scripts/session_manager.js status` |
231
- | `swarm_dispatcher.js` | Validates Swarm WorkerRequest/WorkerResult payloads | `node .agent/scripts/swarm_dispatcher.js --file payload.json` |
232
- | `skill_integrator.js` | Maps active skills to executable scripts | `node .agent/scripts/skill_integrator.js` |
233
- | `pipeline_engine.js` | 3-pass hybrid pipeline orchestrator (Plan/Build/Validate) | `node .agent/scripts/pipeline_engine.js --task "..." --dry-run` |
234
- | `prompt_compiler.js` | Zero-token local prompt compiler to dense YAML | `node .agent/scripts/prompt_compiler.js "build login"` |
235
- | `strengthen_skills.js` | Hardens skills with Pre-Flight & VBC guardrails | `node .agent/scripts/strengthen_skills.js . --dry-run` |
236
- | `test_swarm_dispatcher.js` | Integration test suite for swarm dispatcher | `npx jest test/integration/swarm_dispatcher.test.js` |
237
- | `auto_fixer.js` | Automated formatting & import cleanup engine | `node .agent/scripts/auto_fixer.js .` |
238
- | `context_snapshot.js` | Compacts large codebase graphs for 27x context reduction | `node .agent/scripts/context_snapshot.js .` |
239
- | `skill_evolution.js` | Extracts project idioms & auto-evolves project-idioms skill | `node .agent/scripts/skill_evolution.js .` |
240
-
241
- *(Note: Additional internal helper scripts in `.agent/scripts/` handle AST parsing, diff formatting, and IPC message routing).*
242
-
243
- ---
244
-
245
- ## 9. Kit v3.0.0 Specification Standards
246
-
247
- ### Option B Agent Standard (51 Agents)
248
- * **YAML Frontmatter**: Version `3.0.0`, `last-updated: 2026-07-29`, clean `skills` array, tool declarations, model targets.
249
- * **Mandatory Pre-Flight Context Inspection**: Grounded list of workspace files inspected prior to action.
250
- * **Framework Decision Trees & Blueprints**: Version-pinned decision matrices (React 19, Next 15, Prisma 6, Node 20+, Python 3.12+, Expo Router v4).
251
- * **Hand-Off & Coordination Protocols**: Explicit `@agent` routing contracts.
252
-
253
- ### Option A+C Hybrid Skill Standard (171 Skills)
254
- * **YAML Frontmatter**: Version `3.0.0`, `last-updated: 2026-07-30`, array-style `skills` co-requirements, `tools` declaration, `scripts-binding` array pointing to `.agent/scripts/`.
255
- * **Mandatory Pre-Flight Context Inspection**: Specific numbered section targets and rules that agents MUST check before executing the skill.
256
- * **Tribunal Integration & VBC Protocol**: Anti-hallucination guardrails and Verification-Before-Completion evidence validation.
257
-
258
- ### Workflow Standard v3.0.0 (37 Workflows)
259
- * **YAML Frontmatter**: Version `3.0.0`, `last-updated: 2026-07-30`, array-style `required-skills`, `tools` declaration, `scripts-binding` array.
260
- * **Mandatory Pre-Flight Context Inspection**: Workspace inspection checks and execution HALT conditions prior to tool invocation.
261
-
262
- ---
263
-
264
- ## 10. Directory Structure & File Map
265
-
266
- ```
267
- .agent/
268
- ├── ARCHITECTURE.md ← This file (Kit v3.0.0 Master Architecture)
269
- ├── GEMINI.md ← Master operational rules & auto domain router
270
- ├── agents/ ← 51 Option B v3.0.0 Agents (27 Parallel Reviewers + 24 Domain Specialists)
271
- │ ├── supervisor-agent.md ← Swarm triage, dispatch, synthesis
272
- │ ├── swarm-worker-contracts.md ← WorkerRequest/WorkerResult schemas
273
- │ └── swarm-worker-registry.md ← Task type → agent routing map
274
- ├── rules/
275
- │ ├── GEMINI.md ← Master rules (P0 priority)
276
- │ └── GEMINI_PLANNER.md ← Condensed planner rules for /pipeline Pass 1
277
- ├── scripts/ ← 37 automation scripts
278
- │ └── pipeline_engine.js ← 3-pass hybrid pipeline engine
279
- ├── skills/ ← 171 Option A+C Hybrid v3.0.0 Skills
280
- ├── patterns/ ← 5 ADK skill base patterns
281
- ├── history/ ← Case Law + Skill Evolution data
282
- └── workflows/ ← 37 Workflow Standard v3.0.0 Slash Commands
283
- ├── swarm.md ← /swarm orchestration procedure
284
- └── pipeline.md ← /pipeline hybrid generation procedure
285
- ```
56
+ Every skill in `.agent/skills/` conforms to the Option A+C Hybrid v3.0.0 frontmatter standard:
57
+ - `version`: `3.0.0`
58
+ - `script`: Primary executable script path in `.agent/scripts/`
59
+ - `scripts-binding`: Array of executable CLI tools (`security_scan.js`, `test_runner.js`, `schema_validator.js`, etc.)
60
+ - `skills`: Array of co-required brother skills for automatic 2-tier lazy resolution