well-architected

Automate Well-Architected reviews via the WA Tool API to rate pillars and identify HRIs.

12|5|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/aws-samples/sample-claude-code-plugins-for-startups --skill well-architected-aws-samples
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: well-architected
Source: https://github.com/aws-samples/sample-claude-code-plugins-for-startups/tree/main/plugins/aws-dev-toolkit/skills/well-architected
Command: npx skills add https://github.com/aws-samples/sample-claude-code-plugins-for-startups --skill well-architected-aws-samples

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

AWS Well-Architected reviews can be time-consuming and require a structured approach to evaluate workloads against the six pillars. This skill provides a repeatable process to identify high-risk issues and create actionable improvement plans, enabling teams to align their architectures with AWS best practices.

Core Features & Use Cases

  • Structured Well-Architected reviews across workloads using the WA Tool and MCP integration to pull official guidance.
  • Pillar-by-pillar evaluation with risk flagging (HRIs) and generation of prioritized improvement plans for remediation and governance.
  • Guidance on lenses and WA Tool usage for ongoing optimization, governance, and compliance across teams.

Quick Start

Initiate a Well-Architected review for a workload to identify HRIs and generate an improvement plan.

Frequently Asked Questions about well-architected

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate an AWS Well-Architected review for my workload?

Automate AWS Well-Architected reviews by scoping workloads, gathering context, and evaluating the six pillars via the WA Tool API. This identifies high risk issues and generates prioritized improvement plans for governance.

What is a Well-Architected pillar assessment and how does it flag risks?

A Well-Architected pillar assessment evaluates your architecture against the six pillars to identify High Risk Issues (HRIs). It queries WA content to rate compliance and generates prioritized improvement plans for remediation.

Can I generate a prioritized improvement plan from an architecture review?

Yes, an architecture review generates a prioritized improvement plan by flagging high risk issues across the six pillars. This yields actionable remediation steps aligned with AWS best practices for ongoing optimization.

Does the Well-Architected review process support custom lenses for specific workloads?

The Well-Architected review process provides guidance on lenses and WA Tool usage to evaluate diverse workloads. This supports ongoing optimization, governance, and compliance across teams by applying official WA content.

What is the best way to document architecture findings for governance?

Document architecture findings for governance by running formal WA reviews that rate the six pillars and identify high risk issues. This creates a structured record of findings and prioritized improvement plans.

Why do I need to scope reviews before evaluating pillars in the WA Tool?

Scope reviews before evaluating pillars to gather necessary workload context. Defining workload boundaries ensures the WA Tool accurately applies the six pillars and identifies relevant high risk issues.