autopilot-deploy

name	autopilot-deploy
description	Agent 또는 skill의 프로덕션 배포를 canary 1% → 10% → 50% → 100% 4단계로 자동 진행한다. 각 단계는 continuous-eval 통과와 SLO 준수를 gate로 하며 circuit breaker가 SLO 위반을 감지하면 즉시 이전 단계로 자동 롤백한다. 100% 승격은 사람 승인이 필수다.
argument-hint	[deployment-target, e.g. rag-qa-agent:v2.3.1]
user-invocable	true
model	claude-sonnet-4-6
allowed-tools	Read,Grep,Bash,mcp__cloudwatch,mcp__prometheus
ontology	{"produces":["Deployment"],"consumes":["Spec","ADR"],"references":["Budget"]}
loop-interface	{"accepts-from":["self-improving-loop.artifact","continuous-eval.gate-signal"],"emits-to":["continuous-eval.deployment-event"],"emits-signals":[]}

When to Use

• 새로운 agent 버전 또는 skill 수정이 continuous-eval golden dataset를 통과했고 프로덕션 반영이 필요할 때
• self-improving-loop가 생성한 PR이 머지되어 canary 검증이 필요할 때
• 모델 교체(예: Qwen3-7B → Qwen3-14B)를 점진 배포하고 회귀 감시가 필요할 때

사용 제외:

• Inception/Construction 단계가 미완료인 경우. Operations 단계는 하위 phase 완료 후 활성화.
• cost-governance가 예산 초과 veto를 건 배포.
• incident-response가 SEV1 상태로 freeze한 클러스터.

Prerequisites

• Kubernetes cluster (EKS 권장) + Argo Rollouts 또는 Flagger CRD 설치.
• Prometheus SLO 메트릭 수집 (agent_request_latency_seconds, agent_error_rate, agent_tokens_total).
• awslabs.eks-mcp-server==0.1.28, awslabs.prometheus-mcp-server==0.2.15 MCP 설정 완료 (@latest 금지, PyPI 버전 pin 필수).
• 배포 대상의 최근 continuous-eval 리포트가 pass 상태여야 합니다.
• SLO 정의 파일 (.omao/plans/slo/${target}.yaml)이 존재해야 합니다.

Progressive Rollout 4-Stage

각 단계는 트래픽 비율 상승 → 30분 soak → SLO 검증 → gate 통과 시 다음 단계 순서로 진행됩니다. 4단계 전체는 약 2~3시간 소요됩니다.

Stage 1: Canary 1% — Smoke Test (30분)

트래픽의 1%를 candidate 버전으로 라우팅합니다. 이 단계의 목적은 런타임 실패(CrashLoopBackOff, image pull error, RBAC 거부)를 빠르게 감지하는 것입니다.

kubectl argo rollouts set image rollout/${TARGET} \
  agent=${REGISTRY}/${TARGET}:${VERSION}

kubectl argo rollouts promote rollout/${TARGET} --stage canary-1

통과 조건:

• rate(agent_errors_total{version="$VERSION"}[5m]) < 0.01 (에러율 1% 미만)
• histogram_quantile(0.99, agent_request_latency_seconds_bucket) < 5.0 (P99 5초 미만)
• Pod restart count == 0

Stage 2: Canary 10% — Stability Gate (30분)

트래픽 10% 전환. 이 단계에서는 continuous-eval를 1회 inline 실행하여 품질 지표를 확인합니다.

kubectl argo rollouts promote rollout/${TARGET} --stage canary-10
/continuous-eval ${TARGET}: --mode canary