aws-well-architected-framework-review — правило
Правило aws-well-architected-framework-review прогоняет полный обзор Well-Architected по коду и IaC: шесть столпов, находки со ссылками на файл и строку, отчёт с планом исправлений.
MIT-0 ★ 280 обновлён 2026-10-06
.claude/rules/aws-well-architected-framework-review.mdЧто делает aws-well-architected-framework-review
Правило включается, когда просят ревью архитектуры, WA-оценку или упоминают Well-Architected. Сначала агент уточняет рамки: имя ворклоада, каталоги с кодом, критичность и боли. Дальше идёт разбор инфраструктуры: CDK, CloudFormation, Terraform, SAM, Serverless Framework, пайплайны CI/CD, конфиги мониторинга. По найденному строится диаграмма PlantUML, отдельно разбирается код приложения — точки входа, ретраи, таймауты, авторизация.
Потом шесть столпов: operational excellence, security, reliability, performance efficiency, cost optimization, sustainability. Проверки конкретные: "Action": "*" в IAM, 0.0.0.0/0 на портах кроме 443 и 80, TLS ниже 1.2, хранилища без шифрования, stateful-ресурсы без бэкапов. У каждой находки статус, ссылка на файл и строку, пробел и риск. Риск считается по матрице impact × likelihood, конфликты между столпами идут отдельным разделом.
На выходе отчёт: executive summary, таблица столпов с оценкой 1–5, находки с готовым сниппетом исправления на языке IaC проекта (или AWS CLI, если IaC нет) и план по срокам — Quick Wins, Foundation, Strategic. Находка без пути к файлу и номера строки не считается находкой; где кода не хватает, ставится Cannot Determine. В Cline файл кладут в .clinerules/.
Какие задачи решает
- прогнать ворклоад по шести столпам Well-Architected и получить оценки 1–5
- выловить в IaC открытые security groups и хранилища без шифрования
- собрать PlantUML-диаграмму архитектуры по CDK или Terraform
- разложить находки по матрице impact × likelihood
- получить готовые сниппеты исправлений на диалекте IaC проекта
Примеры запросов агенту
- Прогони Well-Architected review ворклоада
orders-api, критичность high, больше всего болит стоимость. - Сделай WA-оценку репозитория: Terraform в
infra/, код приложения вsrc/. - Оцени архитектуру по шести столпам и покажи находки со ссылками на файл и строку.
Как установить aws-well-architected-framework-review
Вручную: положить файлы
.claude/rules/aws-well-architected-framework-review.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/aws-well-architected-framework-review.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/aws-well-architected-framework-review.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/aws-well-architected-framework-review.mdВручную: положить файлы
.clinerules/aws-well-architected-framework-review.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об aws-well-architected-framework-review
Как установить aws-well-architected-framework-review в Claude Code?
Скопируйте файл правила в .claude/rules/aws-well-architected-framework-review.md в корне проекта.
Что делает aws-well-architected-framework-review?
Проводит обзор ворклоада по AWS Well-Architected Framework: читает IaC и код приложения, оценивает шесть столпов, считает риски и отдаёт отчёт с планом исправлений.
Какие специализированные линзы правило распознаёт?
Serverless, SaaS, Data Analytics, ML, IoT, Containers, Games, Financial Services, Healthcare. Если линза очевидна из кода, она отмечается в отчёте.
Исходный текст
aws-well-architected-framework-review.md · MIT-0
--- description: Run a full Well-Architected Framework review when the user asks for an architecture review, WA assessment, or mentions "Well-Architected review". Analyzes code, IaC, and configurations to produce evidence-backed findings. globs: alwaysApply: false --- # Well-Architected Review Skill When the user requests a WA review, follow these steps: ## Step 1: Define scope Ask for: workload name, code packages/directories to analyze, business criticality (critical/high/standard/low), and pain points. If you are already in a codebase with IaC, skip the prompt and proceed with discovery. Determine if a specialized WA Lens applies (Serverless, SaaS, Data Analytics, ML, IoT, Containers, Games, Financial Services, Healthcare). If obvious from code, note it. ## Step 2: Infrastructure Discovery Analyze ALL infrastructure-as-code in the codebase: - CDK, CloudFormation, Terraform, SAM, Serverless Framework - CI/CD pipeline definitions - Monitoring configurations (CloudWatch alarms, dashboards) - Deployment configurations For each resource, document: type, configuration, file path and line numbers, security/resilience/cost relevance. Create a PlantUML architecture diagram showing components, data flows, and boundaries. ## Step 3: Application Architecture Discovery Analyze application code for: - Entry points (API handlers, event processors, scheduled tasks) - Service communication patterns (sync/async, retries, timeouts, circuit breakers) - Data access patterns and error handling - Authentication/authorization logic - Observability instrumentation ## Step 4: Evaluate each pillar with code evidence For each pillar, assess against WA Framework questions. Every finding MUST include: - **Status**: Implemented / Partially Implemented / Not Implemented / Cannot Determine - **Evidence**: specific file paths and line numbers - **Gaps**: what's missing - **Risk**: what could go wrong ### Operational Excellence - OPS 4 — Observability: structured logging, tracing, custom metrics - OPS 5 — Reduce defects: automated testing, linting, staged deployments - OPS 6 — Deployment risk: canary/blue-green, feature flags, rollback - OPS 8 — Workload health: dashboards, composite alarms - OPS 10 — Event management: event routing, automated remediation ### Security - SEC 3 — Permissions: least privilege. Flag `"Action": "*"` or `"Resource": "*"` on mutating actions - SEC 5 — Network: VPC design, security groups. Flag `0.0.0.0/0` on non-443/80 ports - SEC 8 — Data at rest: encryption on ALL stores. Flag unencrypted storage - SEC 9 — Data in transit: TLS enforcement. Flag TLS < 1.2 - SEC 2/3 — Identity: IAM roles, credential management. Flag hardcoded secrets ### Reliability - REL 2 — Network topology: multi-AZ, subnet distribution - REL 3 — Demand: auto-scaling, capacity modes. Flag compute without scaling - REL 4 — Distributed interactions: retries, timeouts, idempotency - REL 9 — Backup: automated backups, PITR. Flag stateful resources without backups - REL 11 — Component failures: redundancy, failover - REL 13 — DR: cross-region resources, DR automation ### Performance Efficiency - PERF 1 — Resource selection: instance types, Graviton usage - PERF 4 — Database: read replicas, connection pooling - PERF 5 — Networking: CloudFront, VPC endpoints - PERF 8 — Tradeoffs: caching, async patterns ### Cost Optimization - COST 4 — Decommission: lifecycle policies. Flag "never expire" logs - COST 5 — Service selection: pricing alignment. Flag over-provisioned resources - COST 8 — Data transfer: VPC endpoints vs NAT Gateway ### Sustainability - SUS 2 — Scale-to-zero, scheduled scaling - SUS 4 — Data tiering, lifecycle, compression - SUS 5 — Flag x86 where Graviton available ## Step 5: Risk Assessment Assess each finding using Impact × Likelihood matrix: | Impact | Likelihood | Risk Level | |----------|------------|------------| | Severe | High | Critical | | Severe | Medium | High | | Severe | Low | High | | Moderate | High | High | | Moderate | Medium | Medium | | Moderate | Low | Medium | | Minor | High | Medium | | Minor | Medium | Low | | Minor | Low | Low | Identify cross-pillar conflicts (security vs performance, cost vs reliability). ## Step 6: Output report Structure: - Executive Summary (date, workload, criticality, lens, findings count, overall maturity 1-5) - Architecture Overview (PlantUML diagram) - Pillar Scorecard (table: pillar, score 1-5, key strength, key gap) - Critical and High Risk Findings (ID, pillar, title, evidence file:line, impact, recommendation, fix — ready-to-copy snippet in the workload's IaC dialect, AWS CLI when no IaC, report-only, effort, AWS services) - Medium Risk Findings (condensed, each with its fix snippet) - Low Risk Findings (summary table) - Cross-Pillar Trade-offs - Prioritized Remediation Plan (Quick Wins < 1 week, Foundation 1-4 weeks, Strategic 1-3 months) - Next Steps (top 5 concrete actions) ## Calibration - Mature workloads (multi-AZ, encryption, CI/CD, monitoring, scaling) should score 4+ — don't over-penalize - Every finding MUST have code evidence — no generic recommendations - "Cannot Determine" is valid when code alone is insufficient - Acknowledge strengths before gaps - Match expectations to business criticality tier <!-- Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. SPDX-License-Identifier: MIT-0 -->
© aws-samples · MIT-0 · aws-samples/sample-well-architected-skills-and-steering