# wa-builder

Скилл wa-builder разбирает AWS Well-Architected применительно к вашей нагрузке, а потом собирает PlantUML-диаграмму с подсветкой столпов, деревья решений и план улучшений.

- скилл · `type=skill` · Claude Code, Cline, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 280 у репозитория
- Автор: aws-samples
- Лицензия: MIT-0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/aws-samples/sample-well-architected-skills-and-steering/tree/HEAD/skills/wa-builder/SKILL.md
- Обновлён: 2026-10-06
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/wa-builder

## Что делает

Скилл работает в два такта: сначала объясняет AWS Well-Architected на вашем проекте, потом выпускает артефакты, которые можно закоммитить. На выходе PlantUML-диаграмма архитектуры с цветной подсветкой здоровья столпов и пометками риск-зон по ID best practices, деревья решений по архитектурным компромиссам и план улучшений в виде Gantt-таймлайна с графом зависимостей. База знаний — шесть столпов и 57 вопросов WA, зашитых в инструкции скилла; отдельные файлы фреймворка не нужны.

Первый шаг — калибровка: имя и описание нагрузки, уровень знакомства с WA, что именно нужно. Уровень скилл может определить сам по лексике: «pillar», «RTO/RPO», «blast radius» в речи означают практика, и обучающую часть он пропустит. Discovery идёт одним из двух путей: сканирование IaC-файлов либо разбор готового отчёта `aws-well-architected-framework-review` с оценками столпов и findings. Перед генерацией артефактов скилл останавливается и ждёт подтверждения.

Отчёт с оценками и находками он не делает. В таких случаях скилл отправляет к `aws-well-architected-framework-review`. Планирование миграции отдано `migration-readiness`, гардрейлы и фасилитация воркшопа — скиллам `wa-guardrails` и `wafr-facilitator`. В наборе он дополняет ревью, а не заменяет его.

## Требования
- Работает с: AWS

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws-samples/sample-well-architected-skills-and-steering --skill wa-builder -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/wa-builder/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/wa-builder/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws-samples/sample-well-architected-skills-and-steering --skill wa-builder -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/wa-builder/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws-samples/sample-well-architected-skills-and-steering --skill wa-builder -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/wa-builder/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aws-samples/sample-well-architected-skills-and-steering skills/wa-builder
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/wa-builder/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws-samples/sample-well-architected-skills-and-steering --skill wa-builder -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aws-samples/sample-well-architected-skills-and-steering --path skills/wa-builder
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/wa-builder/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aws-samples/sample-well-architected-skills-and-steering/tree/HEAD/skills/wa-builder/SKILL.md

## Когда брать
- собрать диаграмму архитектуры с подсветкой здоровья столпов
- показать проблемные места с привязкой к ID best practices
- разложить архитектурные компромиссы по дереву решений
- превратить отчёт ревью в план улучшений с зависимостями
- объяснить новичку, как столпы WA ложатся на его сервисы

## Примеры запросов агенту
- Разбери мой проект на Lambda и DynamoDB по AWS Well-Architected и нарисуй диаграмму с подсветкой проблемных столпов
- Я новичок в WA — объясни на примере нашего ECS-сервиса и построй дерево решений по выбору базы данных
- Собери из отчёта `aws-well-architected-framework-review` план улучшений в виде Gantt-таймлайна

## Похожие
- [aws-architecture-diagram](https://affpapa.org/nevibecode/skills/aws-architecture-diagram.md) — скилл · 872 установки
- [aws-drawio-architecture-diagrams](https://affpapa.org/nevibecode/skills/aws-drawio-architecture-diagrams.md) — скилл · ★ 372 у репозитория
- [AWS Diagram](https://affpapa.org/nevibecode/mcp/aws-diagram.md) — MCP-сервер · ★ 9939 у репозитория
- [aws-well-architected-review](https://affpapa.org/nevibecode/skills/aws-aws-well-architected-review.md) — скилл · 2400 установок
- [aws-architecture-review-expert](https://affpapa.org/nevibecode/agents/aws-architecture-review-expert.md) — субагент · ★ 372 у репозитория
- [aws-diagrams](https://affpapa.org/nevibecode/skills/aws-diagrams.md) — скилл · 1200 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
