Deploy Command
Orchestrate deployment through the pipeline with proper gates and validation.
Usage
code
/deploy <feature-id> Deploy feature to staging /deploy <feature-id> --promote Promote from staging to production /deploy <feature-id> --hotfix Abbreviated pipeline for urgent fixes
Arguments
Feature ID: $ARGUMENTS
Prerequisites
Before deployment:
- •Review gate must be approved:
/pipeline approve <id> review - •All blocking findings must be resolved
- •Tests must pass
Workflow
/deploy <feature-id>
- •
Validate prerequisites
- •Check review gate is approved
- •Verify no blocking findings
- •Confirm tests pass (check CI status)
- •
Load deployment context
- •Read design artifact for infrastructure requirements
- •Read service profile for deployment targets
- •Check FluxCD configuration requirements
- •
Invoke SRE agent
- •Generate/update Kustomize overlays
- •Configure staging deployment
- •Set up monitoring and alerts
- •
Update pipeline state
- •Mark deploy stage as in_progress
- •Record deployment timestamp
/deploy <feature-id> --promote
- •
Validate staging success
- •Check staging deployment is healthy
- •Verify staging tests pass
- •Confirm metrics are nominal
- •
Invoke SRE agent for production
- •Update production overlay
- •Configure canary/rollout strategy
- •Set up production alerts
- •
Trigger document and announce stages
- •These can run in parallel with production monitoring
/deploy <feature-id> --hotfix
Abbreviated path for urgent fixes:
- •Skip normal gates (with audit trail)
- •Direct to production with canary rollout
- •Require post-deploy review within 24 hours
- •Auto-create follow-up tasks for documentation
Deployment Context Template
markdown
## Deployment Context
**Feature**: {id} - {name}
**Target**: {staging|production}
**Review Status**: Approved on {date}
### Infrastructure Requirements
{From design artifact}
### Deployment Configuration
{From service profile and kustomize patterns}
### Rollout Strategy
- Canary: {percentage}
- Rollout duration: {time}
- Rollback trigger: {conditions}
### Monitoring
- Key metrics to watch
- Alert thresholds
- Dashboard links
Output
code
Deployment initiated: feat-042-vm-snapshot-management Target: staging Review gate: Approved (2025-01-15) [Invokes SRE agent] Deployment configured. Kustomize overlay: config/overlays/staging/feat-042/ FluxCD will reconcile within 5 minutes. Monitor: /deploy status feat-042 Promote to production: /deploy feat-042 --promote
Error Handling
Review not approved:
code
Cannot deploy feat-042: review gate not approved. Action: Run /pipeline approve feat-042 review after resolving findings.
Blocking findings exist:
code
Cannot deploy feat-042: 2 blocking findings unresolved. Findings: - missing-status-condition in pkg/apis/snapshots/v1alpha1/types.go - unvalidated-input in pkg/registry/snapshot/strategy.go Action: Resolve blocking findings and request re-review.
Tests failing:
code
Cannot deploy feat-042: CI tests failing. Failed jobs: unit-tests, integration-tests Action: Fix failing tests before deployment.