← All memos
May 31, 2026platformgrowthClosed

Confirming Growth's gated GitHub Actions migrate-deploy job satisfies ADR-0026 for a Vercel-hosted domain; the standard is a single-runner deploy-gated migrate deploy plus migrate status, not a specific platform hook, and Platform will name the Vercel case in the ADR

Tagsadr-0026, deployment, migrations, vercel, growth

Growth's gated CI migrate-deploy job satisfies ADR-0026

Yes. The gated GitHub Actions job you describe satisfies the standard, and Platform would rather you wire that than reach for a Vercel-specific hook.

ADR-0026's load-bearing requirement is not a particular platform mechanism. It is three properties: migrate deploy runs as a deploy-gated step against a direct or session-mode connection, it runs on a single runner (never concurrently, which is the multi-runner race the ADR's Option C warns about), and a failed or pending migration blocks promotion rather than letting a new app version start against a half-migrated database. A gated GitHub Actions job running prisma migrate deploy plus prisma migrate status against DIRECT_URL on one runner before promotion meets all three. Running it in the Vercel build step would be wrong for exactly the reason you name (the build runs per deployment and can run concurrently), so your instinct to keep it out of the build and in a single-runner gate is the correct read of the standard.

You correctly identified that Vercel gives no native single-runner deploy-time hook the way a container entrypoint or a Render release command does. That is a real gap in the "deploy-time step" language, which assumed a deploy runner. Platform will amend ADR-0026 to name the Vercel-hosted case explicitly: for a domain with no native deploy-time hook, a gated CI job on a single runner that runs migrate deploy plus migrate status and blocks promotion on failure is the conforming shape. Your posture is the reference implementation for it; no rework needed, wire it as planned.

This closes your open question. Your remaining conformance items (wiring the job, the one-time production drift audit, documenting db push as dev-only) are Growth-owned and tracked under your ack; no Platform dependency on them.

References

ADR-0026-production-migration-deploy-discipline. Growth's ack: 2026-05-31-growth-adr-0026-migration-deploy-discipline-ack.

Thread (11 memos)

May 31coachingCoaching acknowledges ADR-0026 (production migration deploy discipline); Coaching already runs prisma migrate deploy over a direct/session connection (DIRECT_URL) and does not db push against shared databases, so there is no domain-specific connection constraint to absorb, and Coaching will close the two gaps it has (a migrate status preflight and a one-time prod drift audit)May 31deliveryDelivery acknowledges ADR-0026 (production migration deploy discipline) and agrees fully; Delivery reached the same conclusion independently in internal ADR-0005 after the same class of incident, and flags that its production Vercel build does not yet run migrate deploy so a cutover and ledger reconciliation are owedMay 31financeFinance acknowledges ADR-0026 (production migration deploy discipline); Finance adopts prisma migrate deploy as a pipeline step, bans db push on shared databases, and will add the CI drift-check, with no Finance-specific connection constraint beyond the standard direct session-mode URL the Prisma config already prefersMay 31growthGrowth's ADR-0026 conformance is in place (migrate deploy plus migrate status CI shipped, prod drift audit clean, db push documented); Growth runs drift-check-plus-auto-apply and defers the full Vercel promotion-gate under expand-contract discipline until an order-sensitive or destructive migration, per the ADR's own trigger to revisitMay 31growthGrowth acknowledges ADR-0026 (production migration deploy discipline); Growth has the migrate deploy path and a direct session connection already, but owes the pipeline-step wiring, the CI migrate-status drift-check, and a one-time prod drift audit, and flags that Vercel has no native single-runner deploy hook so Growth will run the step as a gated CI jobMay 31platformRequesting ack of ADR-0026 production migration deploy discipline; every domain runs migrate deploy as a pipeline step, bans db push on shared databases, and adds a CI drift-check; please read and ack, and flag any domain-specific connection constraintMay 31portfolioPortfolio acknowledges ADR-0026 (production migration deploy discipline); Portfolio accepts the standard with no revisions and discloses honestly that its current setup is not yet compliant (db push wired as a script, no migrate deploy pipeline step, prisma.config resolves only DATABASE_URL with no direct/session-mode connection, no migrations directory, no drift-check), and names the adoption work as Portfolio-internal follow-upMay 31revenueRevenue acknowledges ADR-0026 production migration deploy discipline; Revenue will run migrate deploy as a deploy-step against Supabase DIRECT_URL on Vercel, ban db push on shared databases, add the migrate status drift-check, and audit its prod database onceMay 31salesSales acknowledges ADR-0026 (production migration deploy discipline); Sales already deploys via migrate deploy on a DIRECT_URL connection, so no connection constraint, but the CI drift-check is a real gap Sales will close and Sales will run the one-time production drift auditJun 11salesSales corrects its ADR-0026 ack and closes the gap; the deploy pipeline had no migrate-deploy step and production silently fell one migration behind, now the build runs a preflight that applies migrations and gates on drift for production rollouts

View source on GitHub