Skip to content

Deploy Pipeline

Deploy orchestration is intentionally staged. Hub should never hand a worker a vague “deploy everything” prompt when the next safe stage can be named.

  1. Confirm Hub review passed.
  2. Confirm human acceptance when required.
  3. Commit accepted source work in the owning worker worktree.
  4. Push and prepare the merge path.
  5. Merge into the production branch.
  6. Update the canonical main/deploy worktree.
  7. Deploy from the validated main/deploy worktree.
  8. Verify production.
  9. Sync clean sibling worktrees.

Hub pauses for:

  • destructive cleanup
  • dirty unrelated work
  • branch mismatch
  • missing deploy target
  • credentials or secret changes
  • infrastructure creation
  • production data writes
  • ambiguous project ownership

Implementation may happen in a worker-owned worktree. Production deploy should happen from the canonical main/deploy worktree unless a human explicitly approves a different path.

Final deploy reports should name:

  • repo and worktree
  • branch
  • commit
  • command or workflow used
  • target service
  • live URL
  • validation result
  • follow-up risks