skip to content

Your team is asked to run a Well-Architected Review of a production workload using the AWS Well-Architected Tool. What does the review actually consist of, what is a milestone, and what do you have at the end?

level: middleimportance: should knowfreq 45%

answer

  1. Define a workload first, then apply lenses
  2. Questions are checkboxes, not free text
  3. Unticked best practices become rated risks
  4. High and medium risk issues, plus a plan
  5. One dated snapshot is immutable

basics

~20 s

A review defines a workload in the AWS Well-Architected Tool, applies one or more lenses, and answers each lens design question by selecting the best practices you follow. Unselected practices become rated risks in an improvement plan; a milestone freezes that state as an immutable snapshot.

solid answer

~50 s

You start by defining the workload in the tool: a name, its environment (production or pre-production), the accounts and Regions it runs in, and an owner. Then you apply lenses — the AWS Well-Architected Framework lens by default, plus any others from the lens catalog or a custom lens your organisation wrote. Then the actual work: for each design question you tick the best practices the workload genuinely follows, mark ones that do not apply with a reason, and leave notes. Anything unselected becomes a risk, rated high or medium, and the tool assembles them into an improvement plan with links to the relevant guidance. At the end you save a **milestone** — a read-only snapshot of every answer and the risk counts at that moment — and usually export the report. The next review compares against that milestone, so progress is visible rather than asserted. The tool itself is free; the cost is a room full of engineers for a day.

go deeper

for a junior

Know that a review means answering structured design questions about one named workload, and that the output is a list of risks and an improvement plan rather than an automated scan result.

for a middle

Be ready to walk the mechanics end to end: define workload, apply lenses, answer best practices, mark not applicable with reasons, read the high and medium risk issues, save a milestone.

for a senior

Show judgment about scope and honesty. Explain how you pick workload boundaries, who has to be in the room, and how you keep the improvement plan from dying the moment the review meeting ends.

for a principal

Own the reuse story: custom lenses that encode your organisation's standards, review templates for answers shared across many workloads, and shared workload access so a central group can participate without owning every account.

## Defining the workload Everything in the AWS Well-Architected Tool hangs off a *workload* record. You create one with a name and description, an environment flag of production or pre-production, the AWS Regions it runs in, and the account IDs involved; you can attach a link to an architecture diagram and name the review owner. Workload records live in the Region you create them in, which surprises people who later look in the wrong Region for last year's review. Getting the scope right matters more than it sounds. "The whole platform" is not a workload — the answers become mush because different components have genuinely different requirements. One deployable system with one set of business objectives is the right granularity. ## Applying lenses A *lens* is a set of design questions. The AWS Well-Architected Framework lens — the pillar questions — is applied by default. From the lens catalog you can add technology- or industry-specific lenses, such as the Serverless, SaaS, Data Analytics, Machine Learning or Financial Services Industry lenses, each adding questions the general framework does not ask. You can also upload a **custom lens** as a JSON document: your own questions, your own best practices, your own risk rules. Custom lenses are versioned and can be shared with other accounts, which is how an organisation encodes "our standards" — a required tagging scheme, a mandated deployment pattern — into the same review instrument as the AWS guidance. ## Answering the questions This is the review. For each design question the tool lists best practices as checkboxes. You select the ones the workload actually follows. Three things are worth knowing: - **Unselected is not neutral.** Every best practice you leave unticked contributes to a risk on that question. There is no "we'll come back to it" state that is invisible in the output. - **Not applicable is a first-class answer.** You can mark a whole question or an individual best practice as not applicable and record the reason. Doing this honestly is what stops a serverless workload from carrying phantom risks about patching instances. - **Notes are where the value hides.** A year later the checkbox tells you nothing, and the note explaining *why* you accepted single-Region tells you everything. The tool rates the resulting gaps as **High Risk Issues (HRIs)** and **Medium Risk Issues (MRIs)**, summarises them per pillar, and builds an improvement plan linking each to the relevant guidance. Where your AWS Support plan exposes them, relevant Trusted Advisor checks are surfaced alongside the questions so account-level evidence sits next to the design answer. ## Milestones A **milestone** is an immutable, read-only snapshot of the entire review — every answer, every note, every risk count — taken at a point in time. You cannot edit a milestone after saving it; you keep working on the live workload, and the milestone stands as the record of where you were. The practice worth adopting is saving a milestone at meaningful moments: at the end of each review session, before a major release, after a remediation push. That gives you a comparison. "We closed eleven high risk issues between the launch milestone and today" is a sentence you can only say if someone saved the first one. ## What you have at the end Four things. A recorded set of answers with reasoning. A prioritised improvement plan of HRIs and MRIs. A downloadable report to circulate to people who will not log into the console. And a milestone to measure the next review against. What you do **not** have is a certificate, a score AWS publishes, or any remediation — the tool does not change a single resource in your account. It is a structured questionnaire with good guidance attached. ## Sharing and reuse Workloads can be shared with other AWS accounts, with IAM principals, or with an organisation or organisational unit, granting read-only or contribute access — which is how a central architecture group participates in a team's review without owning the account. Review templates let you pre-fill answers that are identical across many workloads, such as organisation-wide guardrails, and profiles let you record business context so the tool orders the questions and risks by what matters to this workload right now. ## The common failure The review is answered by one architect alone, in an afternoon, optimistically. Every checkbox goes green, the risk count is zero, and the exercise has produced nothing. A review is worth doing when the people who operate the workload are in the room and are allowed to say "no, we don't actually do that".

  • What is the difference between a lens and a milestone in the Well-Architected Tool?
    A lens is the input — a set of design questions and best practices applied to the workload, either an AWS-published one or a custom one you wrote. A milestone is the output — an immutable, dated snapshot of the answers and risk counts across all applied lenses. Lenses define what you are asked; milestones record what you answered.
  • Someone marks two thirds of the design questions as not applicable and reports zero risks. How would you respond?
    Ask to see the reasons. Not applicable is legitimate — instance-patching questions genuinely do not apply to a fully serverless workload — but it is also the easiest way to fake a clean review. I would spot-check the reasons against the architecture, and treat an unusually high not-applicable rate as a signal to re-run the review with the operators present.
  • Does the Well-Architected Tool change anything in your AWS account?
    No. It records answers, rates risks and produces an improvement plan and report. It provisions nothing, remediates nothing and blocks nothing. Where your Support plan allows, it surfaces relevant Trusted Advisor findings next to the questions, but acting on them is entirely manual work you schedule yourself.

saying these in an interview costs you the question

  • Thinks the tool scans your account and scores it automatically
  • Believes a review produces an AWS certification
  • Treats a milestone as an editable draft
  • Marks everything not applicable to reach zero risks
  • Reviews the entire platform as one workload

context