tribunal-kit 5.8.5 → 6.0.1

package/.agent/.manifest.json

@@ -0,0 +1,78 @@
+{
+  "ARCHITECTURE.md": "260ba64b8bae04d32fdefead90ba0c9c32d667ae93e4179b01fafba79e999977",
+  "mcp_config.json": "f6a66c11c396e809c30292cc46c232f2bea01fa2b71c43770df7980f3c5da07d",
+  "routing_index.json": "7ed02e81a341ab8f7e213a167c80c088bdbe74564edab038f8e396988b3c0459",
+  ".shared/ui-ux-pro-max/README.md": "6eef9eb39dcca03d3d5e9ff8269a0fb95f66e7632adc65e5a4d87c7702f8700e",
+  "agents/accessibility-reviewer.md": "19a5955c0e2040b5e6bcc182c0a6555b670b8a19506bf2a1fc42d076ec148d5d",
+  "agents/ai-code-reviewer.md": "d191c961a5d8007fc23b9a796b8e7c861ddc46c9a6ea9bfda5247d847c860de0",
+  "agents/anti-pattern-reviewer.md": "609bdf7a90bdce0af5ca3bc603b9fc8f471bb45b8dd73a2d665ecde693c933dd",
+  "agents/api-architect.md": "e835403bf257cf5feb46e66a88d9224ecdada0950f128f06d5360116545689ba",
+  "agents/backend-specialist.md": "5800f0f31fe85e7c91306566e5272b355766ab509f5af9b35f1585cd5302eb8a",
+  "agents/cloud-engineer.md": "105d3c4c80994691515264eb88ca6ea17badb20c1a2b94248e7b4bcd83396b4a",
+  "agents/code-archaeologist.md": "38fd341176a7bd65e43e5431240ec04327fcb78ba97baba8d67fd6cf160e0573",
+  "agents/complexity-reviewer.md": "56f7b196f5e090ccf5a91fa2bda39cd6e321fc4d394335b15098e468d92b1c18",
+  "agents/database-architect.md": "b83084749dfdd1202211f0921794a1a0d69f15e4fc57b49c8e06ee522eea4558",
+  "agents/db-latency-auditor.md": "ad7c234762ece94658896b937746950a01970745dbfe02c96e407910faaf4016",
+  "agents/debugger.md": "53efc71ceb04a38f9679c9964f493feba53054730014ebce7a6b3fd294d156bf",
+  "agents/dependency-reviewer.md": "ae02377df25412256aade7f717bee11db7213932d7a263dc8e980c1bb3c55c1c",
+  "agents/devops-engineer.md": "26aa391279d87e489224d4d1902f7df7c7bf25ed017eecd69d416636a9163114",
+  "agents/documentation-writer.md": "6ede8695ac7a305e4fd32d283cab390b41bfcb6ec1f19771af8670d49639f413",
+  "agents/explorer-agent.md": "d9864e0f8e2952efb4917e6cdb209e4ac31bbf4d4e4b445a0a75ed323baa98af",
+  "agents/frontend-reviewer.md": "8c9f29ecea5d3df2282d449c4305c6856cf3fe9c9687be84058e9eaf2b3b2b4b",
+  "agents/frontend-specialist.md": "018c3cb62f28191fd08fd50ba1b80a2e5aa50c93b3b5aff51873a4e2730655cf",
+  "agents/game-developer.md": "7d74fdb55c9a83a63ff1fa702891c95db6e5cb98defdd77f275699a012d13182",
+  "agents/interaction-reviewer.md": "2ab393869082a28d5c8d8aa462662dbab9f7be494f78b6e3af5e9cbc1b38b14a",
+  "agents/logic-reviewer.md": "3c62bf24ced30eda67f89f8db445decc33b6779927d7ff6e5ee203768bda0c95",
+  "agents/minimalist-reviewer.md": "b445ed39fb1e9d34496b18c30053143f3d07ef537b1f05fcff5a774ef4f0383d",
+  "agents/mobile-developer.md": "a414b6e030c28cab98439ad7d55ee627ab5895ab88aa46ab84d65cb0a8f173ad",
+  "agents/mobile-reviewer.md": "2e57830b419029d15f45ea36d07d1336388ced8d4bb474cbcb3727747ece3fad",
+  "agents/orchestrator.md": "0709bc2761ba4a72145c4745b441ab0574f8d586e3ba9c44005146dda4d4582a",
+  "agents/penetration-tester.md": "c021ae363bc152fea571671d76a5e91d6d0364ab5461eabbce79307262c237ba",
+  "agents/performance-optimizer.md": "950892fe759be062e99b24188eff07f9a0880b59fe0f0e9a140a01d8a9d979e1",
+  "agents/performance-reviewer.md": "eddb122a486409ab1b8819cbde14ac6cc37d3157726cbddaef8b5e576fa59018",
+  "agents/precedence-reviewer.md": "821d755c980c089640027fa98a06e4b72d9ad5870450c857ef899772da575417",
+  "agents/product-manager.md": "202850175e29bc7b4cef98735b2590d38005208c997a1ea6d77b8f42e6529aff",
+  "agents/product-owner.md": "ebdb9ec76cc375a4c372aeb2606c038e2a200bc7fbeb179803f49bd8382fe733",
+  "agents/product-reviewer.md": "2899b10b538121a82c4aad0b56c2ce0f273dcdc859489911372916090853adc2",
+  "agents/project-planner.md": "663128b26287931c270659083e4b23bb54af5ce5629a6871fee190a1d785cb36",
+  "agents/qa-automation-engineer.md": "4112f9d47e3816387ad4666054d4ed166fa465131f38482c468b16ebd57e3ff1",
+  "agents/resilience-reviewer.md": "fd7b0245a149a20347a20c2665b4e9363b2590b964c52667be5a034c69fc05a7",
+  "agents/schema-reviewer.md": "8e23c94c9ec96ee995ba54c5af87c6c4bcf455309c7a59188b4b6e115fa64dee",
+  "agents/security-auditor.md": "5a23581c041a8be551166c44d9d632d7809c942f818d3f2e86dd1656d11cb73c",
+  "agents/seo-specialist.md": "304318b15e7243c50765c9329b1807927b417dab00809b6e4b8b60ad41818482",
+  "agents/sql-reviewer.md": "bac1fb217ac1564005b24ccb6d64ff97f8309a43e6e181d4e397e53a0a2ceb4b",
+  "agents/supervisor-agent.md": "1e1acf3af5ef0089f2b6f85257fa6e5856d24f1554c31b9e11df16545abb70fc",
+  "agents/swarm-worker-contracts.md": "ccd0d905cd47634b5084a0368bde4f8cf2b9191fb0118ef105c3a93a0da6314d",
+  "agents/swarm-worker-registry.md": "0bacf1872dfba3a020880c42481c3d1c91546951d8087b7513c98b4ca9dab4e3",
+  "agents/system-architect.md": "8dfa980f65ddec9aaf0cd6e91c0be6de442fc8bd487327dbc8401b7d9beae4b3",
+  "agents/test-coverage-reviewer.md": "9b0f45fabc8770bb1466cee496921965bad6352e98ff94d5f96e9dbb88afc3d2",
+  "agents/test-engineer.md": "95ccf1f2dfb1169914f60d4a58caaaac30cd0c323769b990cfeee44b36f9a6c0",
+  "agents/throughput-optimizer.md": "61912f95fd330d0bdb7568bbdf8f56bcf9a23436adef1614eac01ee747117649",
+  "agents/type-safety-reviewer.md": "fa53aa125a876bbf79ad8e27530622087b5221832162e9753808250f515aee3e",
+  "agents/ui-ux-auditor.md": "eca159306ec3517d263268bd14805bf861c0b2a43538eb887ebf553bc0fe6b4b",
+  "agents/ui-visual-auditor.md": "808738bb9beaddbb1a318b5af9375907c694aad79d09ff308fd0cf4ef560f701",
+  "agents/ux-reviewer.md": "f7ccfdee74b7167130732e9e4b60f4bc76384e8cbcd346f67d4690a4310cad7a",
+  "agents/visual-reviewer.md": "fb1e14e81bdab69ce48629335718b0bceed64be6551ef3217033f233ae523346",
+  "agents/vitals-reviewer.md": "1a0c5d212c4260a96353771469f6f23b88d412c1468a6f64708d50ce4a62210a",
+  "patterns/generator.md": "009e73216e18aac251390f5d393d8c337f7714f0e5792ee03928f6e5f71c52f4",
+  "patterns/inversion.md": "50c23e1e3cd703a6bc9f4f70452dc9df2515d31b5e269d9a2cad8b158a382642",
+  "patterns/pipeline.md": "ae7a1cf81b83606887479623e69073bfb841ccf16ab3aff3248942a621cf3bbe",
+  "patterns/reviewer.md": "9aefbe2e1d70384c6acd39cf7e7ad7a582237096933069945d863178c5765611",
+  "patterns/tool-wrapper.md": "46e9b6b04f911415f0defdd44345570e818dfe6e3c4aafff1028582936f3fb8f",
+  "rules/GEMINI.md": "c77c36e6d8011895731deb645e524bdb0b15f1266c0b10f3fcd276824ceda02f",
+  "rules/GEMINI_PLANNER.md": "eb189fa733d63e0e87b61be94c35d940e541076161ac134546649d8d4404bced",
+  "workflows/tribunal-ui.md": "3ff8ad1d814f08fae8be453be5f4ec7bcdd7cdea36a8a51785018dafde94a8f3",
+  "workflows/ui-ux-pro-max.md": "04063384a85f12682ec2d99804dc4a1d90f51c74c4430723a212c27942495dfb",
+  "skills/context-engineering-pro/SKILL.md": "a888b0bb671f6a62e81cc23846d80e9a6591bb7968d5d59339bfc76c8424791a",
+  "skills/agentic-workflows-2026/SKILL.md": "b96c46d0915e6113e20a5498bbb8d8d79949da28cbdd4b8749a83ac909a5731b",
+  "skills/vector-search-pgvector/SKILL.md": "18a3495ea81b52c4c054945ae26e14bfbf59d8a9f893a3cdd6201da5b317a792",
+  "skills/duckdb-analytical-sql/SKILL.md": "0d282bf667f3bcaf88d0f71bb7f95c7f6a1e97131f035b88f0a9d28c2e2732ab",
+  "skills/expo-router-v4/SKILL.md": "8a0c8ecce143e7686661933af4bf88264ebd7c6074c0b6384711585515940125",
+  "skills/edge-ai-mobile/SKILL.md": "f6c75111597175e943291523226ec916ea8e4f21555780a32f60427e04bcc8ed",
+  "skills/platform-engineering-opentofu/SKILL.md": "a888b0bb671f6a62e81cc23846d80e9a6591bb7968d5d59339bfc76c8424791a",
+  "skills/opentelemetry-observability/SKILL.md": "60024b62cbe8165d0f9c0520675a7c2726ef1d54e81e1be6f65e182e96d9545a",
+  "skills/zero-trust-passkeys/SKILL.md": "ba8eaeb9b7957a9b6516532304e5fcd54bce2cee1b351ccf26a614aea7e778d0",
+  "skills/ai-app-hardening/SKILL.md": "03cfe2ac052856bd9483f3dc49d1fb848c8bbe0333d778a0f288bbdefd7f698e",
+  "skills/playwright-ai-e2e/SKILL.md": "778de79a3ec24a9bd6532d7d2bd5365b433208036d3d45e8783a7a72ee40c149",
+  "skills/property-based-testing/SKILL.md": "ed7dfa9119a955282465bc6e118bcd6b2994a90398e994d3547eed91309d3d15"
+}

package/.agent/ARCHITECTURE.md

@@ -1,281 +1,60 @@
-# 🏛️ Tribunal Anti-Hallucination Kit — Architecture
+# 🏛️ Tribunal Anti-Hallucination Kit v6.0.1 — Architecture
 
-Works natively in **Cursor**, **Windsurf**, **Antigravity**, and any AI IDE that indexes `.agent/` folders.
+Works natively in **Antigravity**, **Cursor**, **Windsurf**, and any AI IDE that indexes `.agent/` folders.
 
 ---
 
-## System Flow
+## 1. System Flow & Execution Lifecycle
 
 ```mermaid
 flowchart TD
     A["User Prompt"] --> B{"Classify Request"}
-    B -->|Question| C["Text Answer — No Agents"]
-    B -->|Survey| D["Read + Report — No Code"]
-    B -->|Simple Edit| E["Direct Edit"]
+    B -->|Question| C["Text Answer — No Agents / No Edits"]
+    B -->|Survey| D["Read + Report — No Code Written"]
+    B -->|Simple Edit| E["Direct Edit (Single File)"]
     B -->|Complex Build| F["Socratic Gate"]
     B -->|Slash Command| G["Route to Workflow"]
 
-    F --> H{"Questions Answered?"}
-    H -->|No| I["Ask Clarifying Questions"]
+    F --> H{"Clarification Cleared?"}
+    H -->|No| I["Ask Targeted Questions (Max 2)"]
     I --> H
-    H -->|Yes| J["Auto-Route to Agent"]
+    H -->|Yes| J["Auto-Route to Primary Agent"]
 
-    J --> K["Agent Generates Code"]
-    K --> L{"Tribunal Review"}
-    L -->|Approved| M{"Human Gate"}
-    L -->|Rejected| N["Feedback to Agent"]
+    J --> K["Maker Generates Code (Low Temp)"]
+    K --> L{"Parallel Tribunal Audit"}
+    L -->|All Approved| M{"Human Gate"}
+    L -->|Rejected| N["Structured Feedback to Maker"]
     N --> O{"Retry Count < 3?"}
     O -->|Yes| K
     O -->|No| P["HALT — Escalate to Human"]
 
-    M -->|Approved| Q["Write to Disk"]
+    M -->|Approved| Q["Write to Disk & Run Verification"]
     M -->|Rejected| R["Revise or Abandon"]
 ```
 
 ---
 
-## Slash Commands (Workflows)
+## 2. Option A + Option C Hybrid Architecture (v3.0.0 Standard)
 
-Type any of these in your AI IDE chat:
+### Subsystem A: 2-Tier Lazy Skill Routing Engine
+- **Lightweight Index (`skill_topic_map.json`):** 185 skills indexed across 9 domain routes and file extensions (~500 tokens).
+- **Startup Overhead:** ~2,500 – 3,500 startup tokens vs 85,000 tokens previously (95% token reduction).
+- **Zero Exclusions:** All 185 skills remain indexed on disk; target skills are fetched dynamically on-demand via `view_file`.
 
-| Command                 | Purpose                                                                                | File                                |
-| ----------------------- | -------------------------------------------------------------------------------------- | ----------------------------------- |
-| `/generate`             | Full Tribunal: Maker → Parallel Review → Human Gate                                    | `workflows/generate.md`             |
-| `/review`               | Audit existing code (no generation)                                                    | `workflows/review.md`               |
-| `/tribunal-full`        | ALL 19 reviewers at once — maximum coverage                                            | `workflows/tribunal-full.md`        |
-| `/tribunal-backend`     | Logic + Security + Deps + Types                                                        | `workflows/tribunal-backend.md`     |
-| `/tribunal-frontend`    | Logic + Security + Frontend + Types                                                    | `workflows/tribunal-frontend.md`    |
-| `/tribunal-database`    | Logic + Security + SQL                                                                 | `workflows/tribunal-database.md`    |
-| `/tribunal-mobile`      | Logic + Security + Mobile                                                              | `workflows/tribunal-mobile.md`      |
-| `/tribunal-performance` | Logic + Performance                                                                    | `workflows/tribunal-performance.md` |
-| `/brainstorm`           | Exploration mode — no code, just options                                               | `workflows/brainstorm.md`           |
-| `/create`               | Structured app creation (4-stage)                                                      | `workflows/create.md`               |
-| `/enhance`              | Add/update features in existing apps                                                   | `workflows/enhance.md`              |
-| `/debug`                | Systematic debugging with root cause analysis                                          | `workflows/debug.md`                |
-| `/plan`                 | Project planning only — no code                                                        | `workflows/plan.md`                 |
-| `/deploy`               | Pre-flight checks + deployment                                                         | `workflows/deploy.md`               |
-| `/test`                 | Test generation and execution                                                          | `workflows/test.md`                 |
-| `/preview`              | Start/stop local dev server                                                            | `workflows/preview.md`              |
-| `/status`               | Agent and project status board                                                         | `workflows/status.md`               |
-| `/session`              | Multi-session state tracking                                                           | `workflows/session.md`              |
-| `/orchestrate`          | Multi-agent coordination                                                               | `workflows/orchestrate.md`          |
-| `/swarm`                | Supervisor → specialist Workers → unified synthesis                                    | `workflows/swarm.md`                |
-| `/strengthen-skills`    | Audit and harden all skills — appends Tribunal guardrails to any SKILL.md missing them | `workflows/strengthen-skills.md`    |
-| `/ui-ux-pro-max`        | Plan and implement cutting-edge UI/UX                                                  | `workflows/ui-ux-pro-max.md`        |
-| `/refactor`             | Dependency-safe code refactoring                                                       | `workflows/refactor.md`             |
-| `/migrate`              | Framework upgrades, DB migrations                                                      | `workflows/migrate.md`              |
-| `/audit`                | Full project health audit                                                              | `workflows/audit.md`                |
-| `/fix`                  | Auto-fix lint, formatting, imports                                                     | `workflows/fix.md`                  |
-| `/changelog`            | Generate changelog from git history                                                    | `workflows/changelog.md`            |
-| `/review-ai`            | AI/LLM integration audit                                                               | `workflows/review-ai.md`            |
+### Subsystem C: Stage-Partitioned Tribunal Pipeline
+- **51 Specialist Agents** (21 Parallel Reviewers + 30 Domain Specialists).
+- **3 Execution Waves:** Replaces monolithic fan-out with 3 partitioned passes (21 reviewers total):
+  - **Wave 1 (Core Integrity):** `precedence-reviewer`, `logic-reviewer`, `schema-reviewer`, `resilience-reviewer`
+  - **Wave 2 (Security & Types):** `security-auditor`, `dependency-reviewer`, `type-safety-reviewer`, `complexity-reviewer`, `sql-reviewer`
+  - **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`
+- **Attention Preservation:** Reviewers execute in scoped 4-8 reviewer evaluation pairs, eliminating hallucination risks and attention dilution.
 
 ---
 
-## The 19 Tribunal Reviewers
+## 3. Skill-Script Binding Standard
 
-| Agent                    | File                               | Activates When                                                                      |
-| ------------------------ | ---------------------------------- | ----------------------------------------------------------------------------------- |
-| `logic-reviewer`         | `agents/logic-reviewer.md`         | All sessions (always on)                                                            |
-| `security-auditor`       | `agents/security-auditor.md`       | All sessions (always on)                                                            |
-| `performance-reviewer`   | `agents/performance-reviewer.md`   | "optimize", "slow", `/tribunal-full`                                                |
-| `dependency-reviewer`    | `agents/dependency-reviewer.md`    | "api", "backend", `/tribunal-full`                                                  |
-| `type-safety-reviewer`   | `agents/type-safety-reviewer.md`   | "typescript", "api", `/tribunal-full`                                               |
-| `sql-reviewer`           | `agents/sql-reviewer.md`           | "query", "database", `/tribunal-full`                                               |
-| `frontend-reviewer`      | `agents/frontend-reviewer.md`      | "react", "hook", "component", `/tribunal-full`                                      |
-| `test-coverage-reviewer` | `agents/test-coverage-reviewer.md` | "test", "spec", "coverage", `/tribunal-full`                                        |
-| `mobile-reviewer`        | `agents/mobile-reviewer.md`        | "mobile", "react native", "flutter", `/tribunal-full`                               |
-| `ai-code-reviewer`       | `agents/ai-code-reviewer.md`       | "llm", "openai", "anthropic", "ai", `/tribunal-full`, `/review-ai`                  |
-| `accessibility-reviewer` | `agents/accessibility-reviewer.md` | "a11y", "wcag", "aria", `/tribunal-frontend`, `/tribunal-full`                      |
-| `resilience-reviewer`    | `agents/resilience-reviewer.md`    | "retry", "circuit breaker", "error boundary", `/tribunal-backend`, `/tribunal-full` |
-| `schema-reviewer`        | `agents/schema-reviewer.md`        | "validation", "zod", "pydantic", `/tribunal-backend`, `/tribunal-full`              |
-| `precedence-reviewer`    | `agents/precedence-reviewer.md`    | All sessions — checks Case Law before generation                                    |
-| `penetration-tester`     | `agents/penetration-tester.md`     | "pentest", "red team", "attack surface", `/tribunal-full`                           |
-| `ui-ux-auditor`          | `agents/ui-ux-auditor.md`          | "component", "ui", "design", "landing", `/tribunal-frontend`, `/tribunal-full`      |
-| `vitals-reviewer`        | `agents/vitals-reviewer.md`        | Frontend CWV depth, `/tribunal-speed`, `/tribunal-full`                             |
-| `throughput-optimizer`   | `agents/throughput-optimizer.md`   | Server runtime, event-loop, `/tribunal-speed`, `/tribunal-full`                     |
-| `db-latency-auditor`     | `agents/db-latency-auditor.md`     | "slow query", "index", "N+1", `/tribunal-speed`, `/tribunal-full`                   |
-
----
-
-## Swarm / Supervisor Architecture
-
-The Swarm system decomposes complex multi-domain goals into independent sub-tasks dispatched to specialist Workers.
-
-```
-/swarm [complex multi-domain goal]
-        │
-        ▽
-  supervisor-agent (triage)
-  └─ reads: swarm-worker-registry.md
-  └─ emits: WorkerRequest JSON per sub-task
-        │
-        ├───── WorkerRequest ───→ Worker A (e.g. backend-specialist)
-        ├───── WorkerRequest ───→ Worker B (e.g. database-architect)
-        └───── WorkerRequest ───→ Worker C (e.g. documentation-writer)
-                                    │
-                          WorkerResult (success/failure/escalate)
-                                    │
-                         supervisor-agent (synthesize)
-                                    │
-                         ━━━ Swarm Complete ━━━
-                         Human Gate → Y / N / R
-```
-
-**Key files:**
-
-| File                               | Role                                                           |
-| ---------------------------------- | -------------------------------------------------------------- |
-| `agents/supervisor-agent.md`       | Triage, dispatch, retry, synthesis logic                       |
-| `agents/swarm-worker-contracts.md` | WorkerRequest + WorkerResult JSON schemas                      |
-| `agents/swarm-worker-registry.md`  | Maps task types and keywords to specialist agents              |
-| `workflows/swarm.md`               | `/swarm` slash command procedure                               |
-| `scripts/swarm_dispatcher.js`      | Validates WorkerRequest/WorkerResult JSON (use `--mode swarm`) |
-
-**Constraints:**
-
-- Maximum 5 Workers per swarm invocation
-- Workers are independent — no Worker depends on another's pending result
-- Failed workers are retried up to 3 times with targeted feedback
-- Workers that fail after 3 retries are escalated, not silently dropped
-- Human Gate is never skipped
-
----
-
-## Specialist Agents
-
-| Agent / Expert              | Domain                                          |
-| --------------------------- | ----------------------------------------------- |
-| `supervisor-agent`          | Swarm triage, Worker dispatch, result synthesis |
-| `orchestrator`              | Multi-agent coordination                        |
-| `agent-organizer`           | Specialist agent operations                     |
-| `project-planner`           | 4-phase structured planning                     |
-| `backend-specialist`        | API, server, auth                               |
-| `csharp-developer`          | C# / .NET architecture                          |
-| `python-pro`                | Python backend development                      |
-| `frontend-specialist`       | Web UI / Components                             |
-| `react-specialist`          | React / Next.js architecture                    |
-| `vue-expert`                | Vue / Nuxt applications                         |
-| `database-architect`        | Schema, migrations                              |
-| `sql-pro`                   | Complex queries, optimization                   |
-| `mobile-developer`          | React Native, Flutter                           |
-| `devops-engineer`           | CI/CD, Docker, deployment                       |
-| `platform-engineer`         | Infrastructure, cloud native                    |
-| `devops-incident-responder` | Production issues                               |
-| `debugger`                  | Systematic debugging                            |
-| `game-developer`            | Game development                                |
-| `security-auditor`          | Penetration testing, OWASP                      |
-| `penetration-tester`        | Red team tactics                                |
-| `performance-optimizer`     | Profiling, optimization                         |
-| `code-archaeologist`        | Legacy code analysis                            |
-| `explorer-agent`            | Unknown codebase mapping                        |
-| `documentation-writer`      | Docs, READMEs, API docs                         |
-| `test-engineer`             | Test design and strategy                        |
-| `qa-automation-engineer`    | Test automation                                 |
-| `seo-specialist`            | SEO auditing                                    |
-| `product-manager`           | Feature prioritization                          |
-| `product-owner`             | Requirements, scope                             |
-
----
-
-## How the Tribunal Works
-
-```
-User prompt
-    │
-    ▼
-GEMINI.md → Classify request → Select active reviewers
-    │
-    ▼
-MAKER generates code (context-bound, no hallucinations)
-    │
-    ▼
-ALL SELECTED REVIEWERS run in parallel
-    │
-    ├── Logic      → hallucinated methods?
-    ├── Security   → OWASP violations?
-    ├── Deps       → fake npm packages?
-    ├── Types      → any/unsafe casts?
-    ├── SQL        → injection / N+1?
-    ├── Frontend   → hooks violations?
-    ├── Perf       → O(n²) / blocking I/O?
-    └── Tests      → tautology / no edges?
-    │
-    ▼
-VERDICT: All approved → HUMAN GATE (you approve or reject the diff)
-         Any failed   → Feedback returned to Maker for revision (max 3 attempts)
-         3 failures   → HALT and escalate to human
-```
-
----
-
-## Auto Domain Routing (GEMINI.md)
-
-| Keywords in prompt           | Extra reviewers added     |
-| ---------------------------- | ------------------------- |
-| api, route, endpoint, server | + Dependency + TypeSafety |
-| sql, query, database, orm    | + SQL                     |
-| component, hook, react, next | + Frontend + TypeSafety   |
-| test, spec, coverage, jest   | + TestCoverage            |
-| optimize, slow, memory, cpu  | + Performance             |
-
----
-
-## Script Inventory
-
-All scripts live in `.agent/scripts/`:
-
-| Script                     | Purpose                                                                           | Usage                                                         |
-| -------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------- |
-| `checklist.js`             | Priority-ordered project audit                                                    | `node .agent/scripts/checklist.js .`                          |
-| `verify_all.js`            | Full pre-deploy validation                                                        | `node .agent/scripts/verify_all.js`                           |
-| `auto_preview.js`          | Local dev server management                                                       | `node .agent/scripts/auto_preview.js start`                   |
-| `session_manager.js`       | Multi-session state tracking                                                      | `node .agent/scripts/session_manager.js status`               |
-| `lint_runner.js`           | Standalone lint runner                                                            | `node .agent/scripts/lint_runner.js . --fix`                  |
-| `test_runner.js`           | Auto-detecting test runner                                                        | `node .agent/scripts/test_runner.js . --coverage`             |
-| `security_scan.js`         | OWASP-aware source code scanner                                                   | `node .agent/scripts/security_scan.js .`                      |
-| `dependency_analyzer.js`   | Unused/phantom dep checker                                                        | `node .agent/scripts/dependency_analyzer.js . --audit`        |
-| `schema_validator.js`      | DB schema validator                                                               | `node .agent/scripts/schema_validator.js .`                   |
-| `bundle_analyzer.js`       | JS/TS bundle size analyzer                                                        | `node .agent/scripts/bundle_analyzer.js . --build`            |
-| `strengthen_skills.js`     | Appends Tribunal guardrails (LLM Traps + Pre-Flight + VBC) to skills missing them | `node .agent/scripts/strengthen_skills.js . --dry-run`        |
-| `swarm_dispatcher.js`      | Validate Orchestrator micro-worker JSON payloads                                  | `node .agent/scripts/swarm_dispatcher.js --file payload.json` |
-| `skill_integrator.js`      | Map active skills to executable scripts                                           | `node .agent/scripts/skill_integrator.js`                     |
-| `test_swarm_dispatcher.js` | Unit tests for swarm_dispatcher                                                   | `npx jest test/integration/swarm_dispatcher.test.js`          |
-
----
-
-## Error Recovery
-
-```
-Attempt 1  → Run with original parameters
-Attempt 2  → Run with feedback from failure
-Attempt 3  → Run with maximum constraints
-Attempt 4  → HALT — escalate to human with full failure history
-```
-
-Script failures follow cascade rules:
-
-- Security failure → **HALT** all steps
-- Lint failure → continue, flag as deploy-blocker
-- Test failure → continue analysis, mark incomplete
-- Non-critical failure → log and continue
-
----
-
-## Directory Structure
-
-```
-.agent/
-├── ARCHITECTURE.md          ← This file
-├── GEMINI.md                ← Root behavior config (includes /swarm routing)
-├── agents/                  ← 44 specialist + reviewer agents (19 reviewers + 25 domain)
-│   ├── supervisor-agent.md  ← Swarm triage, dispatch, synthesis
-│   ├── swarm-worker-contracts.md  ← WorkerRequest/WorkerResult schemas
-│   └── swarm-worker-registry.md   ← Task type → agent routing map
-├── rules/GEMINI.md          ← Master rules (P0 priority)
-├── scripts/                 ← 31 automation scripts
-├── skills/                  ← 168 valid skill packages (all hardened)
-├── patterns/                ← 5 ADK skill base patterns
-├── history/                 ← Case Law + Skill Evolution data (user-generated, preserved on update)
-└── workflows/               ← 34 slash command definitions
-    └── swarm.md             ← /swarm orchestration procedure
-```
+Every skill in `.agent/skills/` conforms to the Option A+C Hybrid v3.0.0 frontmatter standard:
+- `version`: `3.0.0`
+- `script`: Primary executable script path in `.agent/scripts/`
+- `scripts-binding`: Array of executable CLI tools (`security_scan.js`, `test_runner.js`, `schema_validator.js`, etc.)
+- `skills`: Array of co-required brother skills for automatic 2-tier lazy resolution