/gaia-post-deploy

user-facing
Category:
Deployment
Lifecycle phase:
5 -- Deployment

What it does

/gaia-post-deploy validates a deployment by checking service health, running smoke tests, and verifying that production metrics remain within SLO bounds. The output is a structured pass/fail report. If any critical check fails, it recommends rollback.

When to use it

  • You just deployed a new version and want to verify it is healthy.
  • You want to compare production metrics (error rate, latency, throughput) against baselines.
  • A canary deployment is running and you need to evaluate whether to proceed or rollback.

Prerequisites

  • A deployment must have occurred. This command validates an already-deployed version.

How to invoke

/gaia-post-deploy

What it does step by step

  1. Health checks Verifies all configured health endpoints respond with 2xx status codes within timeout.
  2. Smoke tests Runs critical path validation: login flow, core feature happy path, key API endpoints.
  3. Metric validation Checks error rate, latency (P50/P95/P99), throughput, and resource utilization against SLO bounds.
  4. Canary analysis If using canary deployment, compares canary metrics against baseline and recommends proceed, hold, or rollback.
  5. Generate report Writes the post-deployment report with per-check pass/fail status and an overall deployment verdict.

Inputs

InputSourceDescription
Health endpointsProject configurationConfigured health check URLs and timeouts.
SLO boundsProject configurationError rate, latency, and throughput thresholds.

Outputs

OutputLocationDescription
Post-deployment report.gaia/artifacts/implementation-artifacts/post-deploy-{date}.mdStructured report with health, smoke, metric, and canary results.

Example session

> /gaia-post-deploy

Health Checks:
  /health: PASS (142ms)
  /ready: PASS (89ms)

Smoke Tests:
  Login flow: PASS
  Core feature: PASS
  API /users: PASS

Metrics:
  Error rate: 0.02% (threshold: 1%) -- PASS
  Latency P99: 245ms (threshold: 500ms) -- PASS
  Throughput: 1,240 rps -- PASS

Canary analysis: N/A (full deployment)

Overall Deployment Status: PASS

Report written to .gaia/artifacts/implementation-artifacts/post-deploy-2026-05-07.md

What to run next

  • If PASS: deployment is verified. No further action needed.
  • If FAIL: review the failing checks and consider /gaia-rollback-plan.

Troubleshooting

Endpoint unreachable

Check that the service is running and network routing is correct. The report includes the specific error type (timeout, DNS failure, connection refused).

Metrics exceed thresholds

The deployed version may have a performance regression. Compare against the baseline and consider rolling back.