staging-deploy

name	staging-deploy
description	Build, push, migrate, and deploy to staging environment with health check verification. Use when deploying a completed phase to staging.
argument-hint	[service or component to deploy]
tools	["run_in_terminal","read_file","forge_validate"]

Staging Deploy Skill

Trigger

"Deploy to staging" / "Push to staging environment"

Steps

0. Pre-flight Forge Validation

Use the forge_validate MCP tool to verify setup integrity before deploying.

1. Pre-Flight Checks

npm run build
npm run test
npm run lint

Conditional: Pre-Flight Failure

If Step 1 (Pre-Flight Checks) fails → STOP. Do not proceed to build.

2. Build Container

docker build -t contoso-api:staging -f Dockerfile .
docker tag contoso-api:staging registry.contoso.com/api:staging
docker push registry.contoso.com/api:staging

3. Run Migrations

npx knex migrate:latest --env staging
# Or: npx prisma migrate deploy

4. Deploy

# Kubernetes
kubectl apply -f k8s/staging/ --context staging

# Or Docker Compose
docker compose -f docker-compose.staging.yml up -d

5. Verify

curl -f https://staging-api.contoso.com/health
curl https://staging-api.contoso.com/api/version
npm run test:smoke -- --env staging

Safety Rules

• ALWAYS run tests before deploying
• ALWAYS verify health endpoint after deploy
• NEVER deploy to production using this skill
• Rollback: kubectl rollout undo deployment/api --context staging

Temper Guards

Shortcut	Why It Breaks
"It works locally, skip staging"	Local environments mask configuration, networking, and scaling issues that only surface in staging.
"Health check isn't needed yet"	Without health checks, orchestrators can't detect failures. A "successful" deploy may serve errors silently.
"I'll add monitoring after launch"	Post-launch is too late. Staging is where you verify observability works before production traffic arrives.
"One big deploy is simpler"	Monolithic deploys are harder to roll back. Deploy incrementally so failures are isolated to a single change.

Warning Signs

• No health check endpoint — container starts but no way to verify it's actually serving correctly
• Deploy without tests — build pushed to staging without passing the test suite first
• No rollback plan — deploy proceeds without a documented way to revert
• Secrets hardcoded or missing — environment variables not configured for the staging environment
• No smoke test after deploy — health endpoint returns 200 but actual business routes not verified

Exit Proof

After completing this skill, confirm:

• npm run build && npm test passes before container build
• Container builds successfully and pushes to registry
• Health endpoint returns 200 after deploy (curl -f https://staging/health)
• Smoke tests pass — npm run test:smoke
• Rollback procedure is documented and tested

Persistent Memory (if OpenBrain is configured)

• Before deploying: search_thoughts("deploy failure", project: "Falsify", created_by: "copilot-vscode", type: "postmortem") — load prior deployment failures and environment-specific gotchas
• After deploy succeeds/fails: capture_thought("Deploy: <outcome — success or failure details>", project: "Falsify", created_by: "copilot-vscode", source: "skill-staging-deploy") — persist environment issues and config changes for next deployment