coordination-verb-broker-migration

name	coordination-verb-broker-migration
description	Audit whether an enforced-coordination MCP has actually shrunk its ~19 legacy etiquette verbs into the 5 enforced tools — work/act/ask/recall/status — each carrying one denial shape and one transcript event, migrated through a real retirement path (intake-metadata, alias, or doc-history — never a parallel runtime), with zero legacy-verb calls once a body reaches compliance mode C4+. Use when reviewing a broker-collapse migration plan, gating a body's move from advisory (C0-C3) to enforced (C4+) coordination, or verifying IT-018 Broker Collapse compliance. NOT for the inbound trigger→spawn boundary that decides whether an event may spawn an agent at all (use fleet-event-spawn-trust), the capability-token cryptographic mechanism behind a denial (use agentic-zero-trust-security), designing how a swarm of agents invokes and shards work (use swarm-invocation-designer), or auditing an individual PR's mergeability (use agent-pr-authoring).
license	Apache-2.0
allowed-tools	Read,Write,Edit,Bash,Grep,Glob
metadata	{"category":"Agent & Orchestration","tags":["broker-collapse","verb-migration","coordination-mcp","compliance-gate","legacy-etiquette-verbs"],"provenance":{"kind":"first-party","owners":["port-daddy"]},"pairs-with":[{"skill":"fleet-event-spawn-trust","reason":"fleet-event-spawn-trust guards whether an inbound event may spawn an agent at all; this skill audits the enforced tool surface that call lands on once coordination is turned on."},{"skill":"agentic-zero-trust-security","reason":"This skill only checks that every broker tool DECLARES a denial shape and a transcript event; agentic-zero-trust-security supplies the cryptographic capability mechanism that actually backs the denial."},{"skill":"swarm-invocation-designer","reason":"swarm-invocation-designer decides how agents summon each other and shard work; this skill audits the etiquette-verb surface those invocations call through once coordination is enforced."},{"skill":"articles-of-agreement-auditor","reason":"The 5 broker tools are how agents exercise the tool-use and reporting clauses of the Articles contract that skill audits."}],"io-contract":{"kind":"deliverable","consumes":["[Truncated]","[Truncated]"],"produces":["[Truncated]","[Truncated]"]}}

Coordination Verb Broker Migration

Audit whether an enforced-coordination MCP has really shrunk — not grown — its legacy etiquette verbs into the 5 enforced tools, with a real migration path and a hard compliance gate.

Use This For

• Reviewing a broker-collapse migration plan before it ships, confirming every legacy verb maps to exactly one of work/act/ask/recall/status.
• Verifying each of the 5 enforced tools carries one denial shape and one transcript event before advisory bodies are asked to depend on it.
• Gating a body's promotion from advisory coordination (C0-C3) to enforced coordination (C4+) against the IT-018 Broker Collapse requirement of zero legacy-verb calls.
• Catching a "parallel runtime truth" migration — a legacy verb kept alive as a second live code path instead of being retired to metadata, an alias, or documented history.
• Producing a deterministic pass/fail signal for CI or a governance review, not a prose opinion about how the migration "feels."

Do Not Use This For

• Deciding whether an inbound event should be allowed to spawn an agent at all (fleet-event-spawn-trust).
• Specifying the cryptographic mechanism (signed capability token, macaroon, etc.) behind a broker tool's denial (agentic-zero-trust-security).
• Designing how agents discover and invoke each other or shard work across a swarm (swarm-invocation-designer).

Collapse Gate

flowchart TD
  A[Enumerate every legacy etiquette verb] --> B{mappedTo one of work/act/ask/recall/status?}
  B -->|null or unrecognized| C[verb-unmapped: FAIL]
  B -->|yes| D{migrationPath is intake-metadata, alias, or doc-history?}
  D -->|anything else, incl. parallel-runtime| E[parallel-runtime-migration: FAIL]
  D -->|yes| F{Broker tool surface is exactly the 5?}
  F -->|extra tool| G[broker-grew: FAIL]
  F -->|missing tool| G2[broker-tool-missing: FAIL]
  F -->|exactly the 5| H{Every tool has denialShape AND transcriptEvent?}
  H -->|no| I[broker-tool-no-denial-or-transcript: FAIL]
  H -->|yes| J{complianceMode is C4 or above?}
  J -->|yes, and emitsLegacyVerbCalls| K[c4plus-emits-legacy-verbs: FAIL]
  J -->|no, or yes with zero legacy calls| L[PASS: broker has actually shrunk]

1. Enumerate the full legacy-verb inventory. The documented collapse expects ~19 verbs; reconcile the spec's legacyVerbs list against that inventory before trusting anything downstream.