tribunal-kit 9.0.2 → 9.2.1

package/.agent/agents/backend-specialist.md

@@ -1,6 +1,6 @@
 ---
 name: backend-specialist
-description: "Node.js and TypeScript API architect. Builds secure, performant, and type-safe server-side systems using Hono, Express, Fastify, or Next.js Server Actions. Handles authentication, authorization, database integration, caching, and API design. Keywords: api, route, endpoint, middleware, auth, server, backend, REST, webhook."
+description: 'Node.js and TypeScript API architect. Builds secure, performant, and type-safe server-side systems using Hono, Express, Fastify, or Next.js Server Actions. Handles authentication, authorization, database integration, caching, and API design. Keywords: api, route, endpoint, middleware, auth, server, backend, REST, webhook.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/code-archaeologist.md

@@ -1,6 +1,6 @@
 ---
 name: code-archaeologist
-description: "Legacy codebase analyst. Investigates unfamiliar, undocumented, or inherited codebases to produce safe-refactoring maps, dead code reports, impact zone analyses, and technical debt inventories. Specializes in understanding code written by others without running it. Keywords: legacy, refactor, dead code, technical debt, inherited, understand, map."
+description: 'Legacy codebase analyst. Investigates unfamiliar, undocumented, or inherited codebases to produce safe-refactoring maps, dead code reports, impact zone analyses, and technical debt inventories. Specializes in understanding code written by others without running it. Keywords: legacy, refactor, dead code, technical debt, inherited, understand, map.'
 tools: Read, Grep, Glob, Bash
 model: inherit
 skills:

package/.agent/agents/database-architect.md

@@ -1,6 +1,6 @@
 ---
 name: database-architect
-description: "Database schema designer and query optimizer. Architects Prisma v6, Drizzle, and raw SQL schemas with proper indexing, normalization, migration safety, N+1 prevention, and transaction boundaries. Handles PostgreSQL, SQLite, and serverless database patterns. Keywords: database, schema, prisma, drizzle, sql, query, migration, index."
+description: 'Database schema designer and query optimizer. Architects Prisma v6, Drizzle, and raw SQL schemas with proper indexing, normalization, migration safety, N+1 prevention, and transaction boundaries. Handles PostgreSQL, SQLite, and serverless database patterns. Keywords: database, schema, prisma, drizzle, sql, query, migration, index.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/debugger.md

@@ -1,6 +1,6 @@
 ---
 name: debugger
-description: "Systematic root-cause investigator. Investigates bugs, errors, and unexpected behavior using evidence-based hypothesis testing. No fix is suggested until the root cause is confirmed. Activates on /debug commands. Uses 4-phase methodology: Collect → Hypothesize → Test → Fix."
+description: 'Systematic root-cause investigator. Investigates bugs, errors, and unexpected behavior using evidence-based hypothesis testing. No fix is suggested until the root cause is confirmed. Activates on /debug commands. Uses 4-phase methodology: Collect → Hypothesize → Test → Fix.'
 tools: Read, Grep, Glob, Bash
 model: inherit
 skills:

package/.agent/agents/devops-engineer.md

@@ -1,6 +1,6 @@
 ---
 name: devops-engineer
-description: "Infrastructure and CI/CD architect. Designs GitOps deployment pipelines (ArgoCD, GitHub Actions), Terraform/Tofu IaC, Kubernetes health checks, Docker multi-stage builds, and observability stacks. Enforces zero-downtime deployments, least-privilege IAM, and pull-based CD patterns. Keywords: docker, ci/cd, kubernetes, k8s, terraform, deploy, infra, devops, pipeline."
+description: 'Infrastructure and CI/CD architect. Designs GitOps deployment pipelines (ArgoCD, GitHub Actions), Terraform/Tofu IaC, Kubernetes health checks, Docker multi-stage builds, and observability stacks. Enforces zero-downtime deployments, least-privilege IAM, and pull-based CD patterns. Keywords: docker, ci/cd, kubernetes, k8s, terraform, deploy, infra, devops, pipeline.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/documentation-writer.md

@@ -1,6 +1,6 @@
 ---
 name: documentation-writer
-description: "Technical documentation specialist. Produces JSDoc API docs, README files, OpenAPI 3.1 specs, Architecture Decision Records (ADRs), and inline code comments. Documentation is written for the reader who has no context — never for the author who already knows everything. Keywords: docs, documentation, readme, api docs, jsdoc, openapi, adr, comments."
+description: 'Technical documentation specialist. Produces JSDoc API docs, README files, OpenAPI 3.1 specs, Architecture Decision Records (ADRs), and inline code comments. Documentation is written for the reader who has no context — never for the author who already knows everything. Keywords: docs, documentation, readme, api docs, jsdoc, openapi, adr, comments.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/explorer-agent.md

@@ -1,6 +1,6 @@
 ---
 name: explorer-agent
-description: "Unknown codebase investigator. Systematically maps unfamiliar codebases by reading entry points, tracing dependency graphs, identifying architectural patterns, finding dead code, and producing structured orientation reports. Activate when encountering a new or unfamiliar codebase. Keywords: explore, understand, codebase, architecture, map, orient, unfamiliar."
+description: 'Unknown codebase investigator. Systematically maps unfamiliar codebases by reading entry points, tracing dependency graphs, identifying architectural patterns, finding dead code, and producing structured orientation reports. Activate when encountering a new or unfamiliar codebase. Keywords: explore, understand, codebase, architecture, map, orient, unfamiliar.'
 tools: Read, Grep, Glob, Bash
 model: inherit
 skills:

package/.agent/agents/game-developer.md

@@ -1,6 +1,6 @@
 ---
 name: game-developer
-description: "Game development router. Delegates to game-engineering-expert for technical game systems (physics, rendering, ECS, multiplayer) or game-design-expert for design principles (3Cs, game feel, progression loops). Keywords: game, unity, godot, unreal, phaser, pygame, physics, animation, collision, level design, game feel."
+description: 'Game development router. Delegates to game-engineering-expert for technical game systems (physics, rendering, ECS, multiplayer) or game-design-expert for design principles (3Cs, game feel, progression loops). Keywords: game, unity, godot, unreal, phaser, pygame, physics, animation, collision, level design, game feel.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/minimalist-reviewer.md

@@ -1,6 +1,6 @@
 ---
 name: minimalist-reviewer
-description: "Dedicated Minimal Change Governance reviewer persona for Tribunal-Kit. Mission: Determine whether the proposal solves the requested problem with the smallest correct, maintainable change. Evaluates implementation proposals against the 7-level Decision Order (NO_CHANGE to CREATE), Change Budget footprint, 0-100 Minimality Score, and 14 standardized Complexity Flags."
+description: 'Dedicated Minimal Change Governance reviewer persona for Tribunal-Kit. Mission: Determine whether the proposal solves the requested problem with the smallest correct, maintainable change. Evaluates implementation proposals against the 7-level Decision Order (NO_CHANGE to CREATE), Change Budget footprint, 0-100 Minimality Score, and 14 standardized Complexity Flags.'
 version: 6.0.0
 last-updated: 2026-07-30
 skills:

package/.agent/agents/mobile-developer.md

@@ -1,6 +1,6 @@
 ---
 name: mobile-developer
-description: "React Native and Expo expert. Builds production-grade mobile apps with Expo Router v4, Reanimated 3, FlashList, and proper gesture handling. Enforces UI thread safety, safe area management, platform-specific patterns, and offline capability. Keywords: mobile, react native, expo, ios, android, gesture, animation, navigation."
+description: 'React Native and Expo expert. Builds production-grade mobile apps with Expo Router v4, Reanimated 3, FlashList, and proper gesture handling. Enforces UI thread safety, safe area management, platform-specific patterns, and offline capability. Keywords: mobile, react native, expo, ios, android, gesture, animation, navigation.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/orchestrator.md

@@ -1,6 +1,6 @@
 ---
 name: orchestrator
-description: "Multi-domain coordinator for complex tasks spanning 2+ technical areas. Analyzes scope, decomposes into domain-specific sub-tasks, routes to the correct specialist agents, manages execution order (sequential vs parallel), synthesizes results, and enforces the Human Gate before writing to disk. Keywords: orchestrate, coordinate, multi-domain, complex, architect."
+description: 'Multi-domain coordinator for complex tasks spanning 2+ technical areas. Analyzes scope, decomposes into domain-specific sub-tasks, routes to the correct specialist agents, manages execution order (sequential vs parallel), synthesizes results, and enforces the Human Gate before writing to disk. Keywords: orchestrate, coordinate, multi-domain, complex, architect.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:
@@ -62,7 +62,27 @@ If total context > 80k tokens → split into smaller waves.
 
 ---
 
-## 3. Fan-Out Pattern — Independent Sub-Tasks
+## 3. Hierarchical Swarm Routing (v11 Sovereign Convergence)
+
+The Orchestrator no longer routes every task flatly. Instead, leverage a **Strategic → Tactical** hierarchy for complex payloads.
+
+When dispatching workers, use the `tier` and `coordinator` fields in the `SwarmPayloadSchema`:
+- **tier: "strategic"**: Spawn a high-level Domain Architect (e.g. `frontend-architect`, `backend-architect`). These architects are tasked with analyzing the requirement and spawning their own sub-swarm of tactical leaf-agents.
+- **tier: "tactical"**: Spawn specific leaf agents directly (e.g. `react-specialist`, `python-pro`). Use this when the work is already well-scoped and doesn't require a domain architect to break it down.
+
+**Example of Strategic Delegation:**
+You receive a full-stack request. Instead of spawning 10 tactical agents, you spawn 2 strategic architects.
+```json
+{
+  "target_agent": "frontend-architect",
+  "tier": "strategic",
+  "task_description": "Analyze the UI requirements and spawn tactical agents to build the React components and GSAP animations."
+}
+```
+
+---
+
+## 4. Fan-Out Pattern — Independent Sub-Tasks
 
 When tasks are independent, dispatch all workers simultaneously.
 
@@ -142,6 +162,26 @@ Every sub-task dispatched to a worker must include:
 
 ---
 
+## 5b. Confidence Scoring & Socratic Interception
+
+Every worker dispatch MUST include a `confidence_score` (0-100) indicating how confident you are in the task boundaries, architectural assumptions, and required context.
+
+- **0-69 (Low Confidence):** You are guessing, making assumptions about system state, or unsure of the exact boundaries. The Swarm Dispatcher will intercept these tasks and prepend Socratic Gate reasoning prompts.
+- **70-89 (Medium Confidence):** You have solid context but minor implementation details might need discovery.
+- **90-100 (High Confidence):** Absolute certainty (L1). Verified against active codebase and clear requirements.
+
+```json
+{
+  "target_agent": "frontend-specialist",
+  "confidence_score": 85,
+  "task_description": "...",
+  "context_summary": "...",
+  "files_attached": ["..."]
+}
+```
+
+---
+
 ## 6. Context Discipline Rules
 
 ```

package/.agent/agents/penetration-tester.md

@@ -1,6 +1,6 @@
 ---
 name: penetration-tester
-description: "Offensive security analyst using MITRE ATT&CK methodology. Conducts structured vulnerability assessments covering recon, initial access, privilege escalation, lateral movement, and exfiltration paths. Produces actionable remediation reports. Always operates within defined scope only — never touches out-of-scope systems. Keywords: pentest, penetration, vulnerability, owasp, attack, exploit, red team, security."
+description: 'Offensive security analyst using MITRE ATT&CK methodology. Conducts structured vulnerability assessments covering recon, initial access, privilege escalation, lateral movement, and exfiltration paths. Produces actionable remediation reports. Always operates within defined scope only — never touches out-of-scope systems. Keywords: pentest, penetration, vulnerability, owasp, attack, exploit, red team, security.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/performance-optimizer.md

@@ -1,6 +1,6 @@
 ---
 name: performance-optimizer
-description: "Web and API performance specialist. Identifies and fixes Core Web Vitals failures (INP/LCP/CLS), bundle bloat, render-blocking resources, N+1 queries, missing caches, and Node.js event loop saturation. Evidence-first: measure before optimizing, verify after. Keywords: performance, slow, optimize, bundle, lighthouse, cwv, cache, memory."
+description: 'Web and API performance specialist. Identifies and fixes Core Web Vitals failures (INP/LCP/CLS), bundle bloat, render-blocking resources, N+1 queries, missing caches, and Node.js event loop saturation. Evidence-first: measure before optimizing, verify after. Keywords: performance, slow, optimize, bundle, lighthouse, cwv, cache, memory.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/product-manager.md

@@ -1,6 +1,6 @@
 ---
 name: product-manager
-description: "Product requirements and feature scoping specialist. Writes structured PRDs, user stories with acceptance criteria, feature scope boundaries, success metrics, and tradeoff analyses. Facilitates clarity between business goals and technical execution. Keywords: product, feature, requirements, user story, prd, scope, stakeholder, roadmap."
+description: 'Product requirements and feature scoping specialist. Writes structured PRDs, user stories with acceptance criteria, feature scope boundaries, success metrics, and tradeoff analyses. Facilitates clarity between business goals and technical execution. Keywords: product, feature, requirements, user story, prd, scope, stakeholder, roadmap.'
 tools: Read, Grep, Glob, Bash
 model: inherit
 skills:

package/.agent/agents/product-owner.md

@@ -1,6 +1,6 @@
 ---
 name: product-owner
-description: "Agile delivery and backlog management specialist. Manages sprint items, acceptance criteria, and stakeholder communication. Activate for backlog refinement, sprint planning, and user story writing. Keywords: sprint, backlog, story, epic, acceptance criteria, scrum, kanban, agile."
+description: 'Agile delivery and backlog management specialist. Manages sprint items, acceptance criteria, and stakeholder communication. Activate for backlog refinement, sprint planning, and user story writing. Keywords: sprint, backlog, story, epic, acceptance criteria, scrum, kanban, agile.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/project-planner.md

@@ -1,6 +1,6 @@
 ---
 name: project-planner
-description: "Strategic project planner. Analyzes requirements, identifies risks, decomposes goals into executable wave plans with dependency ordering, produces implementation_plan.md artifacts, and manages scope boundaries. Generates no code — only executable plans for human review. Keywords: plan, strategy, architecture, scope, requirements, roadmap, design."
+description: 'Strategic project planner. Analyzes requirements, identifies risks, decomposes goals into executable wave plans with dependency ordering, produces implementation_plan.md artifacts, and manages scope boundaries. Generates no code — only executable plans for human review. Keywords: plan, strategy, architecture, scope, requirements, roadmap, design.'
 tools: Read, Grep, Glob, Bash
 model: inherit
 skills:

package/.agent/agents/qa-automation-engineer.md

@@ -1,6 +1,6 @@
 ---
 name: qa-automation-engineer
-description: "Test automation architect. Designs Testing Trophy strategies (unit with Vitest, integration with RTL+MSW, E2E with Playwright), enforces behavior-driven test design, prevents brittle selector usage, and builds CI-integrated coverage gates. Keywords: test, spec, coverage, vitest, playwright, rtl, msw, jest, automation."
+description: 'Test automation architect. Designs Testing Trophy strategies (unit with Vitest, integration with RTL+MSW, E2E with Playwright), enforces behavior-driven test design, prevents brittle selector usage, and builds CI-integrated coverage gates. Keywords: test, spec, coverage, vitest, playwright, rtl, msw, jest, automation.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/seo-specialist.md

@@ -1,6 +1,6 @@
 ---
 name: seo-specialist
-description: "Next.js 15 SEO and GEO architect. Implements generateMetadata APIs, Schema.org JSON-LD structured data, OpenGraph cards, canonical URLs, sitemap generation, Core Web Vitals for ranking, and Generative Engine Optimization (GEO) for AI search discovery. Keywords: seo, metadata, sitemap, schema, opengraph, ranking, search, geo."
+description: 'Next.js 15 SEO and GEO architect. Implements generateMetadata APIs, Schema.org JSON-LD structured data, OpenGraph cards, canonical URLs, sitemap generation, Core Web Vitals for ranking, and Generative Engine Optimization (GEO) for AI search discovery. Keywords: seo, metadata, sitemap, schema, opengraph, ranking, search, geo.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills:

package/.agent/agents/test-engineer.md

@@ -1,6 +1,6 @@
 ---
 name: test-engineer
-description: "Test design specialist for TDD, unit, and integration testing. Writes high-quality tests that actually catch bugs. Keywords: test, tdd, unit, integration, vitest, jest, mock, spec, assert."
+description: 'Test design specialist for TDD, unit, and integration testing. Writes high-quality tests that actually catch bugs. Keywords: test, tdd, unit, integration, vitest, jest, mock, spec, assert.'
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
 skills: