deploy

Deploy Skill

Deploy the application to the specified environment.

Arguments

• $ARGUMENTS[0] (or $0): Target environment (staging, production, canary). Defaults to staging.
• Additional flags are parsed from $ARGUMENTS.

Dynamic Context

Current branch and recent commits: !git log --oneline -5

Current deployment status: !curl -s https://deploy.internal.example.com/api/status 2>/dev/null || echo "Status endpoint unavailable"

Deployment Procedure

Pre-flight Checks

1. Verify you are on a clean git branch with no uncommitted changes:

``bash git status --porcelain ``

1. Run the test suite (unless --skip-tests was passed):

``bash npm run test:ci ``

1. Check that the build succeeds:

``bash npm run build ``

1. Verify environment configuration exists for the target:

``bash ls -la config/deploy/$0.env ``

Deploy

1. If --dry-run was passed, show what would be deployed and stop:

``bash npm run deploy -- --env $0 --dry-run ``

1. Otherwise, execute the deployment:

``bash npm run deploy -- --env $0 ``

1. Wait for health checks to pass (up to 5 minutes):

``bash npm run deploy:health-check -- --env $0 --timeout 300 ``

Post-deploy

1. Tag the release in git:

``bash git tag -a "deploy-$0-$(date +%Y%m%d-%H%M%S)" -m "Deployed to $0" ``

1. Notify the team (if production):

``bash if [ "$0" = "production" ]; then curl -X POST https://hooks.slack.example.com/deploy \ -H "Content-Type: application/json" \ -d "{\"text\": \"Production deploy complete: $(git rev-parse --short HEAD)\"}" fi ``

Rollback

If the deployment fails at any step:

1. Run the rollback command:

``bash npm run deploy:rollback -- --env $0 ``

1. Verify health checks pass after rollback.

1. Report the failure with the error details.

Additional Resources

For detailed deployment configuration, see [deployment-guide.md](deployment-guide.md). For environment-specific notes, see [environments/](environments/).