router-contract

Router Contract (CC-Teams)

Purpose

The Router Contract is a machine-readable YAML block output by every teammate at the end of their work. The lead uses it to:

• Validate teammate output quality
• Decide whether to proceed or block
• Collect memory notes for persistence
• Resolve conflicts between teammates

---

Contract Format (REQUIRED)

Every teammate MUST include this section at the end of their output:

### Router Contract (MACHINE-READABLE)
```yaml
CONTRACT_VERSION: "2.5"
STATUS: [value from agent-specific list below]
CONFIDENCE: [0-100]
CRITICAL_ISSUES: [count]
HIGH_ISSUES: [count]
BLOCKING: [true|false]
REQUIRES_REMEDIATION: [true|false]
REMEDIATION_REASON: [null or description of what needs fixing]
SPEC_COMPLIANCE: [PASS|FAIL|N/A]
TRACEABILITY_IMPACT: [none|risk_detected|conflict_detected]   # reviewers + hunter + live-reviewer
REQUIREMENTS_AT_RISK: [list or empty]                         # reviewers + hunter + live-reviewer
ACCEPTANCE_CRITERIA_AT_RISK: [list or empty]                  # reviewers + hunter + live-reviewer
DECISION_DEPENDENCIES_AT_RISK: [list or empty]                # reviewers + hunter + live-reviewer
# v2.5 additions (agent-specific — include only for relevant roles):
PHASE_ID: "[phase id or ad-hoc-scope]"         # builder family
PHASE_STATUS: [completed|partial|blocked]      # builder family
PHASE_EXIT_READY: [true|false]                 # builder family
CHECKPOINT_TYPE: [none|human_verify|decision|human_action]  # builder family
PROOF_STATUS: [passed|gaps_found|human_needed] # builder family + verifier
INPUTS: [list or empty]                        # builder family
EXPECTED_ARTIFACTS: [list or empty]            # builder family
REQUIREMENT_IDS_IN_SCOPE: [list or empty]      # builder family
ACCEPTANCE_CRITERIA_IN_SCOPE: [list or empty]  # builder family
APPROVED_DECISION_DEPENDENCIES: [list or empty] # builder family
REQUIREMENTS_SATISFIED: [list or empty]        # builder family
ACCEPTANCE_CRITERIA_SATISFIED: [list or empty] # builder family
DECISION_DEPENDENCIES_SATISFIED: [list or empty] # builder family
TDD_RED_EXIT: [1|null]                         # builder family
TDD_GREEN_EXIT: [0|null]                      # builder family
PHASE_GATE_RESULT: [PASS|FAIL|N/A]            # builder family
PHASE_GATE_CMD: ["gate command or N/A"]       # builder family
SCENARIOS:                                    # builder family
  - name: "[scenario name]"
    given: "[state]"
    when: "[action]"
    then: "[result]"
    command: "[exact command]"
    expected: "[expected result]"
    actual: "[actual result]"
    exit_code: [code]
    status: [PASS|FAIL|BLOCKED]
ASSUMPTIONS: [list or empty]                  # builder family
DECISIONS: [list or empty]                    # builder family
BLOCKED_ITEMS: [list or empty]                # builder family
SKIPPED_ITEMS: [list or empty]                # builder family
SCOPE_INCREASES: [list or empty]              # builder family
PLAN_MODE: [direct|execution_plan|decision_rfc]    # planner only
VERIFICATION_RIGOR: [standard|critical_path]       # planner only
OPEN_DECISIONS: [list or empty]                    # planner only
RECOMMENDED_DEFAULTS: [list or empty]              # planner only
CONTRADICTIONS_FOUND: [count]                      # planner only
REQUIREMENT_PHASE_COVERAGE: [complete|gaps_found]  # planner only
ACCEPTANCE_PROOF_COVERAGE: [complete|gaps_found]   # planner only
FINDING_BUCKETS:                                   # plan-gap-reviewer only
  repo_mismatches: [count]
  missing_surfaces: [count]
  execution_order_issues: [count]
  hidden_assumptions: [count]
  under_scoped_integrations: [count]
  open_decisions_presented_as_settled: [count]
  requirement_conflicts: [count]
  traceability_gaps: [count]
REPLAN_NEEDED: [true|false]                        # plan-gap-reviewer only
REPLAN_REASON: [reason or "None"]                  # plan-gap-reviewer only
DEPENDENCY_AUDIT: [PASS|WARN|FAIL|SKIPPED]  # verifier + security-reviewer
DEPENDENCY_AUDIT_DETAIL: ["detail or N/A"]  # verifier only
SCENARIOS_FAILED: [count]                       # verifier only
PROOF_RECONCILIATION:                           # verifier only
  truths: [verified|missing|human_needed]
  artifacts: [verified|missing|human_needed]
  wiring: [verified|missing|human_needed]
SCENARIO_EVIDENCE:                              # verifier only
  - name: "[scenario]"
    command: "[command]"
    expected: "[expected]"
    actual: "[actual]"
    exit: [code]
    result: [PASS|FAIL|BLOCKED]
TRACEABILITY_STATUS: [verified|gaps_found|human_needed]  # verifier only
REQUIREMENTS_VERIFIED: [list or empty]                   # verifier only
ACCEPTANCE_CRITERIA_VERIFIED: [list or empty]            # verifier only
DECISION_DEPENDENCIES_CHECKED: [list or empty]           # verifier only
TRACEABILITY_GAPS: [list or empty]                       # verifier only
STATE_DELTA:
  what_changed: [list or empty]
  remains_open: [list or empty]
  should_stay_closed: [list or empty]
  next_trigger: "[next required action or None]"
TIMESTAMP: [ISO 8601 timestamp]
AGENT_ID: [teammate name, e.g., "investigator-1"]
FILES_MODIFIED: [list of files changed, or empty]
CLAIMED_ARTIFACTS: [durable files claimed as created/updated by this teammate, or empty]
EVIDENCE_COMMANDS: ["command => exit <code>", "..."]
DEVIATIONS_FROM_PLAN: [null or description of what changed from plan]
MEMORY_NOTES:
  learnings: ["insight 1", "insight 2"]
  patterns: ["pattern or gotcha discovered"]
  verification: ["evidence of what was verified"]
```