Decision 0057 · Accepted
Draft workspace, checks
on ready
build opens a ready pull request and waits on CI. Pull request workflows run on every push, drafts included. Vercel builds a preview for every branch push. The starters install a pre-commit hook.
- Status
- Accepted
- Built from:
- da88c48
Status: Accepted (2026-10-31). Amends 0025 (build, not ship, opens the draft pull request), 0034 and 0044 (build ends at a pull request that is ready only when verified), 0048 (CI runs on the ready head, not on every push), and 0050 (flow-skills no longer requires context-review; branch previews are not automatic). Spec: 048.
Context
build opens a ready pull request and waits on CI. Pull request workflows run on every push, drafts included. Vercel builds a preview for every branch push. The starters install a pre-commit hook. Most of these runs verify heads nobody merges: 39 of 54 recent flow-skills deployments were previews. GitHub records a job skipped by a condition as a check run with conclusion skipped, which branch protection can count as passing.
Decision
- One draft pull request per spec is the workspace.
buildcreates it, or reuses the open one, early onspec/<number>-<slug>.- Workers use isolated worktrees and local branches.
- One integration owner pushes to the delivery branch after checking its remote head, and never force-pushes.
- Drafts run nothing.
- Pull request workflows skip their jobs while the pull request is a draft.
- Vercel branch deployments are off,
mainexcepted (git.deploymentEnabled). - Previews are explicit.
- Ready runs the checks.
buildmarks the pull request ready when implementation and focused checks are complete.ready_for_reviewand later pushes run the repository's required deterministic checks.
shipcounts only checks that ran.- A required check counts when its latest result on the merged head is
success. skipped,neutral, pending, missing, or stale results stop the merge.- A deterministic script enforces this.
- A required check counts when its latest result on the merged head is
- No git hooks. Secret and security checks run in ready-PR CI and in GitHub's push protection.
Alternatives
- Keep ready pull requests and CI on every push. Rejected: it pays for verification of heads that are still changing.
- Path or label filters instead of draft state. Rejected: they add conventions to remember. Draft state is already the signal for work in progress.
- An
ignoreCommandscript for Vercel. Rejected: Vercel still starts a build to run it.deploymentEnabledis native configuration. - Keep a minimal secret-file pre-commit hook. Rejected: agents bypass or trip on hooks, and CI plus push protection already cover it at merge time.
Consequences
A draft shows no CI signal, so build runs focused checks locally before marking the pull request ready. Repositories that require the Vercel check (such as gaboesquivel.com) must keep branch deployments, or require a CI check instead, before adopting item 2. GitHub-side blocking still depends on an active ruleset. ship's script holds the line when protection is off, but does not replace it.