build
What it does¶
build is the command you type to build an Epic or a hardened One-off into pull requests. Its one decision is where the build runs: here, or in a sub-session. It hands that choice to delegating, and the build itself to building: the Waves, the gates, the merges and the questions about them all come from building.
Where you type /build <N> |
What happens |
|---|---|
| A terminal, or anywhere a session cannot be started | No question. The build runs here. |
| The desktop app | One question first: here or sub-session, with a recommendation. |
The sub-session is recommended when this session has already started other sessions, or when its folder is not a checkout of N's repository. Choose it and the build runs in a session of its own, in N's checkout, while this one stays free. delegating explains how the checkout is found and how your answers reach the sub-session.
When to reach for it¶
You type /build <N>; the agent never starts it on its own. Use it once the plan exists: an Epic that /to-tickets has broken into Sub-issues, or an issue that triage has hardened with the full Ticket contract. It is the build step of the Epic path and the single-issue path.
An agent cannot type /build, so an agent that starts a build, such as a Chief of Staff session, uses building directly. For work too small to file, skip spp and edit directly. ask-spp routes between every skill when the right one is unclear.
Common questions¶
Where did the build steps go?
To building, with its page. /build and a session told "use building for #N" run the same build, and building reads every decision from GitHub, so a build started either way can be resumed either way.
Will the sub-session ask me again where to run?
No. Its prompt tells it to use building, which never asks where to run.
It's working if¶
- In a terminal,
/build <N>starts building without a question about where. - In the desktop app, the first thing
/build <N>asks is here or sub-session. - Everything the build asks after that, and everything it does, is described on the building page.