tribunal-kit 3.0.0 → 4.0.0

package/.agent/rules/GEMINI.md

@@ -4,8 +4,8 @@ trigger: always_on
 
 # Tribunal Agent Kit — Master Rules
 
-> These rules are always active. Every agent, every request, every response.
-> Rule priority: this file (P0) > agent .md file (P1) > skill SKILL.md (P2)
+These rules are always active. Every agent, every request, every response.
+Rule priority: this file (P0) agent .md file (P1) skill SKILL.md (P2)
 
 ---
 
@@ -13,14 +13,14 @@ trigger: always_on
 
 Before any action, identify request type:
 
-| Type | Keywords | What Happens |
+|Type|Keywords|What Happens|
 |---|---|---|
-| **Question** | "what is", "how does", "explain", "why" | Text answer only — no agents, no files |
-| **Survey** | "analyze", "list", "overview", "scan" | Read + report — no code written |
-| **Simple edit** | "fix", "change", "update" (single file) | Direct edit — no plan required |
-| **Complex build** | "build", "create", "implement", "refactor" | Requires plan file + agent routing |
-| **Design/UI** | "design", "UI", "page", "dashboard" | Requires design agent + plan file |
-| **Slash command** | starts with `/` | Route to matching workflow file |
+|**Question**|"what is", "how does", "explain", "why"|Text answer only — no agents, no files|
+|**Survey**|"analyze", "list", "overview", "scan"|Read + report — no code written|
+|**Simple edit**|"fix", "change", "update" (single file)|Direct edit — no plan required|
+|**Complex build**|"build", "create", "implement", "refactor"|Requires plan file + agent routing|
+|**Design/UI**|"design", "UI", "page", "dashboard"|Requires design agent + plan file|
+|**Slash command**|starts with `/`|Route to matching workflow file|
 
 ---
 
@@ -30,26 +30,26 @@ Every code or design request activates an agent. This is not optional.
 
 **Auto-routing rules:**
 
-| Domain | Primary Agent / Skill |
+|Domain|Primary Agent / Skill|
 |---|---|
-| API / server / backend | `backend-specialist` |
-| C# / .NET / Blazor | `dotnet-core-expert` |
-| Python / FastAPI / Django | `python-pro` |
-| Database / schema / SQL | `database-architect` |
-| Advanced SQL queries | `sql-pro` |
-| React / Next.js / UI | `frontend-specialist` |
-| Advanced React architecture | `react-specialist` |
-| Vue / Nuxt | `vue-expert` |
-| Mobile (RN / Flutter) | `mobile-developer` |
-| Debugging / errors | `debugger` |
-| Security / vulnerabilities | `security-auditor` |
-| Performance / optimization | `performance-optimizer` |
-| DevOps / CI-CD / Docker | `devops-engineer` |
-| Production incidents | `devops-incident-responder` |
-| Platform / Infrastructure | `platform-engineer` |
-| Multi-agent architecture | `agent-organizer` |
-| Multi-domain (2+ areas) | `orchestrator` |
-| Unknown codebase | `explorer-agent` |
+|API / server / backend|`backend-specialist`|
+|C# / .NET / Blazor|`dotnet-core-expert`|
+|Python / FastAPI / Django|`python-pro`|
+|Database / schema / SQL|`database-architect`|
+|Advanced SQL queries|`sql-pro`|
+|React / Next.js / UI|`frontend-specialist`|
+|Advanced React architecture|`react-specialist`|
+|Vue / Nuxt|`vue-expert`|
+|Mobile (RN / Flutter)|`mobile-developer`|
+|Debugging / errors|`debugger`|
+|Security / vulnerabilities|`security-auditor`|
+|Performance / optimization|`performance-optimizer`|
+|DevOps / CI-CD / Docker|`devops-engineer`|
+|Production incidents|`devops-incident-responder`|
+|Platform / Infrastructure|`platform-engineer`|
+|Multi-agent architecture|`agent-organizer`|
+|Multi-domain (2+ areas)|`orchestrator`|
+|Unknown codebase|`explorer-agent`|
 
 **When activated, announce the agent:**
 
@@ -76,12 +76,12 @@ For any complex build, new feature, or unclear request — stop and ask before w
 
 **Required questions by type:**
 
-| Request | Minimum Questions |
+|Request|Minimum Questions|
 |---|---|
-| New feature or build | 3+ strategic questions about goal, stack, scope |
-| Code edit or bug fix | Confirm understanding + ask about impact |
-| Vague request | Ask about purpose, users, and scope |
-| Full orchestration | Block all subagents until plan is confirmed |
+|New feature or build|3+ strategic questions about goal, stack, scope|
+|Code edit or bug fix|Confirm understanding + ask about impact|
+|Vague request|Ask about purpose, users, and scope|
+|Full orchestration|Block all subagents until plan is confirmed|
 
 **Rules:**
 - Never assume. If even 1% is unclear → ask.
@@ -136,14 +136,14 @@ The Human Gate is never skipped. No code is written to a file without explicit u
 
 **Reviewer assignment by domain:**
 
-| Code type | Reviewers |
+|Code type|Reviewers|
 |---|---|
-| Backend/API | logic + security + dependency + type-safety |
-| Frontend/React | logic + security + frontend + type-safety |
-| Database/SQL | logic + security + sql |
-| Mobile/Cross-platform | logic + security + mobile-reviewer + type-safety |
-| Any domain | + performance (if optimization) |
-| Before merge | /tribunal-full (all 9) |
+|Backend/API|logic + security + dependency + type-safety|
+|Frontend/React|logic + security + frontend + type-safety|
+|Database/SQL|logic + security + sql|
+|Mobile/Cross-platform|logic + security + mobile-reviewer + type-safety|
+|Any domain|+ performance (if optimization)|
+|Before merge|/tribunal-full (all 9)|
 
 ---
 
@@ -200,21 +200,21 @@ Script crashes      → Catch exception, report stack trace, continue
 
 These scripts live in `.agent/scripts/`. Agents and skills can invoke them:
 
-| Script | Purpose | When |
+|Script|Purpose|When|
 |---|---|---|
-| `checklist.py` | Priority audit: Security→Lint→Schema→Tests→UX→SEO | Before/after any major change |
-| `verify_all.py` | Full pre-deploy validation suite | Pre-deploy |
-| `auto_preview.py` | Start/stop/restart local dev server | After /create or /enhance |
-| `session_manager.py` | Track session state between conversations | Multi-session work |
-| `lint_runner.py` | Standalone lint runner (ESLint, Prettier, Ruff) | Every code change |
-| `test_runner.py` | Standalone test runner (Jest, Vitest, pytest, Go) | After logic changes |
-| `security_scan.py` | Deep OWASP-aware source code security scan | Always on deploy, /audit |
-| `dependency_analyzer.py` | Unused/phantom deps, npm audit | Weekly, /audit |
-| `schema_validator.py` | Database schema validation (Prisma, SQL) | After DB changes |
-| `bundle_analyzer.py` | JS/TS bundle size analysis | Before deploy |
-| `skill_integrator.py` | Maps active skills to their executable scripts | Automatically when skills are invoked |
-| `swarm_dispatcher.py` | Validate Orchestrator micro-worker JSON payloads | After /orchestrate, before dispatching agents |
-| `test_swarm_dispatcher.py` | Unit tests for swarm_dispatcher | After modifying swarm_dispatcher.py |
+|`checklist.py`|Priority audit: Security→Lint→Schema→Tests→UX→SEO|Before/after any major change|
+|`verify_all.py`|Full pre-deploy validation suite|Pre-deploy|
+|`auto_preview.py`|Start/stop/restart local dev server|After /create or /enhance|
+|`session_manager.py`|Track session state between conversations|Multi-session work|
+|`lint_runner.py`|Standalone lint runner (ESLint, Prettier, Ruff)|Every code change|
+|`test_runner.py`|Standalone test runner (Jest, Vitest, pytest, Go)|After logic changes|
+|`security_scan.py`|Deep OWASP-aware source code security scan|Always on deploy, /audit|
+|`dependency_analyzer.py`|Unused/phantom deps, npm audit|Weekly, /audit|
+|`schema_validator.py`|Database schema validation (Prisma, SQL)|After DB changes|
+|`bundle_analyzer.py`|JS/TS bundle size analysis|Before deploy|
+|`skill_integrator.py`|Maps active skills to their executable scripts|Automatically when skills are invoked|
+|`swarm_dispatcher.py`|Validate Orchestrator micro-worker JSON payloads|After /orchestrate, before dispatching agents|
+|`test_swarm_dispatcher.py`|Unit tests for swarm_dispatcher|After modifying swarm_dispatcher.py|
 
 **Run pattern:**
 ```
@@ -235,11 +235,11 @@ python .agent/scripts/test_swarm_dispatcher.py
 
 ## Mode Behavior
 
-| Mode | Active Agent | Rules |
+|Mode|Active Agent|Rules|
 |---|---|---|
-| `plan` | `project-planner` | 4-phase: Analyze → Plan → Solution → Implement. NO CODE before Phase 4. |
-| `ask` | none | Answer only — no implementation |
-| `edit` | `orchestrator` | Execute. Check `{task-slug}.md` first if multi-file. |
+|`plan`|`project-planner`|4-phase: Analyze → Plan → Solution → Implement. NO CODE before Phase 4.|
+|`ask`|none|Answer only — no implementation|
+|`edit`|`orchestrator`|Execute. Check `{task-slug}.md` first if multi-file.|
 
 **Plan Mode phases:**
 1. Analyze → research and questions
@@ -273,12 +273,12 @@ AI agents have a finite context window. Poorly managed context causes truncation
 
 **Context discipline by task type:**
 
-| Task Type | Attach | Never Attach |
+|Task Type|Attach|Never Attach|
 |---|---|---|
-| Bug fix in one function | That function + its callers | Entire file |
-| Schema migration | Schema file + migration history | Unrelated models |
-| Orchestrator dispatch | context_summary per worker | Full conversation |
-| Code review | File under review | Project-wide context |
+|Bug fix in one function|That function + its callers|Entire file|
+|Schema migration|Schema file + migration history|Unrelated models|
+|Orchestrator dispatch|context_summary per worker|Full conversation|
+|Code review|File under review|Project-wide context|
 
 ---
 

package/.agent/scripts/append_flow.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+// append_flow.js — append Supreme Court section to AGENT_FLOW.md
+const fs = require('fs');
+const f  = 'AGENT_FLOW.md';
+
+const appendix = [
+  '',
+  '---',
+  '',
+  '## Supreme Court Edition — Self-Learning Engine',
+  '',
+  'Tribunal Kit v4.0+ ships two industry-first features that transform the',
+  'agent kit from a reactive reviewer into a **persistent engineering authority**.',
+  '',
+  '### 1 — Case Law Engine',
+  '',
+  'Every rejected pattern becomes binding legal precedent.',
+  '',
+  '| Step | What Happens |',
+  '|:-----|:-------------|',
+  '| 1 | Developer rejects AI proposal |',
+  '| 2 | Runs `case_law_manager.py add-case` |',
+  '| 3 | diff + tags + reason stored in `.agent/history/case-law/` |',
+  '| 4 | `precedence-reviewer` queries index on every future `/generate` or `/review` |',
+  '| 5 | Jaccard tag match score >= 0.4 → PRECEDENCE HOLD |',
+  '',
+  '### 2 — Skill Evolution Forge',
+  '',
+  'The agent kit writes its own skills by learning from your commits.',
+  '',
+  '| Step | What Happens |',
+  '|:-----|:-------------|',
+  '| 1 | Developer commits code different from AI proposal |',
+  '| 2 | `tribunal-kit learn` (or `skill_evolution.py digest`) |',
+  '| 3 | Semantic Delta Filter strips trivial noise (70-90% token reduction) |',
+  '| 4 | Minimal LLM Reflection Prompt (< 500 tokens) |',
+  '| 5 | YAML idioms merged into `.agent/skills/project-idioms/SKILL.md` |',
+  '| 6 | All agents inherit these idioms on next activation |',
+  '',
+  '### CLI Commands (Supreme Court)',
+  '',
+  '| Command | Action |',
+  '|:--------|:-------|',
+  '| `tribunal-kit learn` | Run Skill Evolution + Case Law prompt |',
+  '| `tribunal-kit learn --dry-run` | Preview delta without writing |',
+  '| `tribunal-kit learn --head` | Diff last commit instead of staged |',
+  '| `python .agent/scripts/case_law_manager.py add-case` | Record a rejection |',
+  '| `python .agent/scripts/case_law_manager.py search-cases --query "..."` | Find precedents |',
+  '| `python .agent/scripts/skill_evolution.py digest` | Run evolution cycle |',
+  '| `python .agent/scripts/skill_evolution.py status` | Token savings report |',
+  '',
+  '### Review Order (Updated)',
+  '',
+  '```',
+  '1. precedence-reviewer   <- FIRST (Case Law check, zero LLM tokens)',
+  '2. logic-reviewer',
+  '3. security-auditor',
+  '4. domain-specific reviewers',
+  '5. Human Gate',
+  '```',
+  '',
+  '### New Reviewer',
+  '',
+  '| Reviewer | Activates for | Catches |',
+  '|:---------|:-------------|:--------|',
+  '| `precedence-reviewer` | All domains | Violations of previously rejected patterns |',
+  '',
+].join('\n');
+
+let existing = fs.readFileSync(f, 'utf8').trimEnd();
+fs.writeFileSync(f, existing + appendix + '\n', 'utf8');
+console.log('AGENT_FLOW.md updated.');