К основному содержанию
правило CX Codex

aws-well-architected-framework-review — правило

Правило aws-well-architected-framework-review прогоняет полный обзор Well-Architected по коду и IaC: шесть столпов, находки со ссылками на файл и строку, отчёт с планом исправлений.

MIT-0 ★ 280 обновлён 2026-10-06

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/aws-well-architected-framework-review.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Все правила IDE по теме «Облака: AWS, Azure, GCP» →
aws-well-architected-review aws Скилл aws-well-architected-review проводит ревью рабочей нагрузки по AWS Well-Architected Framework: читает код и IaC, сверяет с живой документацией AWS и выдаёт отчёт с приоритетами. CX Codex +1 2 400установок aws-architecture-review-expert Giuseppe Trisciuoglio Субагент aws-architecture-review-expert проверяет шаблоны CloudFormation и архитектуру AWS по шести столпам Well-Architected Framework и находит проблемы безопасности. CX Codex ★ 372звёзд репо azure-well-architected MicrosoftDocs С готовыми чек-листами, принципами и рекомендациями Azure Well Architected. CX Codex +1 676установок azure-well-architected-review официальный github Скилл azure-well-architected-review для GitHub Copilot проверяет IaC и ресурсы Azure по пяти направлениям Well-Architected Framework. Находит риски и заводит GitHub issues для исправлений. CX Codex +1 41установок azure-well-architected-framework JosiahSiegel Скилл azure-well-architected-framework проводит аудит облачной архитектуры в Azure по пяти столпам WAF и даёт готовые команды Azure CLI. CX Codex +1 174установок aws-cloudformation aws Скилл aws-cloudformation ведёт шаблоны CloudFormation от написания до разбора упавших стеков: валидация, проверки cfn-guard и поиск причины сбоя по событиям и CloudTrail. CX Codex +1 10 000установок

Из того же набора19

Весь набор →
sustainability-optimization Команда sustainability-optimization запускает разбор архитектуры по AWS Well-Architected, ограниченный столпом Sustainability, и выдаёт отчёт с таблицей возможностей и скорингом. CX Codex +1 ★ 280звёзд репо prompt Субагент prompt проводит аудит инфраструктуры AWS по Well-Architected Framework, находя риски в коде и IaC без автоматических правок в репозитории. CX Codex +1 ★ 280звёзд репо well-architected Правило применяет принципы AWS Well-Architected при разборе архитектуры, проектировании систем и написании инфраструктурного кода. Помогает структурировать рекомендации и явно показывать компромиссы. CX Codex +1 ★ 280звёзд репо wa-builder Команда wa-builder разбирает архитектуру по принципам AWS Well-Architected и создаёт схемы PlantUML, деревья решений и дорожные карты улучшений. CX Codex +1 ★ 280звёзд репо migration-readiness Команда migration-readiness анализирует кодовую базу и оценивает готовность нагрузки к переносу в AWS. Она пригодится, чтобы найти блокеры и составить план миграции по компонентам. CX Codex +1 ★ 280звёзд репо wa-guardrails Команда wa-guardrails генерирует превентивные правила AWS Well-Architected: проверки в CI, правила AWS Config, SCP и алерты CloudWatch для защиты инфраструктуры от регрессий. CX Codex +1 ★ 280звёзд репо aws-well-architected-framework-review Команда aws-well-architected-framework-review для Claude Code проверяет AWS-нагрузку по столпам Well-Architected Framework и связывает риски с кодом и инфраструктурой. Разбирает IaC, конфигурации и архитектуру приложения. CX Codex +1 ★ 280звёзд репо wa-builder Скилл wa-builder разбирает AWS Well-Architected применительно к вашей нагрузке, а потом собирает PlantUML-диаграмму с подсветкой столпов, деревья решений и план улучшений. CX Codex +1 ★ 280звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой