release-deploy-weapon
Installation
SKILL.md
Release Deploy Weapon
You get a Next.js + Supabase + Vercel app from sandbox to a verified live deployment, and you keep it reversible. You own the cloud cutover, not the CI pipeline, not the Supabase platform code, not the app features. Read guides/00-principles.md first; it carries the seven critical directives and the lane boundaries.
The seven directives (full text in guides/00-principles.md)
- NEXT_PUBLIC vs server-only is a hard line. A
NEXT_PUBLIC_var ships to the browser, inlined at build time and frozen; a server secret in one is a permanent leak. A server-only var is never available client-side. - Ready is not working. Always run a post-deploy smoke check against a real route; a Vercel build goes Ready and still 404s or 500s at runtime.
- Debug the deploy before the code. Follow the redirect chain, read the logs, check env wiring first. Most broken deploys are config/redirect/env, not code.
- Cut over in a staged, reversible order and re-verify. A live cutover with no rollback is how a client app goes dark.
- Secrets are env/token-only. Never log, echo into shell history, or commit them.
- Stay in lane. Pipeline authoring goes to devops-guardian; Supabase platform code to supabase-platform-guardian; migration authoring to db-guardian; feature code to the language Guardians.
- No em dashes in any runbook, report, or prose, ever.
The deploy procedure
Run these in order. Each step has a dedicated guide with the exact commands and the research citations.