Decision 0030 · Accepted
Asked delivery mode and local mode without
a remote
Flow has two delivery modes.
- Status
- Accepted
- Built from:
- da88c48
Status: Accepted (2026-10-28). Amends 0020 (delivery inferred and recorded), 0026 (depth asked only at setup and start; unset means Lite), 0028 (local ship pushes main), and 0029 (the draft pull request's closing lines). Spec: 019. Amended by 0032 (local build reviews and merges into local main; "ship it" is the push request) 0036 (only delivery is asked; no depth), and 0037 (github or local; asked only by the delivery chain). Amended by 0039. Amended by 0044 (delivery is inferred, never asked; local build no longer merges).
Context
Flow has two delivery modes. Process depth is asked when a Flow block is written, but the delivery mode is never asked: build infers it at build time and records the pick without confirmation, defaulting to pull-request mode when it cannot see branch protection. Local mode merges a spec branch into main and pushes it, so it needs a remote, and a new project from start has none. Users expect to choose both at the start and to work fully locally when they say so.
Decision
- Ask, do not infer. Depth and delivery are asked together, once, wherever Flow first needs them, and recorded on the Flow block when there is one. Inference only suggests an answer. A default branch that requires pull requests forces pull-request mode without asking. With no remote, pull-request mode is never picked.
- Local mode keeps the spec branch. Work runs on a spec branch with task worktrees and lands on the default branch through one
--no-ffmerge byship. - Local mode needs no remote.
shipfast-forwards from a remote only when one exists and pushes the default branch only when the request asks. - Worktrees are removed on integration, and
shipconfirms none remain for the spec.
Alternatives
- Commit tasks directly to local
main. Rejected: there is no single unit to review or drop, a failed task leavesmainhalf-built, and the two modes would diverge in howbuildandshipwork. - Keep inference, add an override. Rejected: users are surprised by a mode they never chose, and a project with no remote dead-ends in pull-request mode.
- Local mode always pushes when a remote exists. Rejected: "local" should mean nothing leaves the machine unless asked.
Consequences
- One more question in the first round of a new project or feature; none after the block records the answers.
- Local mode works in a repository with no remote, and
shipno longer pushesmainwithout being asked. buildandshipown worktree cleanup; a failed task's worktree is kept and reported.