Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/aws-samples/sample-well-architected-skills-and-steering/llms.txt

Use this file to discover all available pages before exploring further.

Well-Architected Skills & Steering brings the AWS Well-Architected Framework directly into your AI coding agent. Instead of treating architecture reviews as a separate gate, developers get continuous, evidence-backed guidance across all 6 pillars — right in the IDE, at the moment code is written. One set of skills works across 13 supported tools with no AWS credentials required.

Quickstart

Install Well-Architected skills into your project in under a minute using a one-liner or bootstrap script.

How It Works

Understand the skills, steering, adapters, and powers architecture that spans 13 AI coding tools.

Skills Reference

Browse all 11 skill playbooks covering every pillar — from full WA reviews to guardrail generation.

Tool Guides

Step-by-step installation guides for every supported AI coding tool.

​
What’s included

11 Skills

Playbooks for full WA reviews, security assessments, reliability plans, cost reviews, migration readiness, and more.

13 Tools

Kiro, Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, Gemini CLI, Antigravity, Junie, Amp, OpenClaw, Cline, and AWS DevOps Agent.

307 Best Practices

All 57 WA framework questions with best-practice-level detail, plus 27 lens packs for specialized workloads.

​
Get started in seconds

1

Install via npx (auto-detects your tool)

npx skills add aws-samples/sample-well-architected-skills-and-steering
Auto-detects the AI coding tools configured in your project and installs the right files for each.
2

Or use a bootstrap script

curl -sL https://raw.githubusercontent.com/aws-samples/sample-well-architected-skills-and-steering/main/bootstrap.sh | bash
3

Ask your AI agent a Well-Architected question

What Well-Architected pillars should I consider for this architecture?
If configured correctly, your agent will reference all six pillars with specific guidance rather than a generic answer.
4

Run a full review (optional)

For Claude Code users, invoke the slash command directly:
/wa-review
For Kiro users, steering loads automatically — just mention “architecture review” and WA principles apply.

​
Supported tools

ToolTypeMechanism
KiroIDE.kiro/steering/*.md + .kiro/skills/
Claude CodeIDECLAUDE.md + .claude/commands/
CursorIDE.cursor/rules/*.md
WindsurfIDE.windsurfrules
ClineIDE.clinerules
CodexCLIAGENTS.md + skills/
Gemini CLICLIGEMINI.md + skills/
AmpCLIAGENTS.md + .agents/skills/
OpenClawCLIAGENTS.md + .agents/skills/
GitHub CopilotPlatform.github/copilot-instructions.md
JuniePlatform.junie/guidelines/ + .junie/skills/
AntigravityPlatform.agents/rules/ + .agents/skills/
AWS DevOps AgentPlatformSKILL.md zip upload
Use --symlink (bash) or -Symlink (PowerShell) during installation to create symbolic links instead of copies. When this repo updates, your project picks up changes automatically without reinstalling.

Build docs developers (and LLMs) love

Get started for freeTalk to us