agb plan
Compile an Antigravity brain plan or a Markdown spec into plan.json, behind the plan-boundary gates.
agb plan compiles a plan artifact into an executable plan.json. The first argument is an Antigravity brain id (or a unique prefix) or the path to a Markdown spec; the second is the target repository.
Synopsis
agb plan <id | spec.md> <repo>Compile an Antigravity brain plan or spec file into plan.json.
Pipeline: convert → validate → overlap/coldstart/parallax gates with feedback loop → advisory premortem.
| Flag | Argument | Description |
|---|---|---|
| --force | — | — |
| --no-coldstart | — | — |
| --no-parallax | — | — |
| --no-premortem | — | — |
| --out | <file> | — |
Flags
--out <file>sets the output path (defaultplan.json).--forceoverwrites an existing output file; without it the command exits 1 rather than replace a hand-written plan (C13).--no-coldstart,--no-parallaxand--no-premortemskip the corresponding gate (gate switches).
Gates
Compilation converts the artifact, validates it, then runs the scope-overlap, coldstart and parallax gates in a feedback loop. The premortem runs once on the surviving plan and is advisory: its risks are printed but never block (premortem is advisory, scope-overlap gate). See Plan boundary.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Plan written; the next step is printed (agb run <out>). |
| 1 | Usage error, existing output without --force, or quota telemetry unavailable. |
| 2 | Blocking findings: the plan was not compiled (blocking exit). |