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)

  1. 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.
  2. 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.
  3. 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.
  4. Cut over in a staged, reversible order and re-verify. A live cutover with no rollback is how a client app goes dark.
  5. Secrets are env/token-only. Never log, echo into shell history, or commit them.
  6. 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.
  7. 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.

Installs
1
First Seen
Jul 25, 2026
release-deploy-weapon — jzferrell26/dm-skills