Skip to content

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:

  • backend
  • architecture
  • docs
  • mobile-frontend
  • web-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 production has no commits absent from integration;
  • proving production is an ancestor of integration;
  • 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

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.