Release process

CI gates (all required)

1. Lint (Biome)
2. Convention check (scripts/check-conventions.ts — 23+ rules)
3. Typecheck (pnpm turbo typecheck)
4. Tests (pnpm turbo test)
5. Build (pnpm turbo build)
6. Changeset present + user-facing summary
7. OpenAPI drift check
8. SDK drift check
9. Service-pages drift check
10. AI overview staleness
11. Docs dead-link check
12. PR title references Linear ticket
13. Cross-link audit (concept pages have ≥3 related links, services ≥5)

Stages

• dev: auto-deploy on merge. Burns down dev DB nightly. Use for integration testing.
• staging: auto-promote from dev after 60 minutes of green dev. Soaked here ≥ 24h.
• prod: manual gate. Requires:
  • Production-readiness checklist complete for any new service
  • Alarms acknowledged for the deploy window
  • On-call notified
  • Rollback plan documented

Freeze windows

No prod deploys during:

• Mobile release branch cut (announced ≥ 48h in advance)
• High-traffic events (campaign launches, partner demos)
• The 30 minutes around a payment provider’s outage

Auto-rollback triggers

• Healthz fails on > 50% of new tasks for > 5 minutes → automated rollback to previous task definition
• Error rate spike > 5x baseline → page on-call + halt rollout
• Critical alarm fires within 30 minutes of deploy → page + halt

Related

• Production readiness
• Rollback
• Incident response
• Reliability and deployment