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.

Claude Code integrates Well-Architected guidance through two mechanisms: CLAUDE.md provides always-on steering that Claude reads at the start of every session, and .claude/commands/ exposes each skill as a slash command you can invoke directly from the terminal. The result is structured, evidence-backed assessments available with a single command.

​
Available slash commands

Once installed, eleven slash commands become available — one for each Well-Architected skill:

/wa-review

Full 6-pillar Well-Architected review with evidence-backed findings and a prioritized remediation plan.

/security-assessment

Deep-dive into IAM, detection controls, data protection, and incident response posture.

/reliability-improvement-plan

Identify single points of failure, recovery gaps, and scaling weaknesses.

/cost-optimization-review

Surface waste, right-sizing opportunities, and pricing model misalignments.

/performance-efficiency

Evaluate resource selection, scaling configurations, and caching strategies.

/sustainability-optimization

Assess utilization, managed service adoption, and carbon footprint reduction opportunities.

/operational-excellence

Review CI/CD maturity, observability coverage, incident management, and automation.

/migration-readiness

Run a 7 Rs assessment and produce a migration readiness report.

/architecture-decision-record

Generate a WA-aligned ADR documenting pillar impact for a design decision.

/wa-builder

Learn Well-Architected for your workload and produce annotated diagrams, decision trees, and roadmaps.

/wa-guardrails

Generate preventive controls — AWS Config rules, SCPs, CI policy checks, and CloudWatch alarms.

​
Installation

1

Copy CLAUDE.md and commands into your project

cp path/to/this-repo/adapters/claude-code/CLAUDE.md ./CLAUDE.md
cp -r path/to/this-repo/adapters/claude-code/commands .claude/commands
Or use the install script from a local clone:
./install.sh ~/my-project --tool claude-code
2

Verify the file structure

After installation, your project should contain:
CLAUDE.md                            ← always-on WA steering
.claude/
  commands/
    wa-review.md
    security-assessment.md
    reliability-improvement-plan.md
    cost-optimization-review.md
    performance-efficiency.md
    sustainability-optimization.md
    operational-excellence.md
    migration-readiness.md
    architecture-decision-record.md
    wa-builder.md
    wa-guardrails.md
3

Run your first review

Open Claude Code in your project directory and type:
/wa-review
Claude Code will launch the full structured Well-Architected review, scanning your IaC and application code for evidence before generating findings.

​
Usage examples

/wa-review

​
Global install

Run the install script with --global to place CLAUDE.md in your home directory. This applies Well-Architected steering to all Claude Code sessions across every project, without needing per-project configuration.
./install.sh --global --tool claude-code
Slash commands are project-scoped (.claude/commands/) and are not affected by the global CLAUDE.md. Install commands per-project where you want structured skill invocations, and use the global CLAUDE.md for always-on pillar awareness everywhere.

Build docs developers (and LLMs) love

Get started for freeTalk to us