deploy

name	deploy
description	Guide through a safe deployment process with verification
user-invocable	true

/deploy - Deployment Workflow

Guide through a safe deployment process.

Usage

/deploy [environment]
/deploy staging
/deploy production

Pre-Deployment Checklist

1. Code Readiness

## Pre-Deploy Checks

### Code
- [ ] All tests passing
- [ ] No linting errors
- [ ] Code reviewed and approved
- [ ] No console.log or debug statements
- [ ] Feature flags configured correctly

### Git
- [ ] On correct branch
- [ ] Branch up to date with main
- [ ] No merge conflicts
- [ ] Commit messages are clear

2. Environment Verification

### Environment: [staging/production]
- [ ] Environment variables set
- [ ] Secrets/credentials valid
- [ ] Database migrations ready
- [ ] External service dependencies available

3. Deployment Steps

Provide environment-specific steps:

Staging Deployment

# 1. Ensure tests pass
npm test

# 2. Build the application
npm run build

# 3. Run database migrations (if any)
npm run db:migrate

# 4. Deploy to staging
git push origin staging
# or: npm run deploy:staging

# 5. Verify deployment
curl https://staging.example.com/health

Production Deployment

# 1. Final verification
npm test
npm run lint
npm run typecheck

# 2. Create release tag
git tag -a v1.2.3 -m "Release v1.2.3"
git push origin v1.2.3

# 3. Deploy
git push origin main
# or: npm run deploy:production

# 4. Monitor deployment
# Watch logs, metrics, error rates

4. Post-Deployment Verification

## Post-Deploy Verification

### Health Checks
- [ ] Application is responding
- [ ] Health endpoint returns 200
- [ ] Key API endpoints working

### Smoke Tests
- [ ] User can log in
- [ ] Core functionality works
- [ ] No increase in error rates

### Monitoring
- [ ] Check error tracking (Sentry, etc.)
- [ ] Check application logs
- [ ] Check metrics dashboard
- [ ] Check alert systems

5. Rollback Plan

Always have a rollback ready:

## Rollback Procedure

If issues are detected:

### Immediate Rollback
```bash
# Revert to previous version
git revert HEAD
git push origin main

# Or deploy previous tag
git checkout v1.2.2
npm run deploy:production

Database Rollback (if needed)

# Rollback last migration
npm run db:rollback

Communication

• Notify team in #deployments
• Update status page if customer-facing
• Document incident

## Deployment Log Template

```markdown
## Deployment: [Date] [Version]

**Deployer**: [Name]
**Environment**: [staging/production]
**Start Time**: [HH:MM]
**End Time**: [HH:MM]

### Changes Included
- [Feature/fix 1]
- [Feature/fix 2]

### Pre-Deploy Status
- Tests: ✅ Passing
- Build: ✅ Successful
- Migrations: ✅ Ready

### Deployment Status
- [ ] Deployed successfully
- [ ] Health checks passing
- [ ] Smoke tests passing

### Issues Encountered
- [None / Description of issues]

### Rollback Required
- [ ] Yes / [x] No

### Notes
[Any additional observations]

Tips

• Deploy during low-traffic periods
• Have team members available during deploy
• Monitor for at least 15 minutes after deploy
• Document any manual steps needed
• Keep deploys small and frequent