swarm-governance: Native /swarm Execution Modifier¶
Use swarm-governance whenever running a multi-agent team on Antigravity native /swarm. It is an Execution Modifier that pairs with any Task Spec (pr-review, full-review, self-diagnosis, or opt-in flat day-one-review) to add scoped file boundaries, tiny receipts, dual-verdict integrity checks, and clean teardown on top of Antigravity's native board.
- Source specification:
.agents/skills/swarm-governance/SKILL.md - References:
intake-and-planning.md,bundling-and-wire-format.md,large-swarms.md,ecosystem-and-modifiers.md - Canonical role map & closure gate: Roles, skill workflows, and runtime closure
Workflow stages¶
- Step 0: Neutral pre-flight intake (
Coordinator): Ask once viaask_questionwhenever any of four settings are unspecified: Topology (Flatvs.Layered, zero default bias), Workspace Isolation (inherit,share, orbranch), Evidence Retention (--keep-reportsvs. prune/teardown), and Model (defaults to the coordinator's active model unless specified). - Stage 1: Plan, launch & park (
Coordinator->Specialists+ optionalmonitor/narrator): Callsquad_planner(oragy-squad plan) to compileswarmAddpayloads, check writablescopeFilesoverlaps, pin models, and emitprovenanceScaffold+bundleRecordTemplates. Spawn workers viaswarm{action: "add"}, verify active model IDs viaswarm{action: "status"}, deferopen_boardtonative_swarmon the launch turn, and park quiet turns withswarm_wait(noschedulepolling timers). - Stage 2: Slot reports, content gate & flat integrity audit: Each specialist writes evidence to
scratch/agy-squad/squad-<id>/specialist-<N>/report.mdand posts one single-line<= 500UTF-8 byte pointer (@lead READY ...) on the board. The lead or coordinator collects isolated slots (agy-squad collect), scopes board reads withread_board{since|seqs}, verifies cited files/tests, writeslead/report.md(Content Verdict: PASS | FAIL | BLOCKED), and runsagy-squad verdict+bundle-init --digest. An independent flataudit-<id>worker audits execution traces ([agy-transcript-access: allow]on leads/auditors,denyon leaf specialists) to emitTarget Squad,Evidence Digest: <64-hex>, andIntegrity Verdict: CLEAN | INTEGRITY VIOLATION. - Stage 3: Bundle, continue, or close: Run
agy-squad verdict --integrityandagy-squad finalize <record.json> [--prune [--keep-reports]](or granularbundle,verify,prune). Post[done] <summary>(no@) before pausing with waiting workers or closing somonitor's*/3cron cancels cleanly, then kill all workers plusmonitor(swarm{action: "kill"}) and complete the four-check runtime closure gate.