aws-live-ecs-rollout-guard
Guard live Amazon ECS and Fargate rollout actions with ecs service, task definition, deployment circuit breaker, alarms, rollback, health check, and approval gates. Use only for intentional live ECS rollout actions against confirmed targets.
Install
npx skills add https://github.com/VincentChuWaiChow/vanguard-frontier-agentic/tree/master/skills/aws/aws-live-ecs-rollout-guard
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install vincentchuwaichow-vanguard-frontier-agentic@llmmart
git clone https://github.com/VincentChuWaiChow/vanguard-frontier-agentic.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole vincentchuwaichow/vanguard-frontier-agentic collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
AWS Live ECS Rollout Guard
Purpose
Act as the guarded live ECS rollout operator who insists on service-level targeting, health evidence, and rollback controls before touching a real ECS deployment.
When to use
Use this skill for:
- a real ECS or Fargate service rollout, forced deployment, or task-definition promotion is being considered
- you need circuit breaker, alarm, health, and rollback awareness before touching a live service
- the user wants operational help for a live ECS change rather than a repo-only task-definition edit
Lean operating rules
- Prefer AwsDocumentationMcpServer when available via uvx awslabs.aws-documentation-mcp-server@latest; if uvx cannot run in the current environment, say: "I can't run uvx here, so I'm falling back to official AWS docs." Then fall back to repository evidence, sanitized user evidence, official AWS documentation, Context7, and read-only AWS CLI evidence when available.
- Do not run a live ECS rollout action until the cluster, service, task definition, account, region, and intended deployment behavior are explicit.
- Prefer deployment circuit breaker, CloudWatch alarm failure detection, service events, and rollback posture over blind force-new-deployment habits.
- If the request skips health checks, bake time, alarm state, or rollback criteria, push back.
- Never print secrets, task environment values, or customer identifiers from service output.
- Load references only when needed; do not pull all deep guidance into short answers.
References
Load these only when needed:
- Workflow and output contract — use when executing the guarded workflow or formatting the final answer.
- Safety checklist — use before any live AWS mutation recommendation or approval checkpoint.
- Approval and target checklist — use when the environment, identity, blast radius, or approval state must be made explicit.
- Official sources — use when grounding AWS service behavior or checking the detailed source list.
Response minimum
Return, at minimum:
- confirmed cluster, service, task definition, account, and region
- deployment safety posture including circuit breaker or alarms
- the smallest safe next live action or refusal reason
- rollback and bake-time notes
- post-rollout verification requirements
Files (vanguard-frontier-agentic)
-
references
-
approval-and-target-checklist.md 805 B
# Approval and target checklist Make these explicit before any live AWS write action: - Target: cluster, service, task definition, account, region, and environment. - Safety: circuit breaker, alarms, health checks, bake time, and rollback behavior. - Evidence: current deployment status, service events, latest healthy revision, and blast radius. - Approval: explicit human approval before any live rollout or force-new-deployment step. - Verification: service deployment state, alarms, events, and observation window after the change. ## Refusal triggers Refuse or stop at planning when: - the target account, region, or principal is ambiguous, - the user has not explicitly approved the live step, - rollback or monitoring posture is missing, or - the action scope expands beyond the named target. -
official-sources.md 1.9 KB
# Official sources Use this reference only when you need source grounding for AWS service behavior or the detailed source list. ## AWS documentation Use these as starting points, not as proof of the user's live AWS state: - https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployment.html - https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-steps-ecs.html - https://docs.aws.amazon.com/whitepapers/latest/overview-deployment-options/bluegreen-deployments.html - https://docs.aws.amazon.com/AmazonECS/latest/developerguide/troubleshooting.html ## Grounding rule Official documentation explains AWS service behavior. It does not prove the user's current account, Region, quota, resource configuration, IAM boundary, pricing, entitlement, or operational state. Prefer read-only AWS MCP or CLI evidence, repository evidence, or sanitized user-provided evidence for current-state claims. ## Current MCP/documentation refresh (2026-06-02) Service facts from official docs: - ECS service deployment history tracks lifecycle states, circuit breaker failures, CloudWatch alarms, rollbacks, and recent deployment history. - ECS blue/green deployments with CodeDeploy shift traffic between replacement task sets and can use lifecycle hooks; rollback depends on deployment configuration and health signals. Sampled live evidence: - Read-only regional availability sampling reported Amazon ECS, AWS Fargate, and AWS CodeDeploy as `isAvailableIn` in `us-east-1`, `us-west-2`, `eu-west-1`, and `ap-southeast-1`. - Sampled APIs `ECS+DescribeServices`, `ECS+DescribeTasks`, `CloudWatch+DescribeAlarms`, and `CodeDeploy+GetDeployment` were reported `isAvailableIn` in those regions. Review implications: - Guard live ECS rollout with current service/deployment state, stopped-task reasons, target health, alarms, deployment controller, desired/running counts, and rollback/stop path. - Regional/API availability does not prove a service is safe to roll forward. -
safety-checklist.md 761 B
# Safety checklist Before recommending or running a live AWS action, enforce these checks: - Do not force a new deployment just because the service looks stale. - Do not ignore unhealthy tasks, missing alarm coverage, or rollback-disabled settings. - Do not treat a task definition registration as equivalent to a safe live rollout. - Do not widen blast radius across multiple services when one named service is the target. - If deployment safety signals are weak or contradictory, stop. ## Mandatory posture - Prefer the smallest reversible change. - Prefer preview, describe, or dry-run style evidence before mutation. - Treat the absence of rollback as a blocker, not a detail. - If live AWS credentials are present but target identity is unclear, stop. -
workflow-and-output.md 1 KB
# Workflow and output contract Use this sequence when the request may touch a live AWS environment: 1. Confirm cluster, service, task definition, account, region, and environment before any live ECS action. 2. Inspect current deployment state, service events, health checks, alarm state, and rollback posture before proposing mutation. 3. Prefer circuit breaker or alarm-backed failure detection and a defined bake window rather than a blind forced rollout. 4. If the user explicitly requests the live step and targeting is confirmed, keep the action narrow and report sanitized evidence only. 5. After the change, report deployment state, rollback status, alarms, service events, and post-rollout verification results. ## Output shape Return concise sections in this order: 1. Target confirmation 2. Preflight evidence 3. Approval status 4. Proposed or executed action 5. Rollback posture 6. Post-change verification 7. Open risks or refusal reason Keep command evidence sanitized. Do not paste secrets, tokens, or raw env dumps.
-
-
metadata.json 1.2 KB
{ "id": "aws-live-ecs-rollout-guard", "name": "AWS Live ECS Rollout Guard", "type": "skill", "provider": "aws", "harnesses": [ "codex", "claude-code", "cursor", "gemini", "kiro", "other" ], "summary": "Guard live Amazon ECS and Fargate rollout actions with service targeting, deployment circuit breaker or alarm checks, rollback posture, and explicit approval before mutation.", "source_type": "original", "official_docs": [ "https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployment.html", "https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-steps-ecs.html", "https://docs.aws.amazon.com/whitepapers/latest/overview-deployment-options/bluegreen-deployments.html", "https://docs.aws.amazon.com/AmazonECS/latest/developerguide/troubleshooting.html" ], "security_notes": "Live ECS rollout actions require exact service targeting, health evidence, rollback posture, and explicit approval. Never treat force-new-deployment as a harmless default.", "last_verified": "2026-06-02", "path": "skills/aws/aws-live-ecs-rollout-guard", "author": "github: VincentChuWaiChow", "version": "0.1.3" } -
SKILL.md 2.8 KB
--- name: aws-live-ecs-rollout-guard description: Guard live Amazon ECS and Fargate rollout actions with ecs service, task definition, deployment circuit breaker, alarms, rollback, health check, and approval gates. Use only for intentional live ECS rollout actions against confirmed targets. allowed-tools: Read Grep Glob WebFetch metadata: author: "github: VincentChuWaiChow" version: "0.1.3" updated: "2026-06-02" category: delivery --- # AWS Live ECS Rollout Guard ## Purpose Act as the guarded live ECS rollout operator who insists on service-level targeting, health evidence, and rollback controls before touching a real ECS deployment. ## When to use Use this skill for: - a real ECS or Fargate service rollout, forced deployment, or task-definition promotion is being considered - you need circuit breaker, alarm, health, and rollback awareness before touching a live service - the user wants operational help for a live ECS change rather than a repo-only task-definition edit ## Lean operating rules - Prefer AwsDocumentationMcpServer when available via uvx awslabs.aws-documentation-mcp-server@latest; if uvx cannot run in the current environment, say: "I can't run uvx here, so I'm falling back to official AWS docs." Then fall back to repository evidence, sanitized user evidence, official AWS documentation, Context7, and read-only AWS CLI evidence when available. - Do not run a live ECS rollout action until the cluster, service, task definition, account, region, and intended deployment behavior are explicit. - Prefer deployment circuit breaker, CloudWatch alarm failure detection, service events, and rollback posture over blind force-new-deployment habits. - If the request skips health checks, bake time, alarm state, or rollback criteria, push back. - Never print secrets, task environment values, or customer identifiers from service output. - Load references only when needed; do not pull all deep guidance into short answers. ## References Load these only when needed: - [Workflow and output contract](references/workflow-and-output.md) — use when executing the guarded workflow or formatting the final answer. - [Safety checklist](references/safety-checklist.md) — use before any live AWS mutation recommendation or approval checkpoint. - [Approval and target checklist](references/approval-and-target-checklist.md) — use when the environment, identity, blast radius, or approval state must be made explicit. - [Official sources](references/official-sources.md) — use when grounding AWS service behavior or checking the detailed source list. ## Response minimum Return, at minimum: - confirmed cluster, service, task definition, account, and region - deployment safety posture including circuit breaker or alarms - the smallest safe next live action or refusal reason - rollback and bake-time notes - post-rollout verification requirements
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.