К основному содержанию
команда CX Codex

wa-builder — команда для Claude Code: что делает и как установить

Команда wa-builder разбирает архитектуру по принципам AWS Well-Architected и создаёт схемы PlantUML, деревья решений и дорожные карты улучшений.

MIT-0 ★ 280 обновлён 2026-10-06

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/wa-builder.md
Открыть на GitHub

Что делает wa-builder

Команда работает по принципу «сначала обучение, затем сборка». В отличие от классического аудита, цель инструмента — объяснить практики на контексте конкретного проекта. Скрипт сканирует IaC в репозитории либо принимает готовый отчёт от /aws-well-architected-framework-review, чтобы выявить используемые сервисы, вычислительные паттерны и пробелы по шести столпам архитектуры.

Стиль ответа подстраивается под опыт: новичкам модель даёт простые аналогии и поясняет влияние на сервисы, а практикам сразу отдаёт артефакты. На выходе формируются диаграммы в PlantUML и Mermaid с цветовой индикацией рисков (зелёный, жёлтый, красный), блок-схемы ключевых развилок и диаграмма Ганта с зависимостями задач.

Все рекомендации и вызовы проблем привязываются к официальным идентификаторам вопросов фреймворка (вроде SEC 3 или REL 9). Чтобы не переоценивать риски заново, готовый отчёт аудита лучше скармливать команде напрямую.

Какие задачи решает

  • построить архитектурную схему с подсветкой рисков AWS
  • выбрать между архитектурными альтернативами через дерево решений
  • спланировать реалистичную дорожную карту устранения технических долгов в облаке
  • разобрать рекомендации AWS Well-Architected на реальном коде проекта

Примеры запросов агенту

  • /wa-builder разбери наш IaC и подготовь диаграмму в PlantUML с рисками
  • /wa-builder я новичок в Well-Architected, объясни пробелы в безопасности и сделай дерево решений
  • /wa-builder вот отчёт аудита, собери дорожную карту улучшений в Mermaid

Как установить wa-builder

Вручную: положить файлы

.claude/commands/wa-builder.md

Вызов — /wa-builder. Для всех проектов — ~/.claude/commands/

Вопросы о wa-builder

Как установить wa-builder в Claude Code?

Сохраните файл команды по пути .claude/commands/wa-builder.md внутри вашего проекта.

Что делает wa-builder?

Команда анализирует инфраструктурный код, выявляет риски по шести столпам AWS Well-Architected и генерирует наглядные диаграммы, блок-схемы развилок и план улучшений.

Чем wa-builder отличается от review-команды?

Обычный ревью выставляет баллы и оценивает проект, а wa-builder ориентирован на обучение инженера и генерирует готовые схемы и деревья решений для репозитория.

Исходный текст

wa-builder.md · MIT-0
"Learn then Build" — help the user understand AWS Well-Architected best practices for their specific workload, then produce actionable visual artifacts (architecture diagrams with WA annotations, decision trees, improvement roadmaps) they can commit and use.

Unlike `/aws-well-architected-framework-review` (which assesses and scores), wa-builder teaches and enables. Adapt explanations for beginners and generate artifacts faster for experienced builders.

## Step 1: Context and calibration

Ask the user:

> I can help you understand Well-Architected for your project and produce visual artifacts. Let me know:
> - **Workload name** and brief description (or point me at your code)
> - **Your WA familiarity**: New to WA / Familiar / Practitioner
> - **What you want**: Architecture diagram, decision tree, roadmap, or all three
> - **Existing review** (optional): If you have a `/aws-well-architected-framework-review` output, share it for richer artifacts

If context is already provided or you are in a codebase, proceed directly.

**Detect experience** if not stated:
- Uses "pillar", "HRI", "RTO/RPO", "blast radius" naturally → **Practitioner** (skip learning, go straight to artifacts)
- Asks "what is WA" or "how does this apply" → **Beginner** (full explanations with analogies)
- Default → **Familiar** (concise pillar relevance)

## Step 2: Workload discovery

**Path A — Standalone (no prior review):** lightweight discovery — scan IaC for resource types, identify compute pattern (serverless/containers/VMs/mixed), data stores, network topology, deployment patterns. Produce a workload profile: architecture pattern, AWS services in use, per-pillar health signals, top 3 risk hotspots.

**Path B — Post-review (consumes a `/aws-well-architected-framework-review` output):** parse the report for pillar scores, findings by severity, evidence locations, remediation items, and any PlantUML diagram. Use directly — skip discovery, do NOT re-assess.

## Step 3: Learning phase

**Skip entirely for Practitioners.** For Beginners and Familiar, personalize WA to their workload, prioritized by gap severity.

- **Beginner**: for each relevant pillar, explain "Why it matters for YOU" (reference their actual services), top 3 concepts with WA Question IDs, and one developer-friendly analogy.
- **Familiar**: terse per-pillar key-gap list with Question/BP IDs.

Select concepts by mapping the workload's gaps to WA questions (OPS 1–11, SEC 1–11, REL 1–13, PERF 1–5, COST 1–11, SUS 1–6), clustering related questions, and ordering by risk severity then relevance.

## Step 4: Artifact generation

Generate ALL requested artifacts. Each MUST include BP ID references, color/severity indicators, and context specific to THEIR workload (never generic).

**Artifact 1 — Architecture diagram with WA annotations:** PlantUML (primary) + Mermaid alternative. Color-coded component borders — 🟢 key BPs implemented, 🟡 partial gaps, 🔴 critical/high gaps — plus risk-hotspot callouts citing BP IDs and a legend.

**Artifact 2 — Decision trees:** 2–3 Mermaid flowcharts for the most impactful architectural choices (e.g. serverless vs containers, single vs multi-region, canary vs blue/green). Start from their workload context, branch on WA-relevant criteria (availability target, cost tolerance, compliance), end with recommendations citing BP IDs and effort/cost indicators. Present OPTIONS, not mandates.

**Artifact 3 — Improvement roadmap:** Mermaid Gantt chart (Quick Wins → Foundation → Strategic) plus an ASCII dependency graph showing what blocks what. Order by prerequisite relationships, then effort phase, then severity. Keep it REALISTIC — do not pack everything into "Quick Wins".

## Step 5: Commit guidance

Suggest where to save the artifacts, e.g.:
- `docs/architecture/wa-annotated.puml` — architecture with pillar health
- `docs/decisions/{topic}-decision.md` — decision tree(s)
- `docs/roadmap/wa-improvement-roadmap.md` — Gantt + dependency graph

Then offer to refine an artifact, deep-dive a decision, generate IaC for a roadmap item, create an ADR (`/architecture-decision-record`), or run a full `/aws-well-architected-framework-review` for precise per-BP scoring.

## Calibration

- This skill is about ENABLEMENT, not JUDGMENT — tone is encouraging, not critical
- Beginners: analogies, avoid jargon, explain why before what. Practitioners: concise, artifacts fast
- Decision trees present options; the builder decides
- Always tie back to WA Framework Question IDs (OPS 4, SEC 3, REL 9, etc.) so builders can look up details
- When generating from a `/aws-well-architected-framework-review`, USE its findings — don't re-assess
- PlantUML is primary (broadest support); Mermaid is the alternative (renders in GitHub/VS Code); ASCII fallbacks work everywhere

<!--
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
SPDX-License-Identifier: MIT-0
-->

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

Похожие слэш-команды

Все слэш-команды по теме «Облака: AWS, Azure, GCP» →
aws-well-architected-review aws Скилл aws-well-architected-review проводит ревью рабочей нагрузки по AWS Well-Architected Framework: читает код и IaC, сверяет с живой документацией AWS и выдаёт отчёт с приоритетами. CX Codex +1 2 400установок aws-architecture-review-expert Giuseppe Trisciuoglio Субагент aws-architecture-review-expert проверяет шаблоны CloudFormation и архитектуру AWS по шести столпам Well-Architected Framework и находит проблемы безопасности. CX Codex ★ 372звёзд репо cloud-solution-architect microsoft Скилл cloud-solution-architect превращает ИИ-агента в архитектора облачных решений по стандартам Azure Architecture Center. Помогает выбирать архитектурные стили и проверять дизайн систем по правилам WAF. CX Codex +1 117установок architecture-diagrams aj-geddes Скилл architecture-diagrams помогает генерировать схемы архитектуры, потоки данных и C4-диаграммы в текстовом формате Mermaid или PlantUML. Пригодится при оформлении технической документации прямо в чате с агентом. CX Codex +1 2 000установок aws-cloud-architecture manutej Скилл aws-cloud-architecture помогает проектировать AWS-архитектуру: от EC2 и хранилищ до безопасности, бессерверных систем и расходов. Пригодится при планировании или настройке облачной инфраструктуры. CX Codex +1 600установок architect-for-startups aws Скилл architect-for-startups для Claude Code подбирает архитектуру AWS под стадию стартапа, размер команды и остаток грантов. Помогает выбрать сервисы без написания кода. CX Codex +1 577установок

Из того же набора19

Весь набор →
performance-efficiency Команда проверяет проект по разделу Performance Efficiency фреймворка Well-Architected и готовит отчёт с возможностями оптимизации. CX Codex +1 ★ 280звёзд репо sustainability-optimization Команда sustainability-optimization запускает разбор архитектуры по AWS Well-Architected, ограниченный столпом Sustainability, и выдаёт отчёт с таблицей возможностей и скорингом. CX Codex +1 ★ 280звёзд репо prompt Субагент prompt проводит аудит инфраструктуры AWS по Well-Architected Framework, находя риски в коде и IaC без автоматических правок в репозитории. CX Codex +1 ★ 280звёзд репо well-architected Правило применяет принципы AWS Well-Architected при разборе архитектуры, проектировании систем и написании инфраструктурного кода. Помогает структурировать рекомендации и явно показывать компромиссы. CX Codex +1 ★ 280звёзд репо migration-readiness Команда migration-readiness анализирует кодовую базу и оценивает готовность нагрузки к переносу в AWS. Она пригодится, чтобы найти блокеры и составить план миграции по компонентам. CX Codex +1 ★ 280звёзд репо aws-well-architected-framework-review Правило aws-well-architected-framework-review прогоняет полный обзор Well-Architected по коду и IaC: шесть столпов, находки со ссылками на файл и строку, отчёт с планом исправлений. CX Codex +1 ★ 280звёзд репо wa-guardrails Команда wa-guardrails генерирует превентивные правила AWS Well-Architected: проверки в CI, правила AWS Config, SCP и алерты CloudWatch для защиты инфраструктуры от регрессий. CX Codex +1 ★ 280звёзд репо aws-well-architected-framework-review Команда aws-well-architected-framework-review для Claude Code проверяет AWS-нагрузку по столпам Well-Architected Framework и связывает риски с кодом и инфраструктурой. Разбирает IaC, конфигурации и архитектуру приложения. CX Codex +1 ★ 280звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой