What you get
your-project/├── docs/airgap/blueprint.json answers, tier, sizing, decisions├── docs/airgap/transfer-manifest.md images, models, packages and settings to carry in├── docs/airgap/blueprint.md the blueprint (under docs/superpowers/specs/ with superpowers)└── AGENTS.md instructions for the agent that builds it inside the networkThese files travel into the network together with the artifacts the manifest lists.
blueprint.json
Section titled “blueprint.json”The state of the design: the answers, the computed tier and sizing, and one decision per layer with its rationale, the alternatives considered and an evidence label. See blueprint.json.
The blueprint
Section titled “The blueprint”Written in the language of the interview, in ten sections:
- Context: organization shape and constraints.
- Tier, floors and overrides.
- Architecture overview with a component diagram.
- Layer decisions: choice, version, rationale, alternatives, evidence, caveats.
- Sizing: inputs, concurrency range, GPUs, servers, power, assumptions.
- Air-gap transfer plan.
- Data flow: request path and authentication path.
- Failure modes and operations, including offline upgrades.
- Verification plan: benchmarks to run and the list of
estimatedecisions. - Out of scope and later layers.
The transfer manifest
Section titled “The transfer manifest”The one list of what to carry in, written by manifest.py from the chosen components: container images for your hardware, model artifacts, packages, telemetry and other outbound calls to switch off before first start, files to stage that the software would otherwise download, per-tool skills worth carrying, and checksum and signature steps. Its header records a digest of the decisions, so lint notices when the manifest is older than the design. Carrying it in explains how it is used.
The block in AGENTS.md
Section titled “The block in AGENTS.md”A delimited block that tells the agent inside the network to follow the blueprint, use the pinned versions, assume there is no internet, and propose any new dependency as a blueprint change instead of adding it. Running the skill again replaces the block.