aibot88 Deploy Validate Skill
Pre-deployment validation and readiness assessment. Ensures everything is in order before deploying.
Overview
Trigger: /popkit-ops:deploy validate or before any deployment execution
Purpose: Run comprehensive checks against the project and deployment configuration to catch issues before they reach production. Produces a go/no-go recommendation with a readiness score.
Critical Rules
- NEVER skip validation before production deploys - Validation is mandatory
- ALWAYS report ALL failures - Don't stop at first failure
- ALWAYS use AskUserQuestion for scope and post-validation decisions
- Blocking failures must block deployment - No overriding critical failures
- Non-blocking warnings should be surfaced - Let user decide on warnings
Required Decision Points
| Step | When | Decision ID |
|---|---|---|
| 1 | Before validation | scope_level |
| 2 | After results | proceed_action |
Skipping these violates PopKit UX standard.
Validation Checks
Quick Checks (always run)
| Check | Description | Blocking |
|---|---|---|
| Config exists | deploy.json present and valid | Yes |
| Target config | All enabled targets have required fields | Yes |
| Version check | Version field present and valid | Yes |
| Git status | Working directory clean (no uncommitted changes) | Warning |
Standard Checks (default)
| Check | Description | Blocking |
|---|---|---|
| Build | Project builds successfully | Yes |
| Tests | Test suite passes | Yes |
| Dependencies | No known vulnerable dependencies | Warning |
| Lockfile | Lock file present and up to date | Warning |
| ENV vars | Required environment variables documented | Warning |
Full Checks (comprehensive)
| Check | Description | Blocking |
|---|---|---|
| Security scan | Static security analysis | Warning |
| License audit | Dependency license compatibility | Warning |
| Docker lint | Dockerfile best practices (hadolint) | Warning |
| K8s validate | Kubernetes manifest validation | Warning |
| Size check | Build artifact size within limits | Warning |
| Integration | Integration test suite passes | Yes |
Process
Step 1: Load Configuration
python scripts/validate_deployment.py --dir . --action load-config
Loads deploy.json and reports current state.
Step 2: Scope Selection (MANDATORY)
Use AskUserQuestion:
- question: "What level of validation should I run?"
- header: "Scope"
- options:
- "Quick check" - Config and build only (~30s)
- "Standard (Recommended)" - Config, build, tests, deps (~2-5min)
- "Full validation" - All checks including security (~5-15min)
Step 3: Run Validation
python scripts/validate_deployment.py --dir . --action validate --scope standard --target docker
Step 4: Review Results (MANDATORY)
Use AskUserQuestion:
- question: "Validation complete. How should I proceed?"
- header: "Results"
- options:
- "Proceed to deploy" - All passed, deploy now
- "Fix issues" - Address failures first
- "Deploy anyway" - Override warnings (not recommended)
- "Abort" - Do not deploy
Readiness Score
Score is calculated from check results:
| Score | Meaning | Recommendation |
|---|---|---|
| 100 | All checks passed | GO - Deploy |
| 80-99 | Passed with warnings | GO - Deploy with awareness |
| 60-79 | Some non-blocking failures | CONDITIONAL - Fix warnings first |
| 40-59 | Significant issues | NO-GO - Fix before deploying |
| 0-39 | Critical failures | NO-GO - Blocking issues |
Output Format
Deployment Validation
=====================
Target: docker (primary)
Scope: standard
Environment: production
Checks:
[PASS] Config valid
[PASS] Build succeeds
[PASS] Tests pass (142/142)
[WARN] 2 moderate vulnerabilities in dependencies
[PASS] Lock file up to date
[WARN] .env.example missing DATABASE_URL
Score: 85/100
Recommendation: GO (with warnings)
Warnings:
1. npm audit: 2 moderate vulnerabilities (run npm audit fix)
2. .env.example incomplete: DATABASE_URL not documented
Next: /popkit-ops:deploy execute --target docker
Integration
Called by:
/popkit-ops:deploy validatecommandpop-deploy-setupworkflow (validate step)pop-deploy-executeworkflow (pre-deploy validation)
Triggers:
- deployment-validator agent
Followed by:
pop-deploy-execute- Execute the deploymentpop-deploy-setup- Fix configuration issues
Related
| Component | Relationship |
|---|---|
pop-deploy-init |
Creates deploy.json config |
pop-deploy-setup |
Generates deployment files |
pop-deploy-execute |
Executes deployment |
deployment-validator |
Agent for automated validation |