@sienklogic/plan-build-run 2.19.0 → 2.19.1

package/plugins/cursor-pbr/hooks/hooks.json

@@ -1,213 +0,0 @@
-{
-  "$schema": "../../pbr/scripts/hooks-schema.json",
-  "description": "Plan-Build-Run workflow hooks for Cursor plugin — delegates to shared scripts in plugins/pbr/scripts/",
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" progress-tracker.js",
-            "statusMessage": "Loading project state..."
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" post-write-dispatch.js",
-            "statusMessage": "Validating write output..."
-          }
-        ]
-      },
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" post-write-quality.js",
-            "statusMessage": "Running quality checks..."
-          }
-        ]
-      },
-      {
-        "matcher": "Task",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" check-subagent-output.js",
-            "statusMessage": "Validating agent output..."
-          }
-        ]
-      },
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" suggest-compact.js",
-            "statusMessage": "Checking context budget..."
-          }
-        ]
-      },
-      {
-        "matcher": "Read",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" track-context-budget.js",
-            "statusMessage": "Tracking context budget..."
-          }
-        ]
-      }
-    ],
-    "PostToolUseFailure": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" log-tool-failure.js",
-            "statusMessage": "Logging tool failure..."
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" pre-bash-dispatch.js",
-            "statusMessage": "Validating Bash command..."
-          }
-        ]
-      },
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" pre-write-dispatch.js",
-            "statusMessage": "Checking write rules..."
-          }
-        ]
-      },
-      {
-        "matcher": "Task",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" validate-task.js",
-            "statusMessage": "Validating Task() call..."
-          }
-        ]
-      },
-      {
-        "matcher": "Skill",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" validate-skill-args.js",
-            "statusMessage": "Validating skill arguments..."
-          }
-        ]
-      },
-      {
-        "matcher": "EnterPlanMode",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" intercept-plan-mode.js",
-            "statusMessage": "Checking plan mode compatibility..."
-          }
-        ]
-      }
-    ],
-    "PreCompact": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" context-budget-check.js",
-            "statusMessage": "Preserving state before compaction..."
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" auto-continue.js",
-            "statusMessage": "Checking for auto-continue..."
-          }
-        ]
-      }
-    ],
-    "SubagentStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" log-subagent.js start",
-            "statusMessage": "Logging agent spawn..."
-          }
-        ]
-      }
-    ],
-    "SubagentStop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" log-subagent.js stop",
-            "statusMessage": "Logging agent completion...",
-            "async": true,
-            "timeout": 30
-          }
-        ]
-      },
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" event-handler.js",
-            "statusMessage": "Checking for auto-verification...",
-            "async": true,
-            "timeout": 10
-          }
-        ]
-      }
-    ],
-    "TaskCompleted": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" task-completed.js",
-            "statusMessage": "Processing task completion..."
-          }
-        ]
-      }
-    ],
-    "SessionEnd": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" session-cleanup.js",
-            "statusMessage": "Cleaning up session...",
-            "async": true,
-            "timeout": 30
-          }
-        ]
-      }
-    ]
-  }
-}

package/plugins/cursor-pbr/references/agent-anti-patterns.md

@@ -1,25 +0,0 @@
-<!-- canonical: ../../pbr/references/agent-anti-patterns.md -->
-# Universal Agent Anti-Patterns
-
-These anti-patterns apply to ALL Plan-Build-Run agents. Each agent also has role-specific anti-patterns defined in its own agent file.
-
-## Evidence and Verification
-
-1. **DO NOT** guess, assume, or rely on cached knowledge when codebase evidence is available. Read the actual files.
-2. **DO NOT** trust claims in SUMMARY.md, PLAN.md, or other agent outputs without verifying against the real codebase.
-3. **DO NOT** use subjective or vague language ("seems okay", "looks fine", "probably works"). Be specific and evidence-based.
-4. **DO NOT** present training knowledge as verified fact. Flag unverified claims explicitly.
-
-## Scope and Boundaries
-
-5. **DO NOT** exceed your role. If a task belongs to another agent, stop and recommend the correct agent.
-6. **DO NOT** modify files outside your designated scope. Read-only agents must not attempt fixes. Executors must not modify plans.
-7. **DO NOT** add features, ideas, or scope not requested. Log scope creep to deferred items instead.
-8. **DO NOT** skip steps in your verification or execution protocol, even for "obvious" cases.
-
-## Context and State
-
-9. **DO NOT** contradict locked decisions in CONTEXT.md. These are non-negotiable.
-10. **DO NOT** implement deferred ideas from CONTEXT.md. They do not exist for your purposes.
-11. **DO NOT** consume more than 50% of your context window before producing output. Write incrementally.
-12. **DO NOT** read agent definition files from `agents/*.md`. Agent definitions are auto-loaded by Claude Code via `subagent_type`. Reading them wastes context.

package/plugins/cursor-pbr/references/agent-contracts.md

@@ -1,297 +0,0 @@
-# Agent Contracts
-
-Input/output schemas for agent-to-agent handoffs in Plan-Build-Run.
-
-Each contract defines: the file exchanged, required frontmatter fields, body structure, and special handling notes. Agents MUST produce output matching these schemas — consumers depend on them.
-
----
-
-## Contract: Researcher -> Synthesizer
-
-**File**: `.planning/research/{topic-slug}.md` (project) or `.planning/phases/{NN}-{slug}/RESEARCH.md` (phase)
-**Direction**: Researcher writes, Synthesizer reads 2-4 of these
-
-### Required Frontmatter
-
-```yaml
----
-confidence: high|medium|low
-sources_checked: N        # integer count of sources consulted
-coverage: "complete|partial|minimal"
----
-```
-
-### Required Body Sections
-
-- `## Key Findings` — each finding tagged with source level (`[S1]`..`[S6]`) and confidence
-- `## Gaps` — areas not covered and why
-- `## Sources` — source list with what each provided
-
-### Special Handling
-
-- Every factual claim must have a source attribution tag
-- Version-sensitive info (API signatures, config syntax) must come from S1-S3 sources
-- `[SPECULATIVE]` tag marks unverified reasoning — synthesizer must not upgrade confidence
-
----
-
-## Contract: Synthesizer -> Planner
-
-**File**: `.planning/research/SUMMARY.md` (or specified path)
-**Direction**: Synthesizer writes, Planner reads
-
-### Required Frontmatter
-
-```yaml
----
-confidence: high|medium|low
-sources: N                # integer count of input documents
-conflicts: N              # integer count of contradictions found
----
-```
-
-### Required Body Sections
-
-- `## Resolved Decisions` — table with Topic, Decision, Confidence, Sources columns
-- `## Open Questions` — items marked `[NEEDS DECISION]` for planner to handle
-- `## Deferred Ideas` — items out of scope
-
-### Special Handling
-
-- `[NEEDS DECISION]` flags: planner creates `checkpoint:decision` tasks OR decides within discretion scope
-- Confidence levels never upgraded beyond what input documents support
-- Contradictions always documented, never silently dropped
-
----
-
-## Contract: Planner -> Executor
-
-**File**: `.planning/phases/{NN}-{slug}/PLAN-{NN}.md`
-**Direction**: Planner writes, Executor reads and executes sequentially
-
-### Required Frontmatter
-
-```yaml
----
-phase: "{phase-slug}"
-plan: "{NN-MM}"
-wave: N
-depends_on: []
-files_modified: ["{path}"]
-must_haves:
-  truths: ["{observable condition}"]
-  artifacts: ["{file: description}"]
-  key_links: ["{connection description}"]
-provides: ["{exported item}"]
-consumes: ["{required item}"]
-requirement_ids: []
----
-```
-
-### Required Body: XML Tasks (each task needs all 5 elements)
-
-```xml
-<task id="{plan}-T{n}" type="{type}" tdd="{bool}" complexity="{simple|medium|complex}">
-<name>{imperative verb phrase}</name>
-<files>{file paths, one per line}</files>
-<action>{numbered steps}</action>
-<verify>{executable shell command}</verify>
-<done>{observable outcome}</done>
-</task>
-```
-
-### Special Handling
-
-- Task types: `auto`, `tdd`, `checkpoint:human-verify`, `checkpoint:decision`, `checkpoint:human-action`
-- Complexity drives model selection: simple=haiku, medium=sonnet, complex=inherit
-- Executor stages ONLY files listed in `<files>` per task
-- Plans end with a `## Summary` section (plan ID, task list, key files, must-haves, provides/consumes)
-
----
-
-## Contract: Planner -> Plan-Checker
-
-**File**: Same `PLAN-{NN}.md` files (read-only)
-**Direction**: Planner writes, Plan-Checker reads and returns text assessment
-**Returns**: Inline text report (no file output)
-
-### Expected Input
-
-Plan-Checker reads plan frontmatter + XML tasks and evaluates across 10 dimensions (D1-D10). Optionally receives CONTEXT.md path.
-
-### Output Format
-
-```
-VERIFICATION PASSED | ISSUES FOUND
-Plans: N | Tasks: N | Blockers: N | Warnings: N | Info: N
-
-## Blockers
-- [{plan_id}] D{N} {severity}: {description} -> Fix: {hint}
-```
-
-### Special Handling
-
-- Blockers must be fixed before execution; warnings are advisory
-- Plan-Checker never modifies plans — only reports issues
-- Planner enters Revision Mode to address feedback
-
----
-
-## Contract: Executor -> Verifier
-
-**File**: `.planning/phases/{NN}-{slug}/SUMMARY-{plan_id}.md`
-**Direction**: Executor writes after completing plan tasks, Verifier reads
-
-### Required Frontmatter
-
-```yaml
----
-plan: "{plan_id}"
-status: complete|partial|checkpoint
-commits: ["{sha1}", "{sha2}"]
-provides: ["{exported item}"]
-must_haves:
-  - "{must-have description}: DONE|PARTIAL|SKIPPED"
----
-```
-
-### Required Body Sections
-
-- `## Task Results` — table with Task, Status, Notes columns
-- `## Deviations` — list of deviations from plan, or "None"
-
-### Special Handling
-
-- Verifier does NOT trust SUMMARY.md claims — verifies against actual codebase
-- Verifier checks must-haves from PLAN.md frontmatter, not SUMMARY.md self-reports
-- One SUMMARY per plan execution; status reflects final state
-
----
-
-## Contract: Verifier -> Planner (Gap Closure)
-
-**File**: `.planning/phases/{NN}-{slug}/VERIFICATION.md`
-**Direction**: Verifier writes, Planner reads to create gap-closure plans
-
-### Required Frontmatter
-
-```yaml
----
-status: passed|gaps_found|human_needed
-attempt: N
-must_haves_total: N
-must_haves_passed: M
-gaps: ["gap description"]
-overrides: []
----
-```
-
-### Required Body Sections
-
-- `## Must-Have Verification` — table with #, Must-Have, Status, Evidence columns
-- `## Gaps` — per-gap detail with Evidence and Suggested fix
-
-### Special Handling
-
-- `gaps_found` triggers Planner Gap Closure Mode — planner creates targeted fix plans
-- `overrides` list: must-haves marked as override by user, counted as passed
-- Re-verification increments `attempt` counter; checks regressions on previously-passed items
-- Verifier has Write access ONLY for VERIFICATION.md — cannot fix source code
-
----
-
-## Contract: Integration-Checker -> Planner
-
-**File**: `.planning/phases/{NN}-{slug}/INTEGRATION-REPORT.md`
-**Direction**: Integration-Checker writes, Planner reads for cross-phase fixes
-
-### Required Frontmatter
-
-```yaml
----
-status: passed|issues_found
-checks_total: N
-checks_passed: M
-critical_issues: K
----
-```
-
-### Required Body Sections
-
-- `## Integration Checks` — table with Check, Status, Evidence columns
-- `## E2E Flows` — table with Flow, Status, Broken Link columns
-- `## Critical Issues` — detailed issue descriptions
-
-### Special Handling
-
-- Checks ACROSS phases (unlike Verifier which checks single phase)
-- 5 check categories: Export/Import Wiring, API Route Coverage, Auth Protection, E2E Flows, Cross-Phase Dependencies
-- Integration-Checker has Write access ONLY for INTEGRATION-REPORT.md — cannot fix source code
-
----
-
-## Contract: Debugger (Self-Contained)
-
-**File**: `.planning/debug/{slug}.md`
-**Direction**: Debugger creates, updates, and resolves within a single session
-
-### Required Frontmatter
-
-```yaml
----
-slug: "{slug}"
-status: "gathering|investigating|fixing|verifying|resolved"
-created: "{ISO-8601}"
-updated: "{ISO-8601}"
-mode: "find_and_fix|find_root_cause_only"
----
-```
-
-### Required Body Sections
-
-- `## Current Focus` — Hypothesis, Test, Expecting, Disconfirm, Next action
-- `## Symptoms` — IMMUTABLE after gathering phase
-- `## Hypotheses` — Active (unchecked) and Eliminated (checked, append-only)
-- `## Evidence Log` — append-only timestamped entries
-- `## Resolution` — root cause, mechanism, fix, commit hash (when resolved)
-
-### Special Handling
-
-- Status transitions: `gathering -> investigating -> fixing -> verifying -> resolved`
-- Symptoms and Evidence Log are append-only / immutable — prevents mutation bias
-- Fix commits use format: `fix({scope}): {description}` with root cause in body
-- May emit checkpoints (`HUMAN-VERIFY`, `HUMAN-ACTION`, `DECISION`) for user input
-
----
-
-## Contract: Codebase-Mapper (Self-Contained)
-
-**Files**: `.planning/codebase/{STACK,ARCHITECTURE,CONVENTIONS,CONCERNS}.md` (varies by focus)
-**Direction**: Codebase-Mapper writes, consumed by Researcher (as S0 local prior) and Planner
-
-### Focus Areas and Outputs
-
-| Focus | Output Files |
-|-------|-------------|
-| `tech` | STACK.md, INTEGRATIONS.md |
-| `arch` | ARCHITECTURE.md, STRUCTURE.md |
-| `quality` | CONVENTIONS.md, TESTING.md |
-| `concerns` | CONCERNS.md |
-
-### Fallback Frontmatter (per file)
-
-No YAML frontmatter required — these are reference documents with markdown tables.
-
-### Required Body Structure (minimum per file)
-
-- **STACK.md**: `## Tech Stack` table (Category, Technology, Version, Config File) + `## Package Manager`
-- **ARCHITECTURE.md**: `## Architecture Overview` (pattern name) + `## Key Components` table + `## Data Flow`
-- **CONVENTIONS.md**: `## Code Conventions` table (Convention, Pattern, Example File) + `## Naming Patterns`
-- **CONCERNS.md**: `## Concerns` table (Severity, Area, Description, File) + `## Security Considerations`
-
-### Special Handling
-
-- Every claim must reference actual file paths — no vague references
-- Codebase-Mapper does NOT commit — the orchestrator handles commits
-- Researcher treats these as S0 (highest confidence) local prior research
-- One focus area per invocation

package/plugins/cursor-pbr/references/agent-interactions.md

@@ -1,135 +0,0 @@
-<!-- canonical: ../../pbr/references/agent-interactions.md -->
-# Agent Interaction Map
-
-This document shows how Plan-Build-Run agents communicate through files on disk. Agents never message each other directly -- they read and write shared files in `.planning/`.
-
-## Interaction Graph
-
-```
-                    User / Orchestrator
-                     |           ^
-                     v           |
-              +--------------+   |
-              |  researcher  |---+---> planner
-              +--------------+         |    ^
-                     |                 v    |
-              +--------------+   +--------------+
-              | synthesizer  |   | plan-checker |
-              +--------------+   +--------------+
-                                       |
-                                       v
-                                 +-----------+
-                                 |  executor  |
-                                 +-----------+
-                                       |
-                                       v
-                                 +-----------+
-                                 |  verifier  |----> planner (gap closure)
-                                 +-----------+
-                                       |
-                                       v
-                              +--------------------+
-                              | integration-checker|
-                              +--------------------+
-```
-
-## Per-Agent Interaction Details
-
-### researcher
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | User/Orchestrator | Research topics, CONTEXT.md constraints, phase goals |
-| Produces for | planner | Research documents with technology details and recommendations |
-| Produces for | synthesizer | Research documents to be combined |
-| Produces for | User | Direct reading for decision-making |
-
-### synthesizer
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | researcher | Research documents to synthesize |
-| Receives from | Orchestrator | Paths to research documents, synthesis request |
-| Produces for | planner | SUMMARY.md as consolidated research input for planning |
-| Produces for | User | High-level project/phase research overview |
-
-### planner
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | researcher | Research documents with technology details and recommendations |
-| Receives from | plan-checker | Issue reports requiring plan revision |
-| Receives from | verifier | VERIFICATION.md reports requiring gap closure plans |
-| Receives from | User/Orchestrator | Phase goals, CONTEXT.md, planning requests |
-| Produces for | plan-checker | Plan files for quality verification |
-| Produces for | executor | Plan files for execution |
-| Produces for | verifier | Must-have definitions for verification (embedded in plan frontmatter) |
-
-### plan-checker
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | Orchestrator/User | Plan files to check, phase context |
-| Receives from | planner | Newly created or revised plan files |
-| Produces for | planner | Issue reports for revision |
-| Produces for | Orchestrator/User | Pass/fail decision on plan quality |
-
-### executor
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | Orchestrator | Plan files to execute, continuation instructions |
-| Receives from | planner | The plans themselves (indirectly, via files) |
-| Produces for | verifier | SUMMARY.md for verification, committed code for inspection |
-| Produces for | Orchestrator | Checkpoint responses, completion status |
-| Produces for | planner | Deferred ideas (in SUMMARY.md) for future planning |
-
-### verifier
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | Orchestrator | Phase to verify, timing trigger |
-| Receives from | executor | Completed work (via codebase and SUMMARY.md) |
-| Receives from | Previous VERIFICATION.md | Gaps to re-check (in re-verification mode) |
-| Produces for | planner | Gap list for gap-closure planning (via VERIFICATION.md) |
-| Produces for | Orchestrator | Phase status (passed/gaps_found/human_needed) |
-| Produces for | User | Human verification items with specific test instructions |
-
-### integration-checker
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | Orchestrator | Phases to check, trigger event (milestone/review) |
-| Receives from | verifier | Phase-level verification reports (for context on per-phase status) |
-| Produces for | planner | Integration gap list for cross-phase fix plans |
-| Produces for | Orchestrator | Integration status for milestone decisions |
-| Produces for | User | Integration health overview and security issues |
-
-### debugger
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | Orchestrator/User | Bug reports, symptoms, reproduction steps |
-| Receives from | executor | Errors encountered during execution (via checkpoint responses) |
-| Receives from | verifier | Issues discovered during verification |
-| Produces for | Orchestrator/User | Root cause analysis, fix commits, checkpoint requests |
-| Produces for | planner | Findings requiring architectural changes |
-| Produces for | executor | Simple fix instructions for executor to apply |
-
-### codebase-mapper
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | Orchestrator/User | Focus area to analyze, project path |
-| Receives from | researcher | May be invoked alongside researcher for new projects |
-| Produces for | planner | STACK.md, ARCHITECTURE.md, STRUCTURE.md for informed planning |
-| Produces for | executor | CONVENTIONS.md for code style, TESTING.md for test patterns |
-| Produces for | verifier | All documents as reference for what "correct" looks like |
-| Produces for | User | Direct reading for project understanding |
-
-### general
-
-| Direction | Agent/Role | What |
-|-----------|-----------|------|
-| Receives from | Orchestrator/User | Ad-hoc task instructions |
-| Produces for | Orchestrator/User | Task output (files, formatting, config changes) |