teqo/docs/CUTOVER-MAIN-ONLY.md
Francisco Ignácio Fontoura Solla b7bb6f1479 style: prettier CUTOVER-MAIN-ONLY.md
2026-07-31 23:06:40 -03:00

1.3 KiB

Cutover checklist (main-only + gated deploy) — human, once

Status after agent delivery (2026-07-31):

  • Code PR opened (main-only cutover) — see PR targeting main
  • pnpm configure:branch-protection applied on main (required: checks + migration-lock, strict=false, 0 reviews)
  • No open PRs targeting stage at cutover time
  • Repo secrets present (VERCEL_*, POOL_GITHUB_TOKEN)
  • VERCEL_ORG_ID / VERCEL_PROJECT_ID synced from local .vercel/project.json (vercel link)
  • Confirm ci.yml deploy job green after token+IDs are correct
    • Misleading CLI error "Could not retrieve Project Settings" usually means 403 (bad/expired VERCEL_TOKEN or wrong IDs) — regenerate token at vercel.com/account/tokens if deploy still fails

After the cutover PR merges to main:

  1. Validate Vercel Git skip: push to main must not start a Vercel Git build (ignoreCommand exit 0). Production comes only from ci.yml → deploy.
  2. Confirm ci.yml runs full suite; deploy job runs or fails closed with a clear missing-secrets message until VERCEL_* are set.
  3. POOL_GITHUB_TOKEN=… pnpm agent:pool -- doctor must read repo variables.
  4. Optionally delete branch stage and its Environment/secrets when idle.

See AGENT-OPS.md.