architecture-decision-record — команда для Claude Code: ADR по коду
Пишет Architecture Decision Record по текущему коду: разбирает состояние репозитория, сравнивает варианты с опорой на код и оценивает влияние на столпы Well-Architected.
MIT-0 ★ 280 обновлён 2026-10-06
.claude/commands/architecture-decision-record.mdЧто делает architecture-decision-record
Команда запускает wa-builder в режиме ADR: агент читает кодовую базу, фиксирует текущее состояние и раскладывает варианты решения, подкрепляя каждый ссылками на конкретные места в коде.
На выходе получается Architecture Decision Record: компромиссы выбранного пути, порядок миграции и условия, при которых запись стоит пересмотреть. Отдельно идёт оценка влияния на столпы Well-Architected.
Сама команда — короткая обёртка. Вся логика лежит в скилле wa-builder, в разделе «Mode: Architecture Decision Record», поэтому без установленного скилла запускать нечего. Файл кладётся в .claude/commands/architecture-decision-record.md.
Какие задачи решает
- зафиксировать, почему выбрали этот вариант, пока причина не забылась
- сравнить два пути миграции с опорой на код
- проверить правку на соответствие столпам Well-Architected
- обновить устаревший ADR под текущее состояние репозитория
- задать условия, при которых решение стоит пересмотреть
Примеры запросов агенту
/architecture-decision-record— запиши решение вынести уведомления в отдельный сервис, опирайся на то, что уже есть в коде/architecture-decision-recordпересмотри ADR по выбору очереди: брокер в коде поменялся, нужны новые условия пересмотра- Разбери переход на другую схему хранения для модуля заказов и оформи как ADR с планом миграции.
Как установить architecture-decision-record
Вручную: положить файлы
.claude/commands/architecture-decision-record.mdВызов — /architecture-decision-record. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/architecture-decision-record.mdВызов — /prompts:architecture-decision-record. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/architecture-decision-record.prompt.mdВручную: положить файлы
.gemini/commands/architecture-decision-record.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы об architecture-decision-record
Как установить architecture-decision-record в Claude Code?
Скопируй файл команды в .claude/commands/architecture-decision-record.md. После этого она вызывается как /architecture-decision-record.
Что делает architecture-decision-record?
Запускает wa-builder в режиме ADR. Агент разбирает код, сравнивает варианты и выдаёт запись о решении: компромиссы и план миграции, плюс условия пересмотра.
Можно ли обойтись без скилла wa-builder?
Нет. Команда ссылается на раздел «Mode: Architecture Decision Record» из скилла wa-builder, так что сначала нужен сам скилл.
Исходный текст
architecture-decision-record.md · MIT-0
Run wa-builder in **ADR mode** to create or revise an Architecture Decision Record. Follow the wa-builder skill, "Mode: Architecture Decision Record" section. Analyze the codebase to understand current state, evaluate options with code evidence, assess WA pillar impact, and produce a structured ADR with trade-offs, migration path, and review triggers. <!-- 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