Well-Architected Tool and Review Process
Run an AWS Well-Architected Tool review against a live workload, interpret the risk findings, and prioritise the improvement plan.
Well-Architected Tool and Review Process is a free AWS Solutions Architect lesson on CoddyKit — lesson 4 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the AWS Solutions Architect learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
What Is the Well-Architected Tool?
The AWS Well-Architected Tool is a free service in the AWS Management Console that helps you review your workloads against AWS best practices. You answer a series of questions about your architecture across the six pillars, and the tool generates a risk report identifying High Risks (HRIs) and Medium Risks (MRIs) with specific improvement recommendations. Think of it as a structured conversation between you and the Well-Architected Framework — the questions guide you to think critically about every aspect of your architecture.
# Well-Architected Tool: available in AWS Console
# Navigate to: AWS Console > Well-Architected Tool
# Review components:
# - Workload: your application or system
# - Milestone: snapshot of review at a point in time
# - Lens: set of questions (default: Well-Architected)
# - Risk: High Risk Item (HRI) or Medium Risk Item (MRI)
# Custom lenses also available for specific domains
# (SaaS, Serverless, Data Analytics, etc.)Defining a Workload
The first step in using the Well-Architected Tool is defining a workload — a collection of interrelated AWS resources and code that make up your application or service. Be specific: a workload might be your order processing microservice, not your entire company's AWS account. Define the environment (Production, Pre-Production, Development), the AWS regions used, and the industry for relevant compliance context. Well-defined workload boundaries make the review questions more relevant and actionable.
# Well-Architected Tool API: create workload
aws wellarchitected create-workload \
--workload-name 'OrderProcessingService' \
--description 'Handles e-commerce order processing' \
--environment PRODUCTION \
--aws-regions us-east-1 eu-west-1 \
--review-owner 'platform-team@example.com' \
--industry-type 'RETAIL' \
--industry 'E-Commerce'Answering Pillar Questions
For each pillar, the Well-Architected Tool presents a set of questions with multiple best practice options. For example, for the Reliability pillar: How do you back up data? — best practices include automated backups, cross-region copies, and recovery testing. You select which practices you have implemented, and the tool calculates risk based on gaps. Questions are designed to be challenging — most workloads will have gaps, which is the point: the tool reveals what to work on next, not to fail you.
# Example Well-Architected questions per pillar:
# Operational Excellence:
# - How do you determine what your priorities are?
# - How do you structure your organisation?
# - How do you reduce defects?
# Security:
# - How do you protect your network resources?
# - How do you protect your compute resources?
# Reliability:
# - How do you manage service limits?
# - How do you design your workload to withstand failures?
# (65+ questions across all 6 pillars)Understanding Risk Ratings
The Well-Architected Tool classifies findings as High Risk (HRI) or Medium Risk (MRI). An HRI indicates a significant gap that should be addressed immediately — for example, not encrypting sensitive data at rest or running production workloads without backups. An MRI is a notable gap that should be addressed on a roadmap. Questions with no issues are marked No Risk. Aim to resolve all HRIs before addressing MRIs. The tool also distinguishes questions you have not yet answered as Unanswered.
# List risks from Well-Architected review
aws wellarchitected list-answers \
--workload-id abc123 \
--lens-alias wellarchitected \
--pillar-id reliability \
--risk-counts
# Risk classification:
# HRI (High): Critical gaps, address immediately
# MRI (Medium): Significant gaps, address on roadmap
# No Risk: Best practices implemented
# Unanswered: Not yet evaluatedImprovement Plans
For each identified risk, the Well-Architected Tool provides an improvement plan with specific, actionable recommendations and links to relevant AWS documentation. You can mark improvement items as in-progress or completed to track remediation progress over time. Prioritise improvements based on risk level and business impact. The improvement plan output can be exported and used as a technical roadmap or presented to leadership to justify architectural investments.
# Get improvement recommendations for a workload
aws wellarchitected get-lens-review \
--workload-id abc123 \
--lens-alias wellarchitected \
--query 'LensReview.PillarReviewSummaries[].{Pillar:PillarName,HRI:RiskCounts.HIGH,MRI:RiskCounts.MEDIUM}'
# Update improvement status
aws wellarchitected update-answer \
--workload-id abc123 \
--lens-alias wellarchitected \
--pillar-id security \
--question-id security_01 \
--selected-choices sec_bp_01 sec_bp_02Milestones for Progress Tracking
Milestones are snapshots of your workload review at a point in time. Save a milestone before and after making architecture improvements to track progress. The Well-Architected Tool lets you compare milestones to see how your risk profile has changed — for example, how many HRIs you resolved in the last quarter. Milestones are essential for demonstrating continuous improvement to compliance auditors, management, and customers. Create milestones before major releases and after completing improvement sprints.
# Create a milestone to snapshot current state
aws wellarchitected create-milestone \
--workload-id abc123 \
--milestone-name 'Q2-2026-Review'
# Compare milestones to track improvement
aws wellarchitected list-milestone-reviews \
--workload-id abc123 \
--query 'MilestoneReviewSummaries[].{Name:MilestoneName,Date:ReviewedAt,HRI:RiskCounts.HIGH}'
# Shows: Q1: 12 HRI -> Q2: 4 HRI -> Q3: 1 HRICustom Lenses
Beyond the default Well-Architected lens, AWS provides Custom Lenses for specific domains. The Serverless Lens has questions specific to Lambda, API Gateway, and event-driven architectures. The SaaS Lens covers multi-tenant isolation and onboarding. The Data Analytics Lens focuses on data lakes and streaming. You can also create your own custom lens with your organisation's specific standards and best practices. Apply multiple lenses to the same workload for comprehensive coverage.
# List available lenses
aws wellarchitected list-lenses
# Common lenses:
# wellarchitected - Default 6-pillar review
# serverless - Lambda, API Gateway, DynamoDB
# saas - Multi-tenancy, isolation, onboarding
# dataanalytics - Data lakes, Redshift, Athena
# iot - IoT Core, Greengrass
# foundationaltechnicallens - Low-level architecture
# Associate lens with workload
aws wellarchitected associate-lenses \
--workload-id abc123 \
--lens-aliases serverless wellarchitectedWell-Architected Reviews at Scale
Large organisations with hundreds of workloads cannot review each one manually. AWS Well-Architected Tool integration with AWS Organizations allows central teams to share workloads and review profiles across accounts. AWS Partners (AWS Solutions Architects and APN Consulting Partners) can conduct formal Well-Architected Reviews for customers and access a special review mode. Use the Workload Sharing feature to grant read or owner access to other AWS accounts for collaborative reviews.
# Share workload for review with central architecture team
aws wellarchitected create-workload-share \
--workload-id abc123 \
--shared-with '999999999999' \
--permission-type CONTRIBUTOR
# The central team sees the workload in their console
# They can answer questions and create notes
# Original owner retains administrative controlIntegrating Reviews into SDLC
Well-Architected reviews should not be one-time events — integrate them into your software development lifecycle. Recommended cadence: Before launch — conduct a review when designing a new workload. Quarterly — update the review as the workload evolves. After major incidents — a post-mortem may reveal new gaps to add. After AWS service launches — new services may offer better solutions. Treat the Well-Architected Tool as a living document of your architecture's quality, not a checkbox exercise.
# SDLC integration checklist:
# Phase: Design
# - Create workload in W-A Tool
# - Answer all pillar questions
# - Document HRIs that are accepted risks with justification
# Phase: Pre-launch
# - Resolve all HRIs or document mitigation
# - Create 'pre-launch' milestone
# Phase: Post-launch (quarterly)
# - Update answers as architecture evolves
# - Create quarterly milestone
# - Review new improvement recommendationsWell-Architected and the SAA-C03 Exam
The SAA-C03 exam frequently tests Well-Architected Framework knowledge through scenario questions that ask which pillar a given situation or solution belongs to. Key mappings to memorise: Operational Excellence — IaC, runbooks, post-mortems. Security — least privilege, encryption, GuardDuty. Reliability — Auto Scaling, Multi-AZ, health checks. Performance Efficiency — caching, right-sizing, Graviton. Cost Optimisation — Spot instances, Savings Plans, lifecycle policies. Sustainability — Graviton, managed services, eliminating waste.
# Quick pillar reference for exam:
# Operational Excellence:
# IaC (CloudFormation), CI/CD, runbooks, post-mortem
# Security:
# IAM least-privilege, KMS, GuardDuty, WAF, CloudTrail
# Reliability:
# ASG, ELB, Multi-AZ, backup/restore, FIS chaos testing
# Performance Efficiency:
# Right instance type, ElastiCache, CloudFront, DAX
# Cost Optimisation:
# Spot, Savings Plans, S3 lifecycle, Cost Explorer
# Sustainability:
# Graviton, serverless, data lifecycle, high utilisationRunning a Review: Step-by-Step
To run a Well-Architected review: 1) Define your workload in the tool. 2) Select applicable lenses. 3) Answer all questions — be honest about what you have NOT implemented. 4) Review the risk report — prioritise HRIs. 5) Create an improvement plan with owners and deadlines. 6) Save a milestone to record the starting state. 7) Implement improvements and update question answers as you go. 8) Save a new milestone to track progress. Repeat quarterly. An honest, complete review is more valuable than a perfect score with omissions.
# Automate workload review reporting
aws wellarchitected get-lens-review-report \
--workload-id abc123 \
--lens-alias wellarchitected \
--milestone-number 3
# Report includes:
# - HRI count per pillar
# - MRI count per pillar
# - Specific question gaps
# - Improvement recommendations with links
# Exportable as PDF for stakeholder presentationsQuick Check
Test your understanding of AWS Solutions Architect (SAA-C03) concepts from this lesson.
Lesson Recap
In this lesson you learned: the Well-Architected Tool evaluates workloads across six pillars and generates HRI/MRI risk findings, milestones capture progress snapshots for tracking improvement over time, and custom lenses extend reviews to serverless, SaaS, and data analytics domains. Integrate reviews into your SDLC as a living quality assessment. Next up we explore cost optimisation techniques including right-sizing and Compute Optimizer.
Frequently asked questions
Is the “Well-Architected Tool and Review Process” lesson free?
Yes — the full text of “Well-Architected Tool and Review Process” is free to read here on the web, and the AWS Solutions Architect course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the AWS Solutions Architect course, upgrade to CoddyKit PRO.
What will I learn in “Well-Architected Tool and Review Process”?
Run an AWS Well-Architected Tool review against a live workload, interpret the risk findings, and prioritise the improvement plan. You practise AWS Solutions Architect with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start AWS Solutions Architect?
No prior experience is required. AWS Solutions Architect on CoddyKit is structured for beginners through advanced learners; this is — lesson 4 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Well-Architected Tool and Review Process” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this AWS Solutions Architect lesson?
Yes. Every AWS Solutions Architect lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Operational Excellence and Security Pillars
- Reliability and Performance Efficiency Pillars
- Cost Optimisation and Sustainability Pillars
- Well-Architected Tool and Review Process