[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ABFGV0423BTR3AFEVHC083":3,"skill-same:01M7ABFGV0423BTR3AFEVHC083":150},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":46,"repositoryHtmlUrl":47,"repositoryHomepageUrl":6,"ownerHtmlUrl":48,"ownerBlogUrl":6,"ownerDescription":49,"updatedAt":50,"install":51,"resources":64},"01M7ABFGV0423BTR3AFEVHC083","route53-failover-operator",null,"Operates Route 53 health checks and DNS failover workflows end-to-end — health-check configuration (endpoint HTTP\u002FHTTPS\u002FTCP, CloudWatch alarm, calculated AND\u002FOR, insulated child checks), the five failover routing policies (failover, latency, geolocation, multivalue, weighted), planned vs emergency failover and failback sequences, TTL strategy (60s for fast failover vs 300s for stability), cross-account hosted zone IAM, and full diagnostic loops (get-health-check-status, list-resource-record-sets, test-dns-answer, CloudWatch HealthCheckMetrics). Runs deterministic pre-checks (health check healthy, secondary reachable, TTL appropriate, CloudWatch alarm exists, cross-account IAM grant) behind a CONFIRM gate and emits a READY, BLOCKED, or COMPLETED verdict per failover. Use when executing a planned weighted failover, emergency failover, failback, diagnosing a failover that did not switch, or wiring cross-account Route 53.","jhkchan\u002Faws-agent-skills","jhkchan","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1083902?v=4","01M7A2SVQYP9GQTPTDXP5JKYQ4","Jacky Chan","01M7A2SVS117YWCTZABB75HZR1",4,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: route53-failover-operator\ndescription: Operates Route 53 health checks and DNS failover workflows end-to-end — health-check configuration (endpoint HTTP\u002FHTTPS\u002FTCP, CloudWatch alarm, calculated AND\u002FOR, insulated child checks), the five failover routing policies (failover, latency, geolocation, multivalue, weighted), planned vs emergency failover and failback sequences, TTL strategy (60s for fast failover vs 300s for stability), cross-account hosted zone IAM, and full diagnostic loops (get-health-check-status, list-resource-record-sets, test-dns-answer, CloudWatch HealthCheckMetrics). Runs deterministic pre-checks (health check healthy, secondary reachable, TTL appropriate, CloudWatch alarm exists, cross-account IAM grant) behind a CONFIRM gate and emits a READY, BLOCKED, or COMPLETED verdict per failover. Use when executing a planned weighted failover, emergency failover, failback, diagnosing a failover that did not switch, or wiring cross-account Route 53.\nlicense: Apache-2.0\ncompatibility: Agent runtime that reads SKILL.md (Claude Code, Cursor, Windsurf, Codex, Gemini). No AWS CLI required for offline plan classification. Live-account operations use aws route53 list-health-checks, get-health-check, get-health-check-status, list-resource-record-sets, change-resource-record- sets, get-traffic-policy-instance, test-dns-answer, aws cloudwatch describe-alarms, and dig\u002Fnslookup (AWS CLI v2, SSO or key-based credentials).\nmetadata:\n  domain: aws-cloudops\n  complexity: medium\n  requires_llm: 'true'\n  phase: '4'\n  supports_pipeline: 'true'\n  entry_point: 'false'\n  family: Networking\n  task_type: operate\n  skill_class: capability\n  lifecycle_status: active\n  verdict_shape: READY | BLOCKED | COMPLETED\n  when_to_use: Executing a planned DNS failover (weighted 100\u002F0 to 0\u002F100, or swapping failover primary\u002Fsecondary), running an emergency failover, failing back to primary after a failover, diagnosing why a failover did not switch traffic, creating or updating a health check, choosing between failover\u002Flatency\u002Fgeolocation\u002Fmultivalue\u002Fweighted routing for DR, setting TTL for fast failover, or wiring cross-account Route 53 hosted zone access.\n  activation_triggers: failover DNS, switch Route 53 primary secondary, planned failover weighted, emergency failover, failback to primary, Route 53 health check, DNS failover did not switch, traffic not failing over, multivalue answer routing, weighted routing canary, geolocation DR routing, cross-account Route 53 hosted zone, TTL for failover, test-dns-answer\n  invocation_schema: 'Input: either (a) a hosted zone + record set configuration plus the intended operation (planned-failover, emergency-failover, failback, create-health-check, update-health-check, diagnose-failover, update- routing), OR (b) a hosted-zone-id + record-name + operation for live- account execution. Output: deterministic OPERATION \u002F VERDICT \u002F PRE_CHECKS \u002F STEPS \u002F POST_VERIFY \u002F NOTES block per failover, where VERDICT is one of READY, BLOCKED, COMPLETED.'\n  version: 0.1.0\n  author: Jacky Chan — AWS Community Builder\n  keywords: Route 53, DNS failover, health check, failover routing, latency routing, geolocation routing, multivalue answer, weighted routing, primary secondary, DNS TTL, planned failover, emergency failover, failback, cross-account hosted zone, CloudWatch alarm, calculated health check, insulated health check, test-dns-answer, change-resource-record-sets\n  tags: aws, route53, networking, dns, failover, health-check, dr, operate\n---\n\n# Route 53 Failover Operator\n\n## What this skill does\n\nExecutes Route 53 DNS failover operations correctly and safely. Runs\ndeterministic pre-checks before any state-changing CLI (health check\nhealthy, secondary endpoint reachable, TTL appropriate for the failover\nwindow, CloudWatch alarm wired, cross-account IAM grant present), executes\nthe failover behind a CONFIRM gate, and verifies the result by confirming\nthe new record set is authoritative via `test-dns-answer` and the\napplication is reachable on the secondary. Every planned failover produces\na weighted-shift or primary\u002Fsecondary swap plan; every emergency failover\nsurfaces the TTL-lowering step so the operator can shrink the failover\nwindow before flipping routing.\n\n## Quick navigation\n\n| Section | What it covers | When to read it |\n|---|---|---|\n| **§ Quick reference** | Verdict thresholds + pre-check priority | Before any operation |\n| **§ Mindset** | Why failover is TTL-bound, the healthy-but-broken trap, the confirm gate | Understanding the safety model |\n| **§ Pre-flight** | Hosted zone + record set gate — cross-account, recovery window, delegated zones | Before executing any CLI |\n| **§ Process** | Per-operation planning: planned, emergency, failback, health check, diagnose, update-routing | When choosing which operation to run |\n| **§ Output format** | Structured OPERATION\u002FVERDICT\u002FPRE_CHECKS\u002FSTEPS\u002FPOST_VERIFY template | Formatting the response |\n| **§ Anti-Patterns** | NEVER list — common mistakes that strand traffic or break failover | Review before risky operations |\n| **§ Pre-flight safety** | Capture pre-state, confirm gate, DNS propagation verification | Defense-in-depth |\n\n## Quick reference — verdict thresholds\n\n| Verdict | Trigger condition | Action |\n|---|---|---|\n| `BLOCKED` | One or more pre-checks failed (health check unhealthy, secondary unreachable, TTL too high for emergency failover, cross-account IAM denied, hosted zone deleted, primary and secondary both unhealthy) | List failures, do NOT execute |\n| `READY` | All pre-checks passed; awaiting CONFIRM gate | Emit exact CLI sequence, wait for operator yes |\n| `COMPLETED` | Failover finished and post-verification passed (`test-dns-answer` returns secondary IP, primary health check still unhealthy, application reachable on secondary, no client error spike) | Emit verification results, monitoring plan |\n\n**Priority order for pre-checks (apply in this sequence, all must pass for\nREADY):**\n\n1. **Hosted zone reachability** — zone exists, NOT deleted, record set\n   exists with the expected routing policy.\n2. **Health check state** — health check exists; for failover routing the\n   PRIMARY record's health check is monitored. If the primary health check\n   is already unhealthy, Route 53 SHOULD be serving the secondary — verify\n   via `test-dns-answer` before changing anything.\n3. **Secondary endpoint reachability** — secondary IP\u002Fendpoint is actually\n   serving traffic (TCP\u002FHTTP probe from outside Route 53).\n4. **TTL appropriateness** — for emergency failover the record TTL should\n   be \u003C= 60s (or a one-time TTL lower is required first). For planned\n   failover any TTL is acceptable but propagation time = TTL.\n5. **Cross-account IAM** — if the hosted zone is in a different account,\n   the operator's role must have `route53:ChangeResourceRecordSets` on\n   `arn:aws:route53:::hostedzone\u002F\u003Cid>` granted by the zone-owning account.\n6. **CloudWatch alarm wiring** — a CloudWatch alarm on the\n   `AWS\u002FRoute53` `HealthCheckStatus` metric (or the endpoint's uptime\n   metric) exists; without it, the next failover is silent.\n7. **Client-side caching awareness** — browser \u002F OS DNS caches may serve\n   the old IP for up to TTL; the post-failover verification window must\n   account for this.\n\nCost\u002Ftime baselines (endpoint check $0.50 then $0.25 above 100, 10s fast vs 30s standard, TTL propagation, calculated checks free up to 256 children): [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n## Mindset\n\n**One-line takeaway:** a failover is not \"complete\" when the API returns\n`PENDING` — it is complete when `test-dns-answer` returns the secondary\nIP from all configured resolver regions AND application metrics confirm\nthe secondary is serving real traffic. Driven by three Route 53\nrealities:\n\nThe three realities in full (failover speed is TTL-bound; healthy does not mean working; cross-account zones need a zone-owning-account grant): [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n## Pre-flight: hosted zone + record set gate\n\nRun before classification. Misclassifying these produces wrong plans.\n\nPagination limits (list-resource-record-sets 300\u002Fpage, list-health-checks 100\u002Fpage): [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nLive-account pre-flight commands 1-8 (list-hosted-zones-by-name, list-resource-record-sets, get-health-check, get-health-check-status, get-health-check-last-failure-reason, test-dns-answer from multiple resolvers, describe-alarms, cross-account profile check) moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\nLoad on demand before a live-account operation; offline plan audits skip it.\n\nMalformed-input handling (ERROR verdict text and re-fetch remediation): [references\u002Ferror-handling.md](references\u002Ferror-handling.md).\n\n| Attribute | Effect on operation |\n|---|---|\n| Hosted zone `Config.Comment` indicates delegation | Sub-domain delegated to another zone; changes here have no effect on the sub-domain. |\n| Record `RoutingPolicy` is not what the operation expects | Wrong operation. Re-classify: a weighted failover requires `WeightedRoutingPolicy`; a failover swap requires `Failover` records. |\n| Record `TTL > 300` and operation is `emergency-failover` | BLOCKED — lower TTL to 60 first, wait for old TTL to expire (or accept stale traffic). |\n| PRIMARY record `HealthCheckId` is null | BLOCKED — no health check wired; Route 53 always serves PRIMARY. Wire a health check first. |\n| Health check `Status: Healthy` but application is broken | False-healthy trap. Investigate the probe path before relying on the health check for failover decisions. |\n| Health check `Status: Unhealthy` and operation is `planned-failover` | Route 53 may have already failed over. Verify `test-dns-answer` returns secondary before making changes. |\n| Both PRIMARY and SECONDARY health checks `Unhealthy` | BLOCKED — Route 53 returns all records (no healthy target); fix the secondary first. |\n| Cross-account zone and operator role lacks `route53:ChangeResourceRecordSets` | BLOCKED — request the grant from the zone-owning account. |\n| `CalculatorConfig` present (calculated health check) | Verify child health checks individually; the parent's status is AND\u002FOR of children. |\n\n## Process — operation planning (apply in order)\n\n### Step 0: Expert knowledge — non-obvious Route 53 behaviors\n\nThe 17 non-obvious behaviors (3+ checker regions, TTL is the failover contract, paired failover records, weighted vs failover routing, multivalue is not load balancing, latency fallback, geo+failover pairing, calculated checks, insulated child checks, test-dns-answer vs dig, alarm-based checks, cross-account IAM, UPSERT safety, eventual consistency, both-unhealthy last resort) moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\nLoad on demand — each behavior changes a plan if ignored.\n\n### Step 1: Pre-check gate — BLOCKED if any check fails\n\nRun ALL pre-checks for the chosen operation. If ANY fails, the verdict\nis BLOCKED with the failed checks in PRE_CHECKS. Do NOT execute.\n\n**For ALL operations:**\n1. Hosted zone exists (`list-hosted-zones-by-name` returns the zone).\n2. Record set(s) exist with the expected `RoutingPolicy`.\n3. Cross-account IAM grant present (if zone is in another account).\n4. The `ChangeBatch` is well-formed (no duplicate names+types+set-\n   identifiers; `UPSERT` actions specify all required fields for the\n   routing policy).\n\n**For planned-failover (weighted 100\u002F0 -> 0\u002F100):**\n5. Both weighted records exist with `WeightedRoutingPolicy`.\n6. The \"next-primary\" record's endpoint is reachable (TCP\u002FHTTP probe).\n7. The \"next-primary\" record's health check (if any) is `Healthy`.\n8. The current-primary's `TTL` is appropriate for the failover window\n   (recommend \u003C= 300s; 60s for fast).\n\n**For planned-failover (failover routing swap — make OLD primary the\nsecondary, OLD secondary the primary):**\n5. PRIMARY and SECONDARY records exist with `Failover` policy.\n6. PRIMARY health check exists and is currently `Healthy` OR the\n   operator is intentionally inverting the topology (see failback).\n7. The NEW primary (old SECONDARY) endpoint is reachable and its health\n   check (if any) is `Healthy`.\n8. The change-batch upserts BOTH records atomically (PRIMARY and\n   SECONDARY in the same change-batch).\n\n**For emergency-failover:**\n5. PRIMARY health check is `Unhealthy` (the trigger for the emergency).\n6. SECONDARY endpoint is reachable (independent probe outside Route 53).\n7. SECONDARY's health check (if any) is `Healthy`.\n8. TTL of the failover record: if > 60s, the plan must lower TTL first\n   (UPSERT the record with TTL=60, wait old-TTL seconds, THEN swap) —\n   OR the operator explicitly accepts stale-traffic window = old TTL.\n\n**For failback (reverse a prior failover):**\n5. The prior-failover's NEW primary (the secondary during the outage)\n   is currently serving traffic (confirmed via `test-dns-answer`).\n6. The prior PRIMARY's endpoint has been restored and its health check\n   is `Healthy` for at least 2 consecutive intervals (avoid flapping).\n7. TTL is \u003C= 60s for the failback (or accept the stale window).\n8. Application team has signed off on the failback timing.\n\n**For create-health-check \u002F update-health-check:**\n5. The endpoint URL\u002Fport\u002Fpath is reachable from at least one public IP\n   (Route 53 checkers are on the public internet).\n6. For HTTPS checks, the certificate is valid (not expired, hostname\n   matches). Route 53 does NOT validate the cert by default — enable\n   `EnableSNIProvisionally` and check `EnableSNI` for SNI support.\n7. For search-string checks, the response body contains the string when\n   healthy.\n8. For CloudWatch-alarm-based checks, the alarm exists in the same\n   region as the health check's CloudWatch metric.\n9. For calculated checks, `ChildHealthChecks` references valid health\n   check IDs and `InsufficientDataHealthStatus` is set intentionally.\n\n**For diagnose-failover (read-only, no BLOCKED gate):**\n5. Read `get-health-check-status`, `test-dns-answer`, and the failure-\n   mode table to identify the root cause.\n\n**For update-routing (change routing policy or weights):**\n5. New `RoutingPolicy` is valid for the record type (A\u002FAAAA only for\n   multivalue; any for weighted\u002Flatency\u002Fgeolocation\u002Ffailover).\n6. New weights sum to a sensible total (Route 53 normalizes, but a\n   0-weight record gets NO traffic).\n7. If changing FROM `WeightedRoutingPolicy` TO `Failover`, the change\n   batch must DELETE the weighted records and CREATE the failover\n   pair (you cannot UPSERT across routing policies).\n\n**Failover failure-mode table (use during diagnose-failover):**\n\nFailover failure-mode table (stale test-dns-answer, false-healthy probe, missing HealthCheckId, both records returned, checker IP blocks, string-not-found, cross-account AccessDenied, resolver cache, latency DB staleness, 0-weight, PENDING stuck): [references\u002Ferror-handling.md](references\u002Ferror-handling.md).\n\n### Step 2: READY — emit operation plan\n\nIf all pre-checks pass, emit `VERDICT: READY` with the exact CLI\nsequence and the CONFIRM gate. The plan includes:\n\nWhat a READY plan includes (change-batch JSON, propagation estimate, side-effects, CONFIRM gate, verification): [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n### Step 3: Execute behind CONFIRM gate\n\n- **MANDATORY CONFIRMATION GATE.** Before any state-changing CLI\n  (`change-resource-record-sets`, `update-health-check`,\n  `delete-health-check`, `create-health-check`), emit:\n  `CONFIRM: About to \u003Coperation> on \u003Cfqdn> in hosted zone \u003Cid> (account\n  \u003Caccount> region global). This will \u003Cconsequence>. Proceed? (yes\u002Fno)`.\n  Do NOT execute until the operator confirms.\nPre-state capture commands (record-set + test-dns-answer JSON snapshots) and get-change polling until INSYNC: [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\n### Step 4: Post-verification — COMPLETED\n\nAfter the change reaches INSYNC, run post-verification. ALL checks must\npass for `COMPLETED`.\n\nPost-verification probes 1-6 (test-dns-answer from three resolvers, dig +short, health check status, traffic shift metrics, weight distribution, old-IP absence): [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf ANY verification fails, emit `VERDICT: ERROR` with the failure\ndetails — do not claim COMPLETED. A failed verification typically means\nDNS caching is still serving the old IP (wait longer) or the change-\nbatch did not apply as expected (inspect the INSYNC record set).\n\n## Output format (per operation)\n\nCanonical OPERATION\u002FVERDICT\u002FPRE_CHECKS\u002FSTEPS\u002FPOST_VERIFY\u002FNOTES template: [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\nThe STRICT output contract below is authoritative.\n\n### Worked example — planned-failover (weighted 100\u002F0 -> 0\u002F100)\n\nFull worked example (planned weighted 100\u002F0 -> 0\u002F100 flip, READY): [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\nThe Perfect example output in the STRICT contract below shows the same shape.\n\nFull worked example (emergency failover with Phase 1 TTL lowering and Phase 2 topology swap): moved verbatim to [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\n\nFull worked example (diagnose-failover BLOCKED because the secondary is also down, with fix order): moved verbatim to [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\n\n## STRICT output contract\n\nThis section codifies the exact output shape the eval harness asserts\nagainst. Every invocation MUST produce output that matches this\ncontract or the response is rejected. The labels are case-sensitive\nall-caps keywords — no markdown styling, no lowercase variants.\n\n### Required output structure\n\nEvery response MUST be a single block with these literal labels, in\nthis order:\n\n```text\nOPERATION: \u003Cplanned-failover | emergency-failover | failback | create-health-check | update-health-check | diagnose-failover | update-routing>\nVERDICT: READY | BLOCKED | COMPLETED\nTARGET: \u003Cfqdn> (hosted zone: \u003Cid>, routing policy: \u003Cpolicy>)\nPRE_CHECKS:\n  - [PASS|FAIL|WARN|INFO] \u003Ccheck description>\nSTEPS:\n  1. \u003CCONFIRM gate prompt>\n  2. \u003CCLI command or change-batch JSON with all fields populated>\n  3. \u003Cwait \u002F monitoring command>\nPOST_VERIFY:\n  - [PASS|FAIL] \u003Cverification description>\nNOTES: \u003CTTL, propagation estimate, monitoring, caveats>\n```\n\n### FORBIDDEN output patterns\n\n1. **NEVER output READY without verifying the health check status\n   (get-health-check-status).** The health check observation status\n   is the single most critical pre-check — a READY verdict without an\n   explicit `[PASS] Health check \u003Cid> Status: Healthy|Unhealthy` row\n   in PRE_CHECKS is rejected. The status must come from\n   `get-health-check-status`, not `get-health-check` (which returns\n   config, not runtime state).\n\n2. **NEVER recommend a TTL > 300 for failover scenarios — low TTL\n   (60s) is required for fast failover.** A plan that emits a\n   failover record with TTL > 300 and does not include a TTL-lowering\n   step first is a hard failure. For emergency failover with existing\n   TTL > 60s, the plan MUST include Phase 1 (lower TTL) before Phase 2\n   (topology swap).\n\n3. **NEVER confuse weighted routing with failover routing — weighted\n   shifts traffic gradually, failover is binary.** A plan that uses\n   `Failover: PRIMARY\u002FSECONDARY` records for a canary deployment, or\n   uses `WeightedRoutingPolicy` for an automatic failover, is\n   misclassified. The OPERATION label and the record routing policy\n   must be consistent.\n\n4. **NEVER emit STEPS without a CONFIRM gate preceding any\n   state-changing CLI command.** Every STEPS block that includes\n   `change-resource-record-sets`, `create-health-check`,\n   `update-health-check`, or `delete-health-check` MUST have a\n   `CONFIRM: About to \u003Coperation>...` prompt as the first step.\n   Auto-executing without the gate is a hard failure.\n\n5. **NEVER omit POST_VERIFY verification commands — a failover is\n   COMPLETED only after `test-dns-answer` confirms the new IP.** A\n   verdict of COMPLETED without `[PASS] test-dns-answer returns\n   \u003Cnew-IP>` in POST_VERIFY is rejected. INSYNC from the API is not\n   sufficient — recursive resolvers cache up to TTL.\n\n6. **NEVER submit a change-batch that UPSERTs only one record of a\n   failover pair.** PRIMARY and SECONDARY must be in the SAME\n   `change-resource-record-sets` batch — splitting them creates a\n   window where neither record is in a consistent state.\n\n### Perfect example output\n\n```text\nOPERATION: planned-failover\nVERDICT: READY\nTARGET: api.example.com (hosted zone: Z2ABCDEFGHIJK, routing policy: weighted)\nPRE_CHECKS:\n  - [PASS] Hosted zone Z2ABCDEFGHIJK exists, not deleted\n  - [PASS] Weighted records found:\n    api.example.com A SetIdentifier=blue  Weight=100  Value=10.0.0.10\n    api.example.com A SetIdentifier=green Weight=0    Value=10.0.1.10\n  - [PASS] Green endpoint 10.0.1.10 reachable on port 443 (TCP probe OK)\n  - [PASS] Green health check h-abcdef1234 Status: Healthy\n  - [PASS] Current TTL: 60s (acceptable for fast failover)\n  - [PASS] Cross-account IAM: operator role authorized in zone account\n  - [PASS] CloudWatch alarm api-example-failover exists on\n    AWS\u002FRoute53 HealthCheckStatus\nSTEPS:\n  1. CONFIRM: About to flip weighted routing on api.example.com in\n     hosted zone Z2ABCDEFGHIJK (account 111111111111, global Route 53).\n     Blue weight 100->0; Green weight 0->100. Traffic will shift from\n     10.0.0.10 (blue) to 10.0.1.10 (green). DNS propagation bounded by\n     60s TTL. Proceed? (yes\u002Fno)\n  2. aws route53 change-resource-record-sets \\\n       --hosted-zone-id Z2ABCDEFGHIJK \\\n       --change-batch '{\n         \"Changes\": [\n           {\"Action\":\"UPSERT\",\"ResourceRecordSet\":{\n             \"Name\":\"api.example.com.\",\"Type\":\"A\",\n             \"SetIdentifier\":\"blue\",\"Weight\":0,\n             \"TTL\":60,\"ResourceRecords\":[{\"Value\":\"10.0.0.10\"}],\n             \"HealthCheckId\":\"h-blue123\"}},\n           {\"Action\":\"UPSERT\",\"ResourceRecordSet\":{\n             \"Name\":\"api.example.com.\",\"Type\":\"A\",\n             \"SetIdentifier\":\"green\",\"Weight\":100,\n             \"TTL\":60,\"ResourceRecords\":[{\"Value\":\"10.0.1.10\"}],\n             \"HealthCheckId\":\"h-abcdef1234\"}}\n         ]\n       }'\n  3. Capture ChangeInfo.Id; poll:\n     aws route53 get-change --id \u003Cchange-id>\n     until Status: INSYNC (typically 5-30 seconds).\nPOST_VERIFY:\n  - (pending execution)\nNOTES:\n  - DNS propagation: up to 60s for cached recursive resolvers (TTL).\n    Uncached resolvers see the new answer within seconds of INSYNC.\n  - Rollback: re-run the same change-batch with weights inverted\n    (blue=100, green=0). Keep the rollback command ready.\n  - Watch the application error-rate dashboard for 2x TTL post-change\n    (120s) to catch a bad green deployment before declaring COMPLETED.\n```\n\n## Anti-Patterns — NEVER\n\n- NEVER submit an emergency failover change-batch without first lowering\n  the TTL to 60s (or explicitly accepting the stale-traffic window =\n  old TTL). A 300s TTL means up to 5 minutes of traffic continues to\n  the down primary even after Route 53 stops returning it.\n\n- NEVER assume `Status: INSYNC` from `ChangeResourceRecordSets` means\n  clients see the new IP. INSYNC means Route 53's authoritative servers\n  have the change. Recursive resolvers and OS DNS caches serve stale\n  answers up to TTL. Verify with `dig` from multiple resolvers.\n\n- NEVER trust a single health check as the sole failover trigger. A\n  shallow probe (`\u002Fhealth` returning 200) reports healthy even when the\n  app is broken everywhere else. Pair with a calculated health check\n  (AND) that includes a CloudWatch alarm on a real business metric.\n\n- NEVER operate failover routing without a SECONDARY record. A PRIMARY\n  record alone, when unhealthy, causes Route 53 to return NO answer\n  (NXDOMAIN-like behavior for that record). The failover contract\n  requires the pair.\n\n- NEVER submit a change-batch that UPSERTs only one of the failover\n  pair. PRIMARY and SECONDARY must be updated in the SAME change-batch\n  (Route 53 applies changes atomically within a batch). Splitting them\n  risks a window where neither record is in a consistent state.\n\n- NEVER delete a health check that is still associated with a record\n  set. Route 53 will treat the record as always-healthy (or always-\n  unhealthy depending on policy) once the check is gone. Always\n  disassociate (`UPSERT` the record without `HealthCheckId`) before\n  `delete-health-check`.\n\n- NEVER use weighted routing with a 0-weight on BOTH records. Route 53\n  returns nothing for the name. At least one record must have weight\n  >= 1.\n\n- NEVER assume a cross-account operator role has Route 53 access by\n  default. The zone-owning account MUST grant the operator's role ARN\n  via an inline policy or RAM share. Identity-based policies in the\n  operator account are not sufficient on their own.\n\n- NEVER rely on `dig` from a single network for failover verification.\n  Different recursive resolvers cache independently. Probe at least\n  `1.1.1.1`, `8.8.8.8`, and `9.9.9.9`. Use `test-dns-answer` for\n  authoritative truth.\n\n- NEVER use `CREATE` action in a failover change-batch when the record\n  might already exist. `CREATE` fails if the record exists. Use\n  `UPSERT`. Use `DELETE` only when you intend to remove the record.\n\n- NEVER treat multivalue answer routing as load balancing. It returns\n  up to 8 healthy IPs per query, shuffled, but clients pick one and\n  stick with it. Multivalue is for spreading load across many\n  endpoints, not for primary\u002Fsecondary failover.\n\n- NEVER assume latency routing will fail over. It falls back to the\n  next-lowest-latency healthy region automatically. There is no\n  explicit failover record needed. But if ALL regions are unhealthy,\n  latency routing returns all records (last-resort).\n\n- NEVER change routing policy (e.g., from Weighted to Failover) via a\n  single UPSERT. Routing policy is fixed per record. You must DELETE\n  the old-policy record(s) and CREATE the new-policy record(s) in the\n  same change-batch.\n\n- NEVER auto-execute a state-changing Route 53 CLI without the CONFIRM\n  gate. Failovers have traffic-shifting side effects that can storm\n  the workload if the target is unprepared.\n\n- NEVER failback to a primary that has been Healthy for less than 2\n  consecutive health check intervals. A flapping primary causes\n  repeated failover\u002Ffailback cycles that destabilize the workload.\n\n- NEVER block on a calculated health check's `InsufficientDataHealthStatus`\n  default. If child checks have insufficient data, the calculated\n  check's behavior depends on this setting (Healthy\u002FUnhealthy\u002FLastKnown-\n  GoodStatus). Set it explicitly to match the workload's risk tolerance.\n\n## Pre-flight safety checks (run before any remediation CLI)\n\n- **MANDATORY CONFIRMATION GATE.** Before any state-changing operation\n  (`change-resource-record-sets`, `create-health-check`,\n  `update-health-check`, `delete-health-check`), emit: `CONFIRM: About\n  to \u003Coperation> on \u003Cfqdn> in hosted zone \u003Cid> (account \u003Caccount>,\n  global Route 53). This will \u003Cconsequence>. Proceed? (yes\u002Fno)`. Do\n  NOT execute until the operator confirms.\n\n- **Capture pre-state for rollback.** Before any failover:\n  `aws route53 list-resource-record-sets --hosted-zone-id \u003Cid> --output\n  json > \u002Ftmp\u002F\u003Cid>-rrsets-pre-$(date +%s).json` AND `aws route53\n  test-dns-answer --hosted-zone-id \u003Cid> --record-name \u003Cfqdn>\n  --record-type A --resolver-ip 1.1.1.1 --output json > \u002Ftmp\u002F\u003Cfqdn>-\n  dnsanswer-pre-$(date +%s).json`. These captures are critical for\n  rollback — if the failover makes things worse, you need the exact\n  pre-change record set to revert.\n\n- **Verify the failover target is healthy before swapping.** For\n  planned and failback operations, the new primary's health check must\n  be `Healthy` for >= 2 consecutive intervals. For emergency\n  operations, the secondary endpoint must be independently reachable\n  even if no health check is wired.\n\n- **Verify the change-batch is well-formed.** All records in a\n  failover pair must be in the same change-batch. `UPSERT` actions\n  must specify `Name`, `Type`, `TTL`, and the routing-policy-specific\n  fields (`Weight`, `Failover`, `Region`, `GeoLocation`, or\n  `MultiValueAnswer`).\n\n- **Prefer additive changes over destructive ones.** Lowering TTL,\n  adding a SECONDARY record, and creating a health check are\n  reversible. DELETing a record or a health check is hard to reverse —\n  do it only after confirming the new state is stable.\n\n- **Poll `get-change` until `INSYNC`.** The `ChangeResourceRecordSets`\n  API returns immediately with `PENDING`. Authoritative DNS only\n  reflects the change after `INSYNC`. Do not declare COMPLETED based\n  on the API response alone.\n\n## Recent AWS features (2024-2026)\n\nRecent AWS features (EnableSNI GA, alarm-based checks, InsufficientDataHealthStatus, insulated child checks, RAM cross-account sharing, test-dns-answer multiple resolver IPs, Resolver DNS Firewall, CidrRoutingConfig): [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n## References (load on demand)\n\n- [Advanced patterns](references\u002Fadvanced-patterns.md) — cost\u002Ftime baselines, mindset realities, Step 0 non-obvious behaviors, READY plan contents, recent AWS features\n- [Diagnostic commands](references\u002Fdiagnostic-commands.md) — pagination limits, live-account pre-flight, pre-state capture, post-verification probes\n- [Error handling](references\u002Ferror-handling.md) — malformed input handling, failover failure-mode table\n- [Worked examples](references\u002Fworked-examples.md) — canonical output template, planned-failover, emergency-failover, diagnose-failover examples\n- [Failover routing policies](references\u002Ffailover-routing-policies.md) — routing policy semantics reference\n- [Health check procedures](references\u002Fhealth-check-procedures.md) — health check create\u002Fupdate procedures\n\n## Domain\n\nAWS CloudOps \u002F Route 53 DNS Failover, Health Checks & Disaster Recovery.\n\n## AWS documentation\n\n- **Route 53 Developer Guide** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002F\n- **Health checks** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Fdns-failover-determining-health-of-endpoints.html\n- **Routing policies** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Frouting-policy.html\n- **Configuring DNS failover** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Fdns-failover.html\n- **Calculated health checks** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Fhealth-checks-type-calc.html\n- **Cross-account hosted zones** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002FCross-Account-Zones.html\n- **Route 53 API Reference** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FAPIReference\u002F\n- **Route 53 CLI Reference** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fcli\u002Flatest\u002Freference\u002Froute53\u002F\n- **Route 53 checker IP ranges** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Froute-53-ip-addresses.html\n","# Route 53 Failover Operator\n\n## What this skill does\n\nExecutes Route 53 DNS failover operations correctly and safely. Runs\ndeterministic pre-checks before any state-changing CLI (health check\nhealthy, secondary endpoint reachable, TTL appropriate for the failover\nwindow, CloudWatch alarm wired, cross-account IAM grant present), executes\nthe failover behind a CONFIRM gate, and verifies the result by confirming\nthe new record set is authoritative via `test-dns-answer` and the\napplication is reachable on the secondary. Every planned failover produces\na weighted-shift or primary\u002Fsecondary swap plan; every emergency failover\nsurfaces the TTL-lowering step so the operator can shrink the failover\nwindow before flipping routing.\n\n## Quick navigation\n\n| Section | What it covers | When to read it |\n|---|---|---|\n| **§ Quick reference** | Verdict thresholds + pre-check priority | Before any operation |\n| **§ Mindset** | Why failover is TTL-bound, the healthy-but-broken trap, the confirm gate | Understanding the safety model |\n| **§ Pre-flight** | Hosted zone + record set gate — cross-account, recovery window, delegated zones | Before executing any CLI |\n| **§ Process** | Per-operation planning: planned, emergency, failback, health check, diagnose, update-routing | When choosing which operation to run |\n| **§ Output format** | Structured OPERATION\u002FVERDICT\u002FPRE_CHECKS\u002FSTEPS\u002FPOST_VERIFY template | Formatting the response |\n| **§ Anti-Patterns** | NEVER list — common mistakes that strand traffic or break failover | Review before risky operations |\n| **§ Pre-flight safety** | Capture pre-state, confirm gate, DNS propagation verification | Defense-in-depth |\n\n## Quick reference — verdict thresholds\n\n| Verdict | Trigger condition | Action |\n|---|---|---|\n| `BLOCKED` | One or more pre-checks failed (health check unhealthy, secondary unreachable, TTL too high for emergency failover, cross-account IAM denied, hosted zone deleted, primary and secondary both unhealthy) | List failures, do NOT execute |\n| `READY` | All pre-checks passed; awaiting CONFIRM gate | Emit exact CLI sequence, wait for operator yes |\n| `COMPLETED` | Failover finished and post-verification passed (`test-dns-answer` returns secondary IP, primary health check still unhealthy, application reachable on secondary, no client error spike) | Emit verification results, monitoring plan |\n\n**Priority order for pre-checks (apply in this sequence, all must pass for\nREADY):**\n\n1. **Hosted zone reachability** — zone exists, NOT deleted, record set\n   exists with the expected routing policy.\n2. **Health check state** — health check exists; for failover routing the\n   PRIMARY record's health check is monitored. If the primary health check\n   is already unhealthy, Route 53 SHOULD be serving the secondary — verify\n   via `test-dns-answer` before changing anything.\n3. **Secondary endpoint reachability** — secondary IP\u002Fendpoint is actually\n   serving traffic (TCP\u002FHTTP probe from outside Route 53).\n4. **TTL appropriateness** — for emergency failover the record TTL should\n   be \u003C= 60s (or a one-time TTL lower is required first). For planned\n   failover any TTL is acceptable but propagation time = TTL.\n5. **Cross-account IAM** — if the hosted zone is in a different account,\n   the operator's role must have `route53:ChangeResourceRecordSets` on\n   `arn:aws:route53:::hostedzone\u002F\u003Cid>` granted by the zone-owning account.\n6. **CloudWatch alarm wiring** — a CloudWatch alarm on the\n   `AWS\u002FRoute53` `HealthCheckStatus` metric (or the endpoint's uptime\n   metric) exists; without it, the next failover is silent.\n7. **Client-side caching awareness** — browser \u002F OS DNS caches may serve\n   the old IP for up to TTL; the post-failover verification window must\n   account for this.\n\nCost\u002Ftime baselines (endpoint check $0.50 then $0.25 above 100, 10s fast vs 30s standard, TTL propagation, calculated checks free up to 256 children): [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n## Mindset\n\n**One-line takeaway:** a failover is not \"complete\" when the API returns\n`PENDING` — it is complete when `test-dns-answer` returns the secondary\nIP from all configured resolver regions AND application metrics confirm\nthe secondary is serving real traffic. Driven by three Route 53\nrealities:\n\nThe three realities in full (failover speed is TTL-bound; healthy does not mean working; cross-account zones need a zone-owning-account grant): [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n## Pre-flight: hosted zone + record set gate\n\nRun before classification. Misclassifying these produces wrong plans.\n\nPagination limits (list-resource-record-sets 300\u002Fpage, list-health-checks 100\u002Fpage): [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nLive-account pre-flight commands 1-8 (list-hosted-zones-by-name, list-resource-record-sets, get-health-check, get-health-check-status, get-health-check-last-failure-reason, test-dns-answer from multiple resolvers, describe-alarms, cross-account profile check) moved verbatim to [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\nLoad on demand before a live-account operation; offline plan audits skip it.\n\nMalformed-input handling (ERROR verdict text and re-fetch remediation): [references\u002Ferror-handling.md](references\u002Ferror-handling.md).\n\n| Attribute | Effect on operation |\n|---|---|\n| Hosted zone `Config.Comment` indicates delegation | Sub-domain delegated to another zone; changes here have no effect on the sub-domain. |\n| Record `RoutingPolicy` is not what the operation expects | Wrong operation. Re-classify: a weighted failover requires `WeightedRoutingPolicy`; a failover swap requires `Failover` records. |\n| Record `TTL > 300` and operation is `emergency-failover` | BLOCKED — lower TTL to 60 first, wait for old TTL to expire (or accept stale traffic). |\n| PRIMARY record `HealthCheckId` is null | BLOCKED — no health check wired; Route 53 always serves PRIMARY. Wire a health check first. |\n| Health check `Status: Healthy` but application is broken | False-healthy trap. Investigate the probe path before relying on the health check for failover decisions. |\n| Health check `Status: Unhealthy` and operation is `planned-failover` | Route 53 may have already failed over. Verify `test-dns-answer` returns secondary before making changes. |\n| Both PRIMARY and SECONDARY health checks `Unhealthy` | BLOCKED — Route 53 returns all records (no healthy target); fix the secondary first. |\n| Cross-account zone and operator role lacks `route53:ChangeResourceRecordSets` | BLOCKED — request the grant from the zone-owning account. |\n| `CalculatorConfig` present (calculated health check) | Verify child health checks individually; the parent's status is AND\u002FOR of children. |\n\n## Process — operation planning (apply in order)\n\n### Step 0: Expert knowledge — non-obvious Route 53 behaviors\n\nThe 17 non-obvious behaviors (3+ checker regions, TTL is the failover contract, paired failover records, weighted vs failover routing, multivalue is not load balancing, latency fallback, geo+failover pairing, calculated checks, insulated child checks, test-dns-answer vs dig, alarm-based checks, cross-account IAM, UPSERT safety, eventual consistency, both-unhealthy last resort) moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\nLoad on demand — each behavior changes a plan if ignored.\n\n### Step 1: Pre-check gate — BLOCKED if any check fails\n\nRun ALL pre-checks for the chosen operation. If ANY fails, the verdict\nis BLOCKED with the failed checks in PRE_CHECKS. Do NOT execute.\n\n**For ALL operations:**\n1. Hosted zone exists (`list-hosted-zones-by-name` returns the zone).\n2. Record set(s) exist with the expected `RoutingPolicy`.\n3. Cross-account IAM grant present (if zone is in another account).\n4. The `ChangeBatch` is well-formed (no duplicate names+types+set-\n   identifiers; `UPSERT` actions specify all required fields for the\n   routing policy).\n\n**For planned-failover (weighted 100\u002F0 -> 0\u002F100):**\n5. Both weighted records exist with `WeightedRoutingPolicy`.\n6. The \"next-primary\" record's endpoint is reachable (TCP\u002FHTTP probe).\n7. The \"next-primary\" record's health check (if any) is `Healthy`.\n8. The current-primary's `TTL` is appropriate for the failover window\n   (recommend \u003C= 300s; 60s for fast).\n\n**For planned-failover (failover routing swap — make OLD primary the\nsecondary, OLD secondary the primary):**\n5. PRIMARY and SECONDARY records exist with `Failover` policy.\n6. PRIMARY health check exists and is currently `Healthy` OR the\n   operator is intentionally inverting the topology (see failback).\n7. The NEW primary (old SECONDARY) endpoint is reachable and its health\n   check (if any) is `Healthy`.\n8. The change-batch upserts BOTH records atomically (PRIMARY and\n   SECONDARY in the same change-batch).\n\n**For emergency-failover:**\n5. PRIMARY health check is `Unhealthy` (the trigger for the emergency).\n6. SECONDARY endpoint is reachable (independent probe outside Route 53).\n7. SECONDARY's health check (if any) is `Healthy`.\n8. TTL of the failover record: if > 60s, the plan must lower TTL first\n   (UPSERT the record with TTL=60, wait old-TTL seconds, THEN swap) —\n   OR the operator explicitly accepts stale-traffic window = old TTL.\n\n**For failback (reverse a prior failover):**\n5. The prior-failover's NEW primary (the secondary during the outage)\n   is currently serving traffic (confirmed via `test-dns-answer`).\n6. The prior PRIMARY's endpoint has been restored and its health check\n   is `Healthy` for at least 2 consecutive intervals (avoid flapping).\n7. TTL is \u003C= 60s for the failback (or accept the stale window).\n8. Application team has signed off on the failback timing.\n\n**For create-health-check \u002F update-health-check:**\n5. The endpoint URL\u002Fport\u002Fpath is reachable from at least one public IP\n   (Route 53 checkers are on the public internet).\n6. For HTTPS checks, the certificate is valid (not expired, hostname\n   matches). Route 53 does NOT validate the cert by default — enable\n   `EnableSNIProvisionally` and check `EnableSNI` for SNI support.\n7. For search-string checks, the response body contains the string when\n   healthy.\n8. For CloudWatch-alarm-based checks, the alarm exists in the same\n   region as the health check's CloudWatch metric.\n9. For calculated checks, `ChildHealthChecks` references valid health\n   check IDs and `InsufficientDataHealthStatus` is set intentionally.\n\n**For diagnose-failover (read-only, no BLOCKED gate):**\n5. Read `get-health-check-status`, `test-dns-answer`, and the failure-\n   mode table to identify the root cause.\n\n**For update-routing (change routing policy or weights):**\n5. New `RoutingPolicy` is valid for the record type (A\u002FAAAA only for\n   multivalue; any for weighted\u002Flatency\u002Fgeolocation\u002Ffailover).\n6. New weights sum to a sensible total (Route 53 normalizes, but a\n   0-weight record gets NO traffic).\n7. If changing FROM `WeightedRoutingPolicy` TO `Failover`, the change\n   batch must DELETE the weighted records and CREATE the failover\n   pair (you cannot UPSERT across routing policies).\n\n**Failover failure-mode table (use during diagnose-failover):**\n\nFailover failure-mode table (stale test-dns-answer, false-healthy probe, missing HealthCheckId, both records returned, checker IP blocks, string-not-found, cross-account AccessDenied, resolver cache, latency DB staleness, 0-weight, PENDING stuck): [references\u002Ferror-handling.md](references\u002Ferror-handling.md).\n\n### Step 2: READY — emit operation plan\n\nIf all pre-checks pass, emit `VERDICT: READY` with the exact CLI\nsequence and the CONFIRM gate. The plan includes:\n\nWhat a READY plan includes (change-batch JSON, propagation estimate, side-effects, CONFIRM gate, verification): [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n### Step 3: Execute behind CONFIRM gate\n\n- **MANDATORY CONFIRMATION GATE.** Before any state-changing CLI\n  (`change-resource-record-sets`, `update-health-check`,\n  `delete-health-check`, `create-health-check`), emit:\n  `CONFIRM: About to \u003Coperation> on \u003Cfqdn> in hosted zone \u003Cid> (account\n  \u003Caccount> region global). This will \u003Cconsequence>. Proceed? (yes\u002Fno)`.\n  Do NOT execute until the operator confirms.\nPre-state capture commands (record-set + test-dns-answer JSON snapshots) and get-change polling until INSYNC: [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\n### Step 4: Post-verification — COMPLETED\n\nAfter the change reaches INSYNC, run post-verification. ALL checks must\npass for `COMPLETED`.\n\nPost-verification probes 1-6 (test-dns-answer from three resolvers, dig +short, health check status, traffic shift metrics, weight distribution, old-IP absence): [references\u002Fdiagnostic-commands.md](references\u002Fdiagnostic-commands.md).\n\nIf ANY verification fails, emit `VERDICT: ERROR` with the failure\ndetails — do not claim COMPLETED. A failed verification typically means\nDNS caching is still serving the old IP (wait longer) or the change-\nbatch did not apply as expected (inspect the INSYNC record set).\n\n## Output format (per operation)\n\nCanonical OPERATION\u002FVERDICT\u002FPRE_CHECKS\u002FSTEPS\u002FPOST_VERIFY\u002FNOTES template: [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\nThe STRICT output contract below is authoritative.\n\n### Worked example — planned-failover (weighted 100\u002F0 -> 0\u002F100)\n\nFull worked example (planned weighted 100\u002F0 -> 0\u002F100 flip, READY): [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\nThe Perfect example output in the STRICT contract below shows the same shape.\n\nFull worked example (emergency failover with Phase 1 TTL lowering and Phase 2 topology swap): moved verbatim to [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\n\nFull worked example (diagnose-failover BLOCKED because the secondary is also down, with fix order): moved verbatim to [references\u002Fworked-examples.md](references\u002Fworked-examples.md).\n\n## STRICT output contract\n\nThis section codifies the exact output shape the eval harness asserts\nagainst. Every invocation MUST produce output that matches this\ncontract or the response is rejected. The labels are case-sensitive\nall-caps keywords — no markdown styling, no lowercase variants.\n\n### Required output structure\n\nEvery response MUST be a single block with these literal labels, in\nthis order:\n\n```text\nOPERATION: \u003Cplanned-failover | emergency-failover | failback | create-health-check | update-health-check | diagnose-failover | update-routing>\nVERDICT: READY | BLOCKED | COMPLETED\nTARGET: \u003Cfqdn> (hosted zone: \u003Cid>, routing policy: \u003Cpolicy>)\nPRE_CHECKS:\n  - [PASS|FAIL|WARN|INFO] \u003Ccheck description>\nSTEPS:\n  1. \u003CCONFIRM gate prompt>\n  2. \u003CCLI command or change-batch JSON with all fields populated>\n  3. \u003Cwait \u002F monitoring command>\nPOST_VERIFY:\n  - [PASS|FAIL] \u003Cverification description>\nNOTES: \u003CTTL, propagation estimate, monitoring, caveats>\n```\n\n### FORBIDDEN output patterns\n\n1. **NEVER output READY without verifying the health check status\n   (get-health-check-status).** The health check observation status\n   is the single most critical pre-check — a READY verdict without an\n   explicit `[PASS] Health check \u003Cid> Status: Healthy|Unhealthy` row\n   in PRE_CHECKS is rejected. The status must come from\n   `get-health-check-status`, not `get-health-check` (which returns\n   config, not runtime state).\n\n2. **NEVER recommend a TTL > 300 for failover scenarios — low TTL\n   (60s) is required for fast failover.** A plan that emits a\n   failover record with TTL > 300 and does not include a TTL-lowering\n   step first is a hard failure. For emergency failover with existing\n   TTL > 60s, the plan MUST include Phase 1 (lower TTL) before Phase 2\n   (topology swap).\n\n3. **NEVER confuse weighted routing with failover routing — weighted\n   shifts traffic gradually, failover is binary.** A plan that uses\n   `Failover: PRIMARY\u002FSECONDARY` records for a canary deployment, or\n   uses `WeightedRoutingPolicy` for an automatic failover, is\n   misclassified. The OPERATION label and the record routing policy\n   must be consistent.\n\n4. **NEVER emit STEPS without a CONFIRM gate preceding any\n   state-changing CLI command.** Every STEPS block that includes\n   `change-resource-record-sets`, `create-health-check`,\n   `update-health-check`, or `delete-health-check` MUST have a\n   `CONFIRM: About to \u003Coperation>...` prompt as the first step.\n   Auto-executing without the gate is a hard failure.\n\n5. **NEVER omit POST_VERIFY verification commands — a failover is\n   COMPLETED only after `test-dns-answer` confirms the new IP.** A\n   verdict of COMPLETED without `[PASS] test-dns-answer returns\n   \u003Cnew-IP>` in POST_VERIFY is rejected. INSYNC from the API is not\n   sufficient — recursive resolvers cache up to TTL.\n\n6. **NEVER submit a change-batch that UPSERTs only one record of a\n   failover pair.** PRIMARY and SECONDARY must be in the SAME\n   `change-resource-record-sets` batch — splitting them creates a\n   window where neither record is in a consistent state.\n\n### Perfect example output\n\n```text\nOPERATION: planned-failover\nVERDICT: READY\nTARGET: api.example.com (hosted zone: Z2ABCDEFGHIJK, routing policy: weighted)\nPRE_CHECKS:\n  - [PASS] Hosted zone Z2ABCDEFGHIJK exists, not deleted\n  - [PASS] Weighted records found:\n    api.example.com A SetIdentifier=blue  Weight=100  Value=10.0.0.10\n    api.example.com A SetIdentifier=green Weight=0    Value=10.0.1.10\n  - [PASS] Green endpoint 10.0.1.10 reachable on port 443 (TCP probe OK)\n  - [PASS] Green health check h-abcdef1234 Status: Healthy\n  - [PASS] Current TTL: 60s (acceptable for fast failover)\n  - [PASS] Cross-account IAM: operator role authorized in zone account\n  - [PASS] CloudWatch alarm api-example-failover exists on\n    AWS\u002FRoute53 HealthCheckStatus\nSTEPS:\n  1. CONFIRM: About to flip weighted routing on api.example.com in\n     hosted zone Z2ABCDEFGHIJK (account 111111111111, global Route 53).\n     Blue weight 100->0; Green weight 0->100. Traffic will shift from\n     10.0.0.10 (blue) to 10.0.1.10 (green). DNS propagation bounded by\n     60s TTL. Proceed? (yes\u002Fno)\n  2. aws route53 change-resource-record-sets \\\n       --hosted-zone-id Z2ABCDEFGHIJK \\\n       --change-batch '{\n         \"Changes\": [\n           {\"Action\":\"UPSERT\",\"ResourceRecordSet\":{\n             \"Name\":\"api.example.com.\",\"Type\":\"A\",\n             \"SetIdentifier\":\"blue\",\"Weight\":0,\n             \"TTL\":60,\"ResourceRecords\":[{\"Value\":\"10.0.0.10\"}],\n             \"HealthCheckId\":\"h-blue123\"}},\n           {\"Action\":\"UPSERT\",\"ResourceRecordSet\":{\n             \"Name\":\"api.example.com.\",\"Type\":\"A\",\n             \"SetIdentifier\":\"green\",\"Weight\":100,\n             \"TTL\":60,\"ResourceRecords\":[{\"Value\":\"10.0.1.10\"}],\n             \"HealthCheckId\":\"h-abcdef1234\"}}\n         ]\n       }'\n  3. Capture ChangeInfo.Id; poll:\n     aws route53 get-change --id \u003Cchange-id>\n     until Status: INSYNC (typically 5-30 seconds).\nPOST_VERIFY:\n  - (pending execution)\nNOTES:\n  - DNS propagation: up to 60s for cached recursive resolvers (TTL).\n    Uncached resolvers see the new answer within seconds of INSYNC.\n  - Rollback: re-run the same change-batch with weights inverted\n    (blue=100, green=0). Keep the rollback command ready.\n  - Watch the application error-rate dashboard for 2x TTL post-change\n    (120s) to catch a bad green deployment before declaring COMPLETED.\n```\n\n## Anti-Patterns — NEVER\n\n- NEVER submit an emergency failover change-batch without first lowering\n  the TTL to 60s (or explicitly accepting the stale-traffic window =\n  old TTL). A 300s TTL means up to 5 minutes of traffic continues to\n  the down primary even after Route 53 stops returning it.\n\n- NEVER assume `Status: INSYNC` from `ChangeResourceRecordSets` means\n  clients see the new IP. INSYNC means Route 53's authoritative servers\n  have the change. Recursive resolvers and OS DNS caches serve stale\n  answers up to TTL. Verify with `dig` from multiple resolvers.\n\n- NEVER trust a single health check as the sole failover trigger. A\n  shallow probe (`\u002Fhealth` returning 200) reports healthy even when the\n  app is broken everywhere else. Pair with a calculated health check\n  (AND) that includes a CloudWatch alarm on a real business metric.\n\n- NEVER operate failover routing without a SECONDARY record. A PRIMARY\n  record alone, when unhealthy, causes Route 53 to return NO answer\n  (NXDOMAIN-like behavior for that record). The failover contract\n  requires the pair.\n\n- NEVER submit a change-batch that UPSERTs only one of the failover\n  pair. PRIMARY and SECONDARY must be updated in the SAME change-batch\n  (Route 53 applies changes atomically within a batch). Splitting them\n  risks a window where neither record is in a consistent state.\n\n- NEVER delete a health check that is still associated with a record\n  set. Route 53 will treat the record as always-healthy (or always-\n  unhealthy depending on policy) once the check is gone. Always\n  disassociate (`UPSERT` the record without `HealthCheckId`) before\n  `delete-health-check`.\n\n- NEVER use weighted routing with a 0-weight on BOTH records. Route 53\n  returns nothing for the name. At least one record must have weight\n  >= 1.\n\n- NEVER assume a cross-account operator role has Route 53 access by\n  default. The zone-owning account MUST grant the operator's role ARN\n  via an inline policy or RAM share. Identity-based policies in the\n  operator account are not sufficient on their own.\n\n- NEVER rely on `dig` from a single network for failover verification.\n  Different recursive resolvers cache independently. Probe at least\n  `1.1.1.1`, `8.8.8.8`, and `9.9.9.9`. Use `test-dns-answer` for\n  authoritative truth.\n\n- NEVER use `CREATE` action in a failover change-batch when the record\n  might already exist. `CREATE` fails if the record exists. Use\n  `UPSERT`. Use `DELETE` only when you intend to remove the record.\n\n- NEVER treat multivalue answer routing as load balancing. It returns\n  up to 8 healthy IPs per query, shuffled, but clients pick one and\n  stick with it. Multivalue is for spreading load across many\n  endpoints, not for primary\u002Fsecondary failover.\n\n- NEVER assume latency routing will fail over. It falls back to the\n  next-lowest-latency healthy region automatically. There is no\n  explicit failover record needed. But if ALL regions are unhealthy,\n  latency routing returns all records (last-resort).\n\n- NEVER change routing policy (e.g., from Weighted to Failover) via a\n  single UPSERT. Routing policy is fixed per record. You must DELETE\n  the old-policy record(s) and CREATE the new-policy record(s) in the\n  same change-batch.\n\n- NEVER auto-execute a state-changing Route 53 CLI without the CONFIRM\n  gate. Failovers have traffic-shifting side effects that can storm\n  the workload if the target is unprepared.\n\n- NEVER failback to a primary that has been Healthy for less than 2\n  consecutive health check intervals. A flapping primary causes\n  repeated failover\u002Ffailback cycles that destabilize the workload.\n\n- NEVER block on a calculated health check's `InsufficientDataHealthStatus`\n  default. If child checks have insufficient data, the calculated\n  check's behavior depends on this setting (Healthy\u002FUnhealthy\u002FLastKnown-\n  GoodStatus). Set it explicitly to match the workload's risk tolerance.\n\n## Pre-flight safety checks (run before any remediation CLI)\n\n- **MANDATORY CONFIRMATION GATE.** Before any state-changing operation\n  (`change-resource-record-sets`, `create-health-check`,\n  `update-health-check`, `delete-health-check`), emit: `CONFIRM: About\n  to \u003Coperation> on \u003Cfqdn> in hosted zone \u003Cid> (account \u003Caccount>,\n  global Route 53). This will \u003Cconsequence>. Proceed? (yes\u002Fno)`. Do\n  NOT execute until the operator confirms.\n\n- **Capture pre-state for rollback.** Before any failover:\n  `aws route53 list-resource-record-sets --hosted-zone-id \u003Cid> --output\n  json > \u002Ftmp\u002F\u003Cid>-rrsets-pre-$(date +%s).json` AND `aws route53\n  test-dns-answer --hosted-zone-id \u003Cid> --record-name \u003Cfqdn>\n  --record-type A --resolver-ip 1.1.1.1 --output json > \u002Ftmp\u002F\u003Cfqdn>-\n  dnsanswer-pre-$(date +%s).json`. These captures are critical for\n  rollback — if the failover makes things worse, you need the exact\n  pre-change record set to revert.\n\n- **Verify the failover target is healthy before swapping.** For\n  planned and failback operations, the new primary's health check must\n  be `Healthy` for >= 2 consecutive intervals. For emergency\n  operations, the secondary endpoint must be independently reachable\n  even if no health check is wired.\n\n- **Verify the change-batch is well-formed.** All records in a\n  failover pair must be in the same change-batch. `UPSERT` actions\n  must specify `Name`, `Type`, `TTL`, and the routing-policy-specific\n  fields (`Weight`, `Failover`, `Region`, `GeoLocation`, or\n  `MultiValueAnswer`).\n\n- **Prefer additive changes over destructive ones.** Lowering TTL,\n  adding a SECONDARY record, and creating a health check are\n  reversible. DELETing a record or a health check is hard to reverse —\n  do it only after confirming the new state is stable.\n\n- **Poll `get-change` until `INSYNC`.** The `ChangeResourceRecordSets`\n  API returns immediately with `PENDING`. Authoritative DNS only\n  reflects the change after `INSYNC`. Do not declare COMPLETED based\n  on the API response alone.\n\n## Recent AWS features (2024-2026)\n\nRecent AWS features (EnableSNI GA, alarm-based checks, InsufficientDataHealthStatus, insulated child checks, RAM cross-account sharing, test-dns-answer multiple resolver IPs, Resolver DNS Firewall, CidrRoutingConfig): [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n## References (load on demand)\n\n- [Advanced patterns](references\u002Fadvanced-patterns.md) — cost\u002Ftime baselines, mindset realities, Step 0 non-obvious behaviors, READY plan contents, recent AWS features\n- [Diagnostic commands](references\u002Fdiagnostic-commands.md) — pagination limits, live-account pre-flight, pre-state capture, post-verification probes\n- [Error handling](references\u002Ferror-handling.md) — malformed input handling, failover failure-mode table\n- [Worked examples](references\u002Fworked-examples.md) — canonical output template, planned-failover, emergency-failover, diagnose-failover examples\n- [Failover routing policies](references\u002Ffailover-routing-policies.md) — routing policy semantics reference\n- [Health check procedures](references\u002Fhealth-check-procedures.md) — health check create\u002Fupdate procedures\n\n## Domain\n\nAWS CloudOps \u002F Route 53 DNS Failover, Health Checks & Disaster Recovery.\n\n## AWS documentation\n\n- **Route 53 Developer Guide** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002F\n- **Health checks** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Fdns-failover-determining-health-of-endpoints.html\n- **Routing policies** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Frouting-policy.html\n- **Configuring DNS failover** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Fdns-failover.html\n- **Calculated health checks** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Fhealth-checks-type-calc.html\n- **Cross-account hosted zones** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002FCross-Account-Zones.html\n- **Route 53 API Reference** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FAPIReference\u002F\n- **Route 53 CLI Reference** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fcli\u002Flatest\u002Freference\u002Froute53\u002F\n- **Route 53 checker IP ranges** — https:\u002F\u002Fdocs.aws.amazon.com\u002FRoute53\u002Flatest\u002FDeveloperGuide\u002Froute-53-ip-addresses.html\n",{"name":5,"license":15,"metadata":24,"description":7,"compatibility":42},{"tags":25,"phase":26,"author":27,"domain":28,"family":29,"version":30,"keywords":31,"task_type":32,"complexity":33,"entry_point":34,"skill_class":35,"when_to_use":36,"requires_llm":37,"verdict_shape":38,"lifecycle_status":39,"invocation_schema":40,"supports_pipeline":37,"activation_triggers":41},"aws, route53, networking, dns, failover, health-check, dr, operate","4","Jacky Chan — AWS Community Builder","aws-cloudops","Networking","0.1.0","Route 53, DNS failover, health check, failover routing, latency routing, geolocation routing, multivalue answer, weighted routing, primary secondary, DNS TTL, planned failover, emergency failover, failback, cross-account hosted zone, CloudWatch alarm, calculated health check, insulated health check, test-dns-answer, change-resource-record-sets","operate","medium","false","capability","Executing a planned DNS failover (weighted 100\u002F0 to 0\u002F100, or swapping failover primary\u002Fsecondary), running an emergency failover, failing back to primary after a failover, diagnosing why a failover did not switch traffic, creating or updating a health check, choosing between failover\u002Flatency\u002Fgeolocation\u002Fmultivalue\u002Fweighted routing for DR, setting TTL for fast failover, or wiring cross-account Route 53 hosted zone access.","true","READY | BLOCKED | COMPLETED","active","Input: either (a) a hosted zone + record set configuration plus the intended operation (planned-failover, emergency-failover, failback, create-health-check, update-health-check, diagnose-failover, update- routing), OR (b) a hosted-zone-id + record-name + operation for live- account execution. Output: deterministic OPERATION \u002F VERDICT \u002F PRE_CHECKS \u002F STEPS \u002F POST_VERIFY \u002F NOTES block per failover, where VERDICT is one of READY, BLOCKED, COMPLETED.","failover DNS, switch Route 53 primary secondary, planned failover weighted, emergency failover, failback to primary, Route 53 health check, DNS failover did not switch, traffic not failing over, multivalue answer routing, weighted routing canary, geolocation DR routing, cross-account Route 53 hosted zone, TTL for failover, test-dns-answer","Agent runtime that reads SKILL.md (Claude Code, Cursor, Windsurf, Codex, Gemini). No AWS CLI required for offline plan classification. Live-account operations use aws route53 list-health-checks, get-health-check, get-health-check-status, list-resource-record-sets, change-resource-record- sets, get-traffic-policy-instance, test-dns-answer, aws cloudwatch describe-alarms, and dig\u002Fnslookup (AWS CLI v2, SSO or key-based credentials).","main","eeace51bd5dd1db2030729d83eeab988861553aa","skills\u002Froute53-failover-operator",0,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills","https:\u002F\u002Fgithub.com\u002Fjhkchan","CTO & Co-Founder @Beever-AI  & @votee. CAISP. AWS Community Builder. Organizer@GDGCloudHK. MongoDB Champion. Technopreneur + Infornographer.","2026-09-24 08:54:10",{"source":8,"skillName":5,"commands":52,"prompt":62,"zipAvailable":63},[53,56,59],{"tool":54,"command":55},"npx","npx skills add jhkchan\u002Faws-agent-skills --skill route53-failover-operator",{"tool":57,"command":58},"bunx","bunx skills add jhkchan\u002Faws-agent-skills --skill route53-failover-operator",{"tool":60,"command":61},"pnpm","pnpm dlx skills add jhkchan\u002Faws-agent-skills --skill route53-failover-operator","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002FSKILL.md",true,[65,71,75,79,83,87,91,95,99,103,107,110,114,118,122,126,130,134,138,142,146],{"path":66,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":69,"sourceHtmlUrl":70},"eval\u002Ftest-cases.yaml","REFERENCE","参考文档",8738,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Feval\u002Ftest-cases.yaml",{"path":72,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":73,"sourceHtmlUrl":74},"evals\u002Fbaselines\u002Fboth-records-unhealthy-blocked.md",487,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fbaselines\u002Fboth-records-unhealthy-blocked.md",{"path":76,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":77,"sourceHtmlUrl":78},"evals\u002Fbaselines\u002Fcross-account-route53-access-denied-blocked.md",637,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fbaselines\u002Fcross-account-route53-access-denied-blocked.md",{"path":80,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":81,"sourceHtmlUrl":82},"evals\u002Fbaselines\u002Femergency-failover-ttl-too-high-blocked.md",944,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fbaselines\u002Femergency-failover-ttl-too-high-blocked.md",{"path":84,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":85,"sourceHtmlUrl":86},"evals\u002Fbaselines\u002Ffailback-to-primary-completed.md",945,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fbaselines\u002Ffailback-to-primary-completed.md",{"path":88,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":89,"sourceHtmlUrl":90},"evals\u002Fbaselines\u002Fplanned-failover-weighted-ready.md",869,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fbaselines\u002Fplanned-failover-weighted-ready.md",{"path":92,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":93,"sourceHtmlUrl":94},"evals\u002Feval_config.yaml",1884,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Feval_config.yaml",{"path":96,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":97,"sourceHtmlUrl":98},"evals\u002Fevals.json",4287,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fevals.json",{"path":100,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":101,"sourceHtmlUrl":102},"evals\u002Fprompts\u002Fboth-records-unhealthy-blocked.md",1054,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fprompts\u002Fboth-records-unhealthy-blocked.md",{"path":104,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":105,"sourceHtmlUrl":106},"evals\u002Fprompts\u002Fcross-account-route53-access-denied-blocked.md",1244,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fprompts\u002Fcross-account-route53-access-denied-blocked.md",{"path":108,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":81,"sourceHtmlUrl":109},"evals\u002Fprompts\u002Femergency-failover-ttl-too-high-blocked.md","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fprompts\u002Femergency-failover-ttl-too-high-blocked.md",{"path":111,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":112,"sourceHtmlUrl":113},"evals\u002Fprompts\u002Ffailback-to-primary-completed.md",1000,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fprompts\u002Ffailback-to-primary-completed.md",{"path":115,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":116,"sourceHtmlUrl":117},"evals\u002Fprompts\u002Fplanned-failover-weighted-ready.md",1183,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fevals\u002Fprompts\u002Fplanned-failover-weighted-ready.md",{"path":119,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":120,"sourceHtmlUrl":121},"examples\u002FREADME.md",6836,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fexamples\u002FREADME.md",{"path":123,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":124,"sourceHtmlUrl":125},"references\u002Fadvanced-patterns.md",10418,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Freferences\u002Fadvanced-patterns.md",{"path":127,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":128,"sourceHtmlUrl":129},"references\u002Fdiagnostic-commands.md",3540,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Freferences\u002Fdiagnostic-commands.md",{"path":131,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":132,"sourceHtmlUrl":133},"references\u002Ferror-handling.md",3053,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Freferences\u002Ferror-handling.md",{"path":135,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":136,"sourceHtmlUrl":137},"references\u002Ffailover-routing-policies.md",7588,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Freferences\u002Ffailover-routing-policies.md",{"path":139,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":140,"sourceHtmlUrl":141},"references\u002Fhealth-check-procedures.md",11200,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Freferences\u002Fhealth-check-procedures.md",{"path":143,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":144,"sourceHtmlUrl":145},"references\u002Fworked-examples.md",8122,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Freferences\u002Fworked-examples.md",{"path":147,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":148,"sourceHtmlUrl":149},"skill.usf.yaml",4682,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Froute53-failover-operator\u002Fskill.usf.yaml",[151,158,165,172,179,186],{"skillNo":152,"name":153,"nameZh":6,"description":154,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":155,"categories":156,"keywords":157,"publishedAt":19},"01M7ADVD60X4PCAPKSE58P9NDC","xray-tracing-deployer","Deploys AWS X-Ray distributed tracing with production-grade configuration: X-Ray daemon deployment (EC2 systemd, ECS sidecar, EKS DaemonSet, Lambda built-in), SDK instrumentation (Java, Python, Node.js, Go, .NET) with annotations and metadata, sampling rules (default reservoir + rate vs custom rules with URL \u002F method \u002F service-name predicates), service map generation, trace query and retrieval, groups and insights, CloudWatch ServiceLens integration, IAM permissions (PutTraceSegments, GetSamplingRules), and latest features (Lambda Powertools tracing, OpenTelemetry \u002F ADOT Collector support, W3C trace context). Emits a READY_TO_DEPLOY checklist with every configuration item verified. Use when enabling X-Ray on a new application, adding tracing to ECS \u002F EKS \u002F Lambda, validating a sampling configuration, or generating daemon deployment CLI and IaC templates. Triggers: X-Ray, distributed tracing, X-Ray daemon, sampling rules, service map, X-Ray SDK, OpenTelemetry, ADOT, Lambda Powertools, CloudWatch ServiceLens.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxray-tracing-deployer\u002FSKILL.md",[],[],{"skillNo":159,"name":160,"nameZh":6,"description":161,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":162,"categories":163,"keywords":164,"publishedAt":19},"01M7ADTVJ7DCBM9CB1FY51GH7J","wellarchitected-workload-auditor","Audits AWS Well-Architected Tool workloads for review staleness, per-pillar high-risk issue counts, milestone tracking gaps, and remediation plan completeness. Emits a deterministic verdict (STALE_REVIEW | HIGH_RISK | CONFIG_GAP | OK) per workload with per-pillar risk breakdown, milestone trend analysis, and specific remediation. Use when reviewing Well-Architected workloads, checking WA review freshness, auditing high-risk issues per pillar, validating milestone coverage, or tracking remediation plans.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwellarchitected-workload-auditor\u002FSKILL.md",[],[],{"skillNo":166,"name":167,"nameZh":6,"description":168,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":169,"categories":170,"keywords":171,"publishedAt":19},"01M7ADT59G6FTTNZYHT2QRPNNP","wellarchitected-review-operator","Operates AWS Well-Architected Tool reviews end-to-end — creates workloads, runs pillar reviews (operational excellence, security, reliability, performance, cost optimization, sustainability, Prosperity), answers questions with risk-tier rationale, generates reports and improvement plans, creates milestones, and integrates with Trusted Advisor and Well-Architected Labs. Runs deterministic pre-checks (workload existence, lens availability, pillar coverage), emits the exact update-answer \u002F get-consolidated-report CLI behind a CONFIRM gate, and verifies risk-tier transitions. Emits READY | BLOCKED | COMPLETED. Use when creating a workload, answering pillar questions, generating an improvement plan, creating a milestone, or integrating with Trusted Advisor. Triggers: well-architected tool, well architected review, workload review, pillar, operational excellence, security, reliability, performance, cost optimization, sustainability, prosperity, improvement plan, milestone, trusted advisor.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwellarchitected-review-operator\u002FSKILL.md",[],[],{"skillNo":173,"name":174,"nameZh":6,"description":175,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":176,"categories":177,"keywords":178,"publishedAt":19},"01M7ADSH5JA9QHNPPHQCD7EVA7","wafv2-web-acl-deployer","Provisions AWS WAFv2 Web ACLs with correct production defaults: scope selection (CLOUDFRONT vs REGIONAL), managed rule groups (AWSManagedRulesCommonRuleSet, SQLiRuleSet, LinuxRuleSet, WindowsRuleSet, IPReputationList, BotControlRuleSet, AmazonIpReputationList, ATP), custom rules (byte match, IP set, regex pattern, geo match, size constraint, rate-based), rule priority ordering, logging destinations (Kinesis Firehose, CloudWatch Logs, S3), resource association (ALB, API Gateway, CloudFront), rate-based rules with aggregate keys (IP, forwarded IP), Challenge and CAPTCHA actions, and account takeover prevention. Emits a READY_TO_DEPLOY checklist. Use when creating a Web ACL, attaching managed rules, configuring rate limiting, enabling WAF logging, associating a Web ACL with an ALB\u002FAPI Gateway\u002FCloudFront, or configuring CAPTCHA\u002FChallenge actions. Triggers: create WAF Web ACL, WAFv2, managed rule groups, WAF rate limiting, WAF logging, WAF CAPTCHA, WAF Challenge action, bot control, ATP managed rules.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwafv2-web-acl-deployer\u002FSKILL.md",[],[],{"skillNo":180,"name":181,"nameZh":6,"description":182,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":183,"categories":184,"keywords":185,"publishedAt":19},"01M7ADRYFAT8R73FBNCHRC573X","wafv2-web-acl-auditor","Audits AWS WAFv2 Web ACL configurations to determine whether the ACL provides effective protection: default-action posture (Allow vs Block), managed-rule-group coverage gaps, rule effectiveness (BLOCK vs COUNT, shadow\u002Fbypass rules, stale exclusions), rate-based rule correctness, logging and visibility configuration, and text-transformation bypass vectors. Emits a deterministic verdict per Web ACL. Use when reviewing a WAFv2 Web ACL for security posture, checking managed-rule coverage, validating rate-limit configuration, auditing WAF logging, or hardening a WAF before production deployment. Triggers: WAF, WAFv2, Web ACL, managed rule group, AWSManagedRules, rate-based rule, CAPTCHA, Challenge, OverrideAction, Count mode, forwarded IP, Bot Control, ATP, text transformation, WAF logging, WAF visibility, OWASP, SQLi, XSS, RFI.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwafv2-web-acl-auditor\u002FSKILL.md",[],[],{"skillNo":187,"name":188,"nameZh":6,"description":189,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":190,"categories":191,"keywords":192,"publishedAt":19},"01M7ADR8W7G72JX4KFGN03QK8Q","waf-rule-deployer","Provisions AWS WAFv2 rule sets with production defaults: Web ACL creation (CloudFront scope in us-east-1 vs Regional scope), rule groups (managed vs custom) with capacity planning in WCU (Web ACL Capacity Units, 1500 default per ACL), managed rule groups (AWSManagedRulesCommonRuleSet, AWSManagedRulesSQLiRuleSet, AWSManagedRulesAmazonIpReputationList, AWSManagedRulesLinuxRuleSet, AWSManagedRulesWindowsRuleSet, AWSManagedRulesUnixRuleSet), custom rules (byte-match, regex pattern set, geo-match, rate-based), IP set and regex pattern set resources, rule priority ordering (lowest number evaluated first), action types (allow, block, count, CAPTCHA, Challenge), bot control managed rule group, account takeover. Triggers: create WAF rule, WAF managed rule group, WAF custom rule, WAF byte match, WAF geo match, WAF rate based rule, WAF IP set, WAF regex pattern set, WAF WCU budget, WAF CloudFront ACL, WAF logging Kinesis Firehose, WAF bot control, WAF ATP, WAF label matching, WAF Challenge action, WAF CAPTCHA.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwaf-rule-deployer\u002FSKILL.md",[],[]]