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

architecture-decision-record — команда для Claude Code: ADR по коду

Пишет Architecture Decision Record по текущему коду: разбирает состояние репозитория, сравнивает варианты с опорой на код и оценивает влияние на столпы Well-Architected.

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

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

Что делает 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/

Вопросы об 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

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

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
create-architectural-decision-record официальный github Скилл create-architectural-decision-record для GitHub Copilot создаёт запись об архитектурном решении в формате ADR — сохраняет причины выбора и последствия для проекта. CX Codex +1 10 176установок architecture-decision Donchitos Скилл architecture-decision для Claude Code и Codex ведёт агента через создание ADR: контекст, рассмотренные варианты, последствия. Фиксирует архитектурное решение письменно. CX Codex +1 679установок architecture-decision-records Seth Hobson Пишет и ведёт Architecture Decision Records (ADR) — документы о технических решениях. Запускается, когда нужно зафиксировать выбор базы, фреймворка или паттерна интеграции. CX Codex +1 22 036установок record-a-decision Inkeep Скилл record-a-decision для Claude Code оформляет принятое архитектурное решение в ADR с контекстом, вариантами и последствиями. Ведёт последовательный журнал решений. CX Codex +1 252установок adr-decision-extraction existential-birds Скилл adr-decision-extraction извлекает архитектурные решения из чатов и расшифровок, чтобы подготовить материал для ADR. Он распознаёт выбор технологий, компромиссы и явные метки. CX Codex +1 144установок adrkit decision memory mbeacom MCP-сервер adrkit decision memory даёт агентам доступ к архитектурным решениям в Git без обращения к внешним сетям. Помогает избежать повторного обсуждения отклонённых идей. CX Codex +1 ★ 26звёзд репо

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

Весь набор →
migration-readiness Скилл migration-readiness разбирает код, зависимости и инфраструктуру проекта и говорит, что мешает перенести нагрузку в AWS. Пригодится перед миграцией, когда непонятно, с чего начать. CX Codex +1 565установок wa-guardrails Скилл wa-guardrails генерирует превентивные и детективные контроли Well-Architected: правила AWS Config, SCP, permission boundaries, алерты CloudWatch и проверки политик в IaC. CX Codex +1 383установок aws-well-architected-framework-review Скилл aws-well-architected-framework-review для Claude Code проверяет архитектуру AWS по вопросам Well-Architected Framework. Анализирует код и IaC, затем готовит выводы с подтверждениями и приоритетами исправлений. CX Codex +1 339установок wafr-facilitator Скилл wafr-facilitator готовит архитектора к живому интервью по Well-Architected Framework. Он изучает схемы или код и создаёт прицельные вопросы для диалога с заказчиком. CX Codex +1 331установок security-assessment Команда security-assessment запускает аудит инфраструктуры по направлению безопасности AWS Well-Architected. Проверяет IAM, шифрование и защиту вычислений. CX Codex +1 ★ 280звёзд репо operational-excellence Проводит обзор Operational Excellence по AWS Well-Architected Framework и выдаёт отчёт с оценкой зрелости. Обзор охватывает CI/CD, наблюдаемость и управление инцидентами. CX Codex +1 ★ 280звёзд репо reliability-improvement-plan Команда reliability-improvement-plan запускает Well-Architected обзор по столпу Reliability: проверяет отказоустойчивость, восстановление, масштабирование и управление изменениями. CX Codex +1 ★ 280звёзд репо cost-optimization-review Команда cost-optimization-review запускает аудит архитектуры AWS по направлению оптимизации затрат и формирует отчёт об экономии. CX Codex +1 ★ 280звёзд репо

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

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