tribunal-kit 4.5.1 → 4.6.1

package/.agent/workflows/plan.md

@@ -1,173 +1,196 @@
----
-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.
----
-
-# /plan — Strategic Implementation Planning
-
-$ARGUMENTS
-
----
-
-## When to Use /plan
-
-|Use `/plan` when...|Skip plan and go to...|
-|:---|:---|
-|New feature with unclear scope|Simple, well-defined single file edit → just edit|
-|Multi-file change with dependencies|Generating a snippet → `/generate`|
-|Architecture decisions to make|Fixing a bug → `/debug`|
-|Risk needs to be assessed first|Adding to an existing feature → `/enhance`|
-|Stakeholder requirements → technical spec||
-
----
-
-## The Plan Contract: No Code Before Approval
-
-```
-The project-planner agent is the only agent active in /plan mode.
-It does NOT write code.
-It DOES read existing code to inform the plan.
-No other agents activate, no code is generated.
-```
-
----
-
-## Phase 1 — Socratic Gate (5 Questions)
-
-```
-1. GOAL: What specific outcome defines success? (not "add a feature" — a measurable outcome)
-2. USERS: Who exactly uses this? What do they currently do without this feature?
-3. SCOPE: What is explicitly OUT of scope for this version/sprint?
-4. RISK: What is the highest-risk assumption this plan rests on?
-5. STACK: Is the technology stack decided? Any constraints?
-```
-
-If any answer is "I don't know" → **ask before writing the plan document.**
-
----
-
-## Phase 2 — Research (Read Before Planning)
-
-```bash
-# What currently exists?
-ls -la src/      # Understand directory structure
-cat package.json # Understand actual dependencies
-cat tsconfig.json # Understand TypeScript config and path aliases
-git log --oneline -5 # Recent work context
-
-# Domain-specific reads:
-cat prisma/schema.prisma    # If DB changes planned
-cat src/middleware.ts        # If auth changes planned
-cat src/lib/auth.ts          # If auth changes planned
-```
-
----
-
-## Phase 3 — Wave Decomposition
-
-Plans execute in topological waves:
-
-```
-Wave 1 — Foundation (always first)
-├── Database schema changes (must precede all code)
-├── Shared types and Zod schemas (must precede callers)
-└── Auth/middleware changes (must precede protected routes)
-
-Wave 2 — Core Implementation
-├── API routes / Server Actions (depends on Wave 1 schema)
-├── Business logic layer
-└── Unit tests for Wave 1
-
-Wave 3 — Integration
-├── Frontend components (depends on Wave 2 API)
-├── Integration tests
-└── E2E tests for critical paths
-
-Wave 4 — Polish
-├── Performance optimization
-├── Accessibility audit
-└── Deploy prep
-```
-
----
-
-## Phase 4 — Implementation Plan Document
-
-```markdown
-# Implementation Plan: [Feature Name]
-
-## Goal
-[Single sentence: what is true when this is complete]
-
-## User Review Required
-> [!IMPORTANT]
-[Breaking changes, architectural choices needing approval]
-
-## Research Findings
-- [what currently exists that's relevant]
-- [constraints discovered]
-
-## Proposed Changes
-
-### Wave 1 — Foundation
-#### [MODIFY] prisma/schema.prisma
-[What changes and why]
-
-#### [NEW] src/lib/validators/newFeature.ts
-[What this creates]
-
-### Wave 2 — Core
-#### [NEW] src/app/api/new-feature/route.ts
-[What this creates]
-
-## Out of Scope (This Version)
-- [explicit exclusion]
-
-## Verification Plan
-- [ ] npx tsc --noEmit passes
-- [ ] npm test passes
-- [ ] [specific behavioral assertion]
-```
-
----
-
-## Human Gate — Mandatory Before Execution
-
-After the plan document is written:
-
-```
-━━━ Plan Ready for Review ━━━━━━━━━━━━━━━━━
-
-[summary of what will change across N files in N waves]
-
-Approve?
-Y = begin execution (proceed to /generate or /enhance)
-N = discard plan
-R = revise with feedback
-```
-
-**Zero code is written until "Y" is received.**
-
----
-
-## Anti-Pattern Guard
-
-```
-❌ Never write code during /plan mode
-❌ Never assume what the user wants — ask if unclear
-❌ Never plan without reading the existing codebase first
-❌ Never omit the Out of Scope section (it's how scope creep is prevented)
-❌ Never skip the Socratic Gate — even for "simple" features
-❌ Never write a plan that requires understanding unexplored files
-```
-
----
-
-## Usage Examples
-
-```
-/plan a user notification system with email + in-app notifications
-/plan migrate the authentication from next-auth v4 to v5
-/plan add Stripe subscription billing to the existing user model
-/plan refactor the monolithic api.ts into domain-specific route files
-/plan implement real-time collaborative editing using CRDTs
-```
+---
+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.
+required-skills: plan-writing, architecture
+---
+
+# /plan — Strategic Implementation Planning
+
+$ARGUMENTS
+
+---
+
+## $CONTEXT_REQUIRED
+
+```
+Read BEFORE writing the plan:
+□ package.json             → Actual dependencies and scripts
+□ tsconfig.json            → TypeScript config and path aliases
+□ prisma/schema.prisma     → If DB changes planned (skip if not applicable)
+□ src/ directory listing   → Current project structure
+□ git log --oneline -5     → Recent work context
+```
+
+---
+
+## When to Use /plan
+
+| Use `/plan` when...                       | Skip plan and go to...                            |
+| :---------------------------------------- | :------------------------------------------------ |
+| New feature with unclear scope            | Simple, well-defined single file edit → just edit |
+| Multi-file change with dependencies       | Generating a snippet → `/generate`                |
+| Architecture decisions to make            | Fixing a bug → `/debug`                           |
+| Risk needs to be assessed first           | Adding to an existing feature → `/enhance`        |
+| Stakeholder requirements → technical spec |                                                   |
+
+---
+
+## The Plan Contract: No Code Before Approval
+
+```
+The project-planner agent is the only agent active in /plan mode.
+It does NOT write code.
+It DOES read existing code to inform the plan.
+No other agents activate, no code is generated.
+```
+
+---
+
+## Phase 1 — Socratic Gate (5 Questions)
+
+```
+1. GOAL: What specific outcome defines success? (not "add a feature" — a measurable outcome)
+2. USERS: Who exactly uses this? What do they currently do without this feature?
+3. SCOPE: What is explicitly OUT of scope for this version/sprint?
+4. RISK: What is the highest-risk assumption this plan rests on?
+5. STACK: Is the technology stack decided? Any constraints?
+```
+
+If any answer is "I don't know" → **ask before writing the plan document.**
+
+---
+
+## Phase 2 — Research (Read Before Planning)
+
+```bash
+# What currently exists?
+ls -la src/      # Understand directory structure
+cat package.json # Understand actual dependencies
+cat tsconfig.json # Understand TypeScript config and path aliases
+git log --oneline -5 # Recent work context
+
+# Domain-specific reads:
+cat prisma/schema.prisma    # If DB changes planned
+cat src/middleware.ts        # If auth changes planned
+cat src/lib/auth.ts          # If auth changes planned
+```
+
+---
+
+## Phase 3 — Wave Decomposition
+
+Plans execute in topological waves:
+
+```
+Wave 1 — Foundation (always first)
+├── Database schema changes (must precede all code)
+├── Shared types and Zod schemas (must precede callers)
+└── Auth/middleware changes (must precede protected routes)
+
+Wave 2 — Core Implementation
+├── API routes / Server Actions (depends on Wave 1 schema)
+├── Business logic layer
+└── Unit tests for Wave 1
+
+Wave 3 — Integration
+├── Frontend components (depends on Wave 2 API)
+├── Integration tests
+└── E2E tests for critical paths
+
+Wave 4 — Polish
+├── Performance optimization
+├── Accessibility audit
+└── Deploy prep
+```
+
+---
+
+## Phase 4 — Implementation Plan Document
+
+```markdown
+# Implementation Plan: [Feature Name]
+
+## Goal
+
+[Single sentence: what is true when this is complete]
+
+## User Review Required
+
+> [!IMPORTANT]
+> [Breaking changes, architectural choices needing approval]
+
+## Research Findings
+
+- [what currently exists that's relevant]
+- [constraints discovered]
+
+## Proposed Changes
+
+### Wave 1 — Foundation
+
+#### [MODIFY] prisma/schema.prisma
+
+[What changes and why]
+
+#### [NEW] src/lib/validators/newFeature.ts
+
+[What this creates]
+
+### Wave 2 — Core
+
+#### [NEW] src/app/api/new-feature/route.ts
+
+[What this creates]
+
+## Out of Scope (This Version)
+
+- [explicit exclusion]
+
+## Verification Plan
+
+- [ ] npx tsc --noEmit passes
+- [ ] npm test passes
+- [ ] [specific behavioral assertion]
+```
+
+---
+
+## Human Gate — Mandatory Before Execution
+
+After the plan document is written:
+
+```
+━━━ Plan Ready for Review ━━━━━━━━━━━━━━━━━
+
+[summary of what will change across N files in N waves]
+
+Approve?
+Y = begin execution (proceed to /generate or /enhance)
+N = discard plan
+R = revise with feedback
+```
+
+**Zero code is written until "Y" is received.**
+
+---
+
+## Anti-Pattern Guard
+
+```
+❌ Never write code during /plan mode
+❌ Never assume what the user wants — ask if unclear
+❌ Never plan without reading the existing codebase first
+❌ Never omit the Out of Scope section (it's how scope creep is prevented)
+❌ Never skip the Socratic Gate — even for "simple" features
+❌ Never write a plan that requires understanding unexplored files
+```
+
+---
+
+## After /plan — Next Steps
+
+| Outcome                              | Next Command                             |
+| :----------------------------------- | :--------------------------------------- |
+| Plan approved, new code needed       | → `/generate` for Tribunal-reviewed code |
+| Plan approved, existing code changes | → `/enhance` with impact analysis        |
+| Plan approved, full project build    | → `/create` for full scaffolding         |
+| Plan needs more brainstorming        | → `/brainstorm` to explore options       |

package/.agent/workflows/preview.md

@@ -1,80 +1,103 @@
----
-description: Preview server start, stop, and status check. Local development server management. Uses auto_preview.py for automated lifecycle control. Shows current URL and hot-reload status.
----
-
-# /preview — Local Development Server
-
-$ARGUMENTS
-
----
-
-## Commands
-
-```
-/preview start    → Start the local dev server
-/preview stop     → Stop the local dev server
-/preview restart  → Restart the dev server (after config changes)
-/preview status   → Show current server status and URL
-```
-
----
-
-## Execution
-
-```bash
-# Start
-python .agent/scripts/auto_preview.py start
-
-# Stop
-python .agent/scripts/auto_preview.py stop
-
-# Restart
-python .agent/scripts/auto_preview.py restart
-
-# Status
-python .agent/scripts/auto_preview.py status
-```
-
----
-
-## Server Start Output
-
-```
-━━━ Dev Server Starting ━━━━━━━━━━━━━━━━━━
-
-Command:   npm run dev
-URL:       http://localhost:3000
-Status:    ✅ Running
-
-Hot reload: ✅ Enabled
-TypeScript: ✅ Type checking active
-```
-
----
-
-## Common Issues
-
-```
-Port 3000 in use:
-  → Kill: taskkill /F /IM node.exe  (Windows)
-  → OR:   lsof -i:3000 && kill -9 [PID]  (Mac/Linux)
-  → OR:   Run on different port: PORT=3001 npm run dev
-
-Build error on start:
-  → Run: npx tsc --noEmit to see TypeScript errors
-  → Fix errors first, then /preview start
-
-Config change not reflected:
-  → /preview restart (hot reload doesn't pick up next.config.js changes)
-```
-
----
-
-## When to Use /preview
-
-|Use `/preview` when...||
-|:---|:---|
-|After code generation to visually verify|Start: `/preview start`|
-|Config file was changed|Restart: `/preview restart`|
-|Done working for the session|Stop: `/preview stop`|
-|Checking if server is active|Status: `/preview status`|
+---
+description: Preview server start, stop, and status check. Local development server management. Uses auto_preview.py for automated lifecycle control. Shows current URL and hot-reload status.
+required-skills: bash-linux, frontend-specialist
+---
+
+# /preview — Local Development Server
+
+$ARGUMENTS
+
+---
+
+## $CONTEXT_REQUIRED
+
+```
+Read BEFORE managing preview:
+□ package.json                → Check dev script command and environment
+□ .env                        → Verify preview environment keys
+```
+
+---
+
+## Commands
+
+```
+/preview start    → Start the local dev server
+/preview stop     → Stop the local dev server
+/preview restart  → Restart the dev server (after config changes)
+/preview status   → Show current server status and URL
+```
+
+---
+
+## Execution
+
+```bash
+# Start
+python .agent/scripts/auto_preview.py start
+
+# Stop
+python .agent/scripts/auto_preview.py stop
+
+# Restart
+python .agent/scripts/auto_preview.py restart
+
+# Status
+python .agent/scripts/auto_preview.py status
+```
+
+---
+
+## Server Start Output
+
+```
+━━━ Dev Server Starting ━━━━━━━━━━━━━━━━━━
+
+Command:   npm run dev
+URL:       http://localhost:3000
+Status:    ✅ Running
+
+Hot reload: ✅ Enabled
+TypeScript: ✅ Type checking active
+```
+
+---
+
+## Common Issues
+
+```
+Port 3000 in use:
+  → Kill: taskkill /F /IM node.exe  (Windows)
+  → OR:   lsof -i:3000 && kill -9 [PID]  (Mac/Linux)
+  → OR:   Run on different port: PORT=3001 npm run dev
+
+Build error on start:
+  → Run: npx tsc --noEmit to see TypeScript errors
+  → Fix errors first, then /preview start
+
+Config change not reflected:
+  → /preview restart (hot reload doesn't pick up next.config.js changes)
+```
+
+---
+
+## When to Use /preview
+
+| Use `/preview` when...                   |                             |
+| :--------------------------------------- | :-------------------------- |
+| After code generation to visually verify | Start: `/preview start`     |
+| Config file was changed                  | Restart: `/preview restart` |
+| Done working for the session             | Stop: `/preview stop`       |
+| Checking if server is active             | Status: `/preview status`   |
+
+---
+
+## After /preview — Next Steps
+
+| Outcome               | Next Command                               |
+| :-------------------- | :----------------------------------------- |
+| Preview looks correct | → `/deploy` or commit code                 |
+| Preview shows errors  | → `/debug` to analyze console/network logs |
+| Changes not updating  | → `/preview restart` to bust cache         |
+
+---