Release Worktree Checklist¶
Date: 2026-06-25 Status: Accepted for the first paid pilot. Roadmap item: EP8-T8.
Decision¶
Release worktree and branch safety is accepted for the first paid pilot.
The release operator now has one checklist that covers every release-affecting repository:
backendarchitecturedocsmobile-frontendweb-admin
Required Checks¶
The checklist gives exact commands for:
- fetching and pruning all remotes before release work;
- checking worktree cleanliness and current branch in every repository;
- using
git pull --ff-only; - proving
productionhas no commits absent fromintegration; - proving
productionis an ancestor ofintegration; - checking merge commits in the production promotion range;
- promoting only with
git merge --ff-only; - blocking direct agent or automation pushes to
production; - monitoring every GitLab pipeline to a terminal state after push;
- verifying successful integration deploys with
agent-browser.
Evidence¶
- Published operator runbook: Release worktree checklist.
- Published production signoff: Production release signoff.
- Architecture runbook:
docs/runbooks/release-worktree-checklist.md. - Architecture guard:
release worktree checklist > documents branch-safe release checks for every repository.
Remaining Boundary¶
This closes the EP8-T8 release-hygiene gate. Production rollout remains manual and user-controlled; this checklist only proves branch safety and post-push monitoring requirements before that manual step.