well-architected — правило для Claude Code
Правило применяет принципы AWS Well-Architected при разборе архитектуры, проектировании систем и написании инфраструктурного кода. Помогает структурировать рекомендации и явно показывать компромиссы.
MIT-0 ★ 280 обновлён 2026-10-06
.claude/rules/well-architected.mdЧто делает well-architected
Правило просит агента учитывать все шесть направлений AWS Well-Architected: операционную эффективность, безопасность, надёжность, производительность, стоимость и устойчивое развитие. Среди принципов проектирования — управляемые сервисы, отказоустойчивость, разделение компонентов, минимальные привилегии, инфраструктура как код и наблюдаемость с самого начала.
При выдаче рекомендаций агент должен начать с самого важного вывода, сгруппировать замечания по направлениям и обозначить их уровень риска. Для каждого замечания нужны объяснение его важности и конкретный следующий шаг. Компромиссы тоже следует проговаривать: например, высокая доступность повышает стоимость, а оптимизация производительности может усилить зависимость от платформы.
В Claude Code правило размещают в .claude/rules/well-architected.md; оно настроено на постоянное применение. Это значит, что подсказки могут влиять и на запросы, не связанные напрямую с архитектурой AWS.
Какие задачи решает
- проверить архитектурное решение по шести направлениям AWS
- найти риски надёжности и безопасности в проекте
- сравнить стоимость высокой доступности с её преимуществами
- сформулировать рекомендации с приоритетами и следующими шагами
Примеры запросов агенту
- Проверь архитектуру сервиса по принципам AWS Well-Architected и перечисли главные риски.
- Предложи архитектуру для новой системы, сгруппировав рекомендации по направлениям Well-Architected.
- Посмотри на этот инфраструктурный код: какие компромиссы по стоимости, надёжности и безопасности стоит учесть?
Как установить well-architected
Вручную: положить файлы
.claude/rules/well-architected.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/well-architected.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/well-architected.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/well-architected.mdВручную: положить файлы
.clinerules/well-architected.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о well-architected
Как установить well-architected в Claude Code?
Добавьте правило в файл .claude/rules/well-architected.md.
Что делает правило well-architected?
Оно направляет агента при архитектурных ревью, проектировании систем и работе с инфраструктурным кодом. Рекомендации учитывают шесть направлений AWS Well-Architected и должны включать уровень риска и следующий шаг.
Правило применяется постоянно?
Да. В его настройках включено постоянное применение, поэтому оно может влиять на ответы и за пределами запросов об архитектуре.
Исходный текст
well-architected.md · MIT-0
--- description: Apply AWS Well-Architected Framework principles when reviewing architectures, writing infrastructure code, or advising on design decisions. globs: alwaysApply: true --- # Well-Architected Framework ## When to Apply Apply this guidance whenever the user: - Asks for an architecture review or design feedback - Requests help designing a new workload or system - Asks about best practices for reliability, security, cost, performance, or sustainability - Mentions "Well-Architected" or "WA review" ## Pillars Always consider all six pillars when evaluating or proposing architectures: 1. **Operational Excellence** — Automate operations, make frequent small reversible changes, refine procedures, anticipate failure, learn from operational events. 2. **Security** — Implement a strong identity foundation, enable traceability, apply security at all layers, automate security best practices, protect data in transit and at rest, keep people away from data, prepare for security events. 3. **Reliability** — Automatically recover from failure, test recovery procedures, scale horizontally, stop guessing capacity, manage change through automation. 4. **Performance Efficiency** — Democratize advanced technologies, go global in minutes, use serverless architectures, experiment more often, consider mechanical sympathy. 5. **Cost Optimization** — Implement cloud financial management, adopt a consumption model, measure overall efficiency, stop spending money on undifferentiated heavy lifting, analyze and attribute expenditure. 6. **Sustainability** — Understand your impact, establish sustainability goals, maximize utilization, anticipate and adopt new more efficient offerings, use managed services, reduce downstream impact. ## Design Principles When proposing solutions: - Favor managed services over self-managed infrastructure - Design for failure — assume any component can fail at any time - Decouple components to reduce blast radius - Use multiple Availability Zones for high availability - Implement least-privilege access for all identities - Automate everything that can be automated - Use infrastructure as code for all environments - Design for observability from day one ## Trade-off Guidance Acknowledge trade-offs explicitly: - Security controls may add latency — quantify the impact - High availability increases cost — present options at different tiers - Performance optimization may reduce portability — state the lock-in risk - Cost optimization may reduce resilience — make the risk visible ## Response Format When delivering Well-Architected guidance: - Lead with the most critical finding or recommendation - Group findings by pillar - Use severity labels: 🔴 High Risk, 🟡 Medium Risk, 🟢 Best Practice - Include "Why it matters" for each finding - Provide a concrete next step for each recommendation <!-- 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