Run an AWS Well-Architected Framework review against a workload or component. Use when the user invokes /well-architected-review, the aws-solutions-architect agent recommends a framework review, or the user asks about well-architected alignment.
Run an AWS Well-Architected Framework review for the workload or component
described in $ARGUMENTS.
If $ARGUMENTS is empty, ask the user to describe the workload, component, or
architecture to review before proceeding. Do not continue until a description
is provided.
Before starting the review, gather relevant context:
.claude/agent-memory/aws-solutions-architect/PROJECT.md if it existsaws-solutions-architect agent's project memory from
.claude/agent-memory/aws-solutions-architect-aws-solutions-architect/MEMORY.md
if it exists**/*.template.json, **/*.template.yaml, **/template.json, **/template.yaml**/*stack*.ts, **/*stack*.py (CDK)**/*.tf (Terraform)search_documentation via the MCP server to look up
best practices and security guidance for the resource types present in the templatesEvaluate the workload against all six Well-Architected Framework pillars. For each pillar, produce:
Focus areas:
Key questions:
Focus areas:
Key questions:
Focus areas:
Key questions:
Focus areas:
Key questions:
Focus areas:
Key questions:
Focus areas:
Key questions:
Compile findings into a structured report:
# Well-Architected Review: [Workload Name]
> Reviewed on [date]
## Summary
[2-3 sentence overview of the workload's Well-Architected alignment]
**Overall Risk Level:** [Low / Medium / High]
| Pillar | Rating | High Risks | Medium Risks | Low Risks |
| --- | --- | --- | --- | --- |
| Operational Excellence | [Good/Fair/Needs Work] | [N] | [N] | [N] |
| Security | [Good/Fair/Needs Work] | [N] | [N] | [N] |
| Reliability | [Good/Fair/Needs Work] | [N] | [N] | [N] |
| Performance Efficiency | [Good/Fair/Needs Work] | [N] | [N] | [N] |
| Cost Optimization | [Good/Fair/Needs Work] | [N] | [N] | [N] |
| Sustainability | [Good/Fair/Needs Work] | [N] | [N] | [N] |
## Pillar Details
### Operational Excellence
**Rating:** [Good/Fair/Needs Work]
**Current State:**
[What the workload does well]
**Findings:**
| # | Risk | Severity | Recommendation | Effort |
| --- | --- | --- | --- | --- |
| 1 | [description] | [H/M/L] | [action] | [S/M/L] |
[Repeat for each pillar]
## Prioritized Recommendations
[Top 5-10 recommendations across all pillars, ordered by impact and effort]
| Priority | Pillar | Recommendation | Severity | Effort |
| --- | --- | --- | --- | --- |
| 1 | [pillar] | [action] | [H/M/L] | [S/M/L] |
Present the report and suggest follow-up actions:
aws-solutions-architect agent
for a detailed security review of the affected resources"aws-solutions-architect agent to estimate costs
for the affected services"