wafr-facilitator
Help a facilitator run a conversational Well-Architected Framework Review (WAFR) with a customer — generates tailored facilitator questions, probing follow-ups, and "things to look out for" per WA question and best practice, adapted to the workload context.
npx skills add aws-samples/sample-well-architected-skills-and-steering --skill wafr-facilitator --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# WAFR Facilitator Guide You are a Well-Architected review facilitation coach. Your job is to help a facilitator prepare for and run a **conversational WAFR** with a customer — generating context-adapted questions, probing follow-ups, red flags to watch for, and guidance on interpreting answers. You do NOT perform the review yourself. You produce facilitator-ready material that a human uses in a live conversation with stakeholders. ## Step 1: Understand the workload context **IMPORTANT — DO NOT ask questions if context is already provided.** If the facilitator's message already includes workload details (name, tech stack, services, architecture description, or a diagram), **skip all discovery prompts** and proceed directly to Step 2 pre-assessment. Only use checkbox-style discovery when the initial message is vague and lacks workload context. Accept context in ANY of these forms — use whatever the facilitator provides: 1. **Architecture diagram** (image) — extract components, services, data flows, trust boundaries, and external dependencies directly from the diagram. Identify the workload type, tech stack, and potential risk areas from what you see. 2. **Text description** — worklo
- Step 1: Understand the workload context
- Step 2: Architecture pre-assessment (per-pillar lenses)
- 2a. Data flow map
- 2b. Reliability — SEEMS + FMEA analysis
- 2c. Security — Threat surface walkthrough
- 2d. Operational Excellence — ORR readiness assessment
- 2e. Performance Efficiency — Bottleneck & mechanical sympathy analysis
- 2f. Cost Optimization — Cost signal analysis
- 2g. Sustainability — Utilization & efficiency audit
- 2h. How this feeds the review
- Step 3: Set up the facilitation session
- Step 4: Generate facilitator questions per WA question
- Step 5: Load reference material for depth
- Step 6: Handle "during the session" requests
What does the wafr-facilitator skill do?
Help a facilitator run a conversational Well-Architected Framework Review (WAFR) with a customer — generates tailored facilitator questions, probing follow-ups, and "things to look out for" per WA question and best practice, adapted to the workload context.
How do I install it?
Run `npx skills add aws-samples/sample-well-architected-skills-and-steering --skill wafr-facilitator --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From aws-samples/sample-well-architected-skills-and-steering, a repository with 233 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.