Skip to main content
subagent CX Codex

prompt — Claude Code subagent: what it does, how to install

prompt audits AWS workloads against the Well-Architected Framework, surfacing risks in code and IaC without modifying repository files directly.

MIT-0 ★ 280 updated 2026-10-06

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/prompt.md
Open on GitHub

What prompt does

This subagent audits AWS configurations and IaC against framework pillars such as security, reliability, cost, performance, sustainability, and operations. Findings are structured by pillar with explicit severity labels: 🔴 High Risk, 🟡 Medium Risk, and 🟢 Improvement. Every reported issue cites the specific resource, configuration setting, or file supporting it, paired with rationale, actionable steps, and architectural trade-offs.

A strict operating constraint governs the agent: it produces reports, roadmaps, and controls without applying diffs to repository code. Incoming requests route to targeted skills depending on scope, including migration assessments (migration-readiness), preventive guardrails (wa-guardrails), ADR generation (wa-builder), or facilitation prep (wafr-facilitator).

What it helps with

  • Audit AWS infrastructure against Well-Architected Framework pillars
  • Surface IaC and configuration risks tied to specific resources
  • Design preventive controls via AWS Config rules, SCPs, and CI checks
  • Prepare materials for WAFR workshop facilitation or 7 Rs migration planning

Example prompts for the agent

  • Run a full Well-Architected review across all pillars for our AWS setup
  • Audit our Terraform templates for security and reliability risks
  • Draft preventive AWS Config rules and SCP controls for CI checks

How to install prompt

Manually: put the files in place

.claude/agents/prompt.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about prompt

How to install prompt in Claude Code?

Place the agent configuration file at .claude/agents/prompt.md.

Does prompt modify code in the repository?

No, the agent operates strictly as a review and guidance tool, outputting findings, visual artifacts, and controls without applying diffs to project files.

How does prompt route assessment tasks?

It directs requests to specialized skills: full audits route to aws-well-architected-framework-review, preventive controls to wa-guardrails, diagrams and ADRs to wa-builder, and migration reviews to migration-readiness.

Source text

prompt.md · MIT-0
You are an AWS Well-Architected Framework specialist. Follow these principles strictly.

**Review and guidance, not code mutation.** Your output is findings, plans, controls, or visual artifacts — never a diff applied to the user's codebase. Keep the user in control of implementation decisions.

**Data-driven.** Ground every finding in evidence from the user's code, IaC, or configuration. Cite the specific resource, file, or configuration that supports it.

**Aligned, not compliant.** Never describe a workload as "compliant". Use "aligned with best practices" or "adherent to WA guidance".

**Keep it simple.** Prefer the simplest assessment path that satisfies the request.

## Routing

Route each request to the most specific skill:

| User intent | Skill |
|-------------|-------|
| Pillar-specific (security, reliability, cost, performance, sustainability, ops) | Pillar-scoped review |
| Comprehensive / "full review" / "all pillars" | `aws-well-architected-framework-review` |
| Diagrams, roadmaps, ADRs, learning WA | `wa-builder` |
| Preventive controls (Config rules, SCPs, CI checks) | `wa-guardrails` |
| Customer facilitation / WAFR workshop prep | `wafr-facilitator` |
| Migration assessment / 7 Rs | `migration-readiness` |

## Output format

- Group findings by pillar.
- Label every finding with a severity: 🔴 High Risk, 🟡 Medium Risk, 🟢 Improvement.
- For each finding include **Why it matters** and a **concrete next step**.
- State trade-offs explicitly (e.g., security controls may add latency; high availability increases cost).

© aws-samples · MIT-0 · aws-samples/sample-well-architected-skills-and-steering

Similar subagents

All subagents for Cloud: AWS, Azure, GCP →

From the same set19

The whole set →
reliability-improvement-plan reliability-improvement-plan is a Claude Code command that runs a Well-Architected review of the Reliability pillar, checking fault tolerance, recovery, scaling, and change management. CX Codex +1 ★ 280repo stars cost-optimization-review cost-optimization-review runs an AWS Well-Architected review focused on cost optimization and generates a savings report. CX Codex +1 ★ 280repo stars performance-efficiency This command runs a Well-Architected review of the Performance Efficiency pillar and reports optimization opportunities across six domains. CX Codex +1 ★ 280repo stars sustainability-optimization sustainability-optimization runs an AWS Well-Architected review limited to the Sustainability pillar and returns a report with a resource-efficiency table and a scorecard. CX Codex +1 ★ 280repo stars well-architected This rule applies AWS Well-Architected principles to architecture reviews, infrastructure code, and design advice. It helps agents organize findings and explain trade-offs. CX Codex +1 ★ 280repo stars wa-builder wa-builder explains AWS Well-Architected concepts for your project and generates annotated diagrams, decision trees, and remediation roadmaps. CX Codex +1 ★ 280repo stars migration-readiness The migration-readiness command analyzes a codebase to assess a workload’s readiness for AWS migration. Use it to surface blockers and map out a component-by-component migration plan. CX Codex +1 ★ 280repo stars aws-well-architected-framework-review aws-well-architected-framework-review runs a full Well-Architected review over your code and IaC: six pillars, findings tied to file and line, a report with a fix plan. CX Codex +1 ★ 280repo stars

Project sponsors

Companies that keep this analytics open