Deploy

Deploy application to a target environment with safety checks.

Mode: AIX-local preferred. Interactive confirmation is most useful for humans. Can work in automated pipelines with appropriate flags for non-interactive deployments.

Purpose

Use this skill when:

• Deploying to preview for PR review
• Deploying to staging for QA
• Deploying to production for release

Safety Gates

Execution

Manual Steps

# 1. Verify current state
git status                    # Clean working tree
git log --oneline -1          # Correct commit

# 2. Check CI status
gh run list --limit 3         # All checks passing

# 3. Deploy
./scripts/deploy.sh --env production

# 4. Verify deployment
curl -I https://your-app.example.com/health

With Deploy Script

# Preview deployment (auto-confirm)
./scripts/deploy.sh --env preview

# Staging deployment
./scripts/deploy.sh --env staging

# Production deployment (requires confirmation)
./scripts/deploy.sh --env production

# Dry run - validate without deploying
./scripts/deploy.sh --env production --dry-run

# Monorepo: specific app
./scripts/deploy.sh --env staging --app api

Pre-flight Checks

Before deploying, the script verifies:

Example Output

Deploy Pre-flight Checks
========================

Environment: production
App: web
Commit: abc1234 (v1.3.0)
Branch: main

Checks:
  ✅ Working tree clean
  ✅ On main branch
  ✅ CI checks passing (12/12)
  ✅ Version tag exists (v1.3.0)
  ✅ No blocking issues

Ready to deploy to production.
This will affect live users.

Continue? [y/N]: y

Deploying...
  Building image...
  Pushing to registry...
  Updating service...
  Waiting for health check...

✅ Deployment complete!

URL: https://your-app.example.com
Deployment ID: dep_abc123xyz
Health: OK (200ms response)

Rollback command (if needed):
  ./scripts/deploy.sh --rollback dep_abc123xyz

Rollback

If issues are discovered after deployment:

# Rollback to previous deployment
./scripts/deploy.sh --rollback

# Rollback to specific deployment
./scripts/deploy.sh --rollback dep_previous_id

Platform Integration

This skill is platform-agnostic. Implementations should support:

Implementation Notes

Projects implementing this skill should:

1. Create a deploy script at ./scripts/deploy.sh
2. Configure environment variables for platform authentication
3. Set up health check endpoints for deployment verification
4. Document rollback procedures specific to your platform

See your project's deployment configuration for specific details.

See Also

• Promote Skill - Create release branches
• PR Merged Skill - Post-merge summary