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

adr-architecture — скилл для Claude Code: пишет ADR с альтернативами

Скилл adr-architecture для Claude Code оформляет ADR: собирает контекст, отклонённые варианты и последствия, проверяет черновик по рубрике. Фиксирует выбор технологии или изменение архитектуры.

лицензия не указана 118 установок ★ 203 обновлён 2026-09-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add lyndonkl/claude --skill adr-architecture -a claude-code
Открыть на GitHub

Что делает adr-architecture

Скилл ведёт по пяти шагам. Сначала разбирает контекст: кто принимает решение, какие ограничения и требования действуют. Потом выбирает шаблон, пишет файл adr-{number}-{short-title}.md, прогоняет его по рубрике и подсказывает, куда положить — в docs/adr/ или architecture/decisions/.

Внутри лежит шаблон resources/template.md для выбора технологий, resources/methodology.md для решений, где несколько выборов зависят друг от друга, и три разобранных примера: выбор базы, переезд на микросервисы, версионирование API. Каждый документ фиксирует контекст, само решение, рассмотренные альтернативы, последствия и статус.

Качество считается по resources/evaluators/rubric_adr_architecture.json, порог — 3.5 балла, для спорных решений скилл советует целиться в 4.5. Переписывать готовый ADR он не станет: меняется только статус, текст остаётся, а новое решение выходит отдельным файлом со ссылкой на предыдущий.

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

  • Зафиксировать, почему взяли PostgreSQL, а не MySQL
  • Оформить переезд на микросервисы вместе с планом отката
  • Описать стандарт версионирования API и исключения из него
  • Заменить устаревший ADR новым, не потеряв историю решений
  • Проверить черновик решения по рубрике до ревью

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

  • Задокументируй выбор базы для нового сервиса как ADR: контекст, альтернативы, последствия
  • Собери ADR про переход на микросервисы по resources/methodology.md и положи в docs/adr/
  • Проверь мой черновик adr-012-api-versioning.md по рубрике и скажи, чего не хватает

Как установить adr-architecture

1Через Skills CLI (Vercel)

npx skills add lyndonkl/claude --skill adr-architecture -a claude-code

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

~/.claude/skills/adr-architecture/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/adr-architecture/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об adr-architecture

Как установить adr-architecture в Claude Code?

Выполните npx skills add lyndonkl/claude --skill adr-architecture -a claude-code. Файл скилла окажется по пути ~/.claude/skills/adr-architecture/SKILL.md.

Что делает adr-architecture?

Помогает написать architecture decision record: собирает контекст, фиксирует решение, альтернативы и последствия, проверяет текст по рубрике и предлагает место для файла.

Можно ли отредактировать старый ADR?

Скилл держит документы неизменными. Меняется только статус, а новое решение оформляется отдельным ADR со ссылкой на предыдущий.

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
architecture-decision-records Seth Hobson Пишет и ведёт Architecture Decision Records (ADR) — документы о технических решениях. Запускается, когда нужно зафиксировать выбор базы, фреймворка или паттерна интеграции. CX Codex +1 22 036установок adr-writer rohitg00 Плагин adr-writer для создания и ведения Architecture Decision Records (ADR) — документов, которые фиксируют важные архитектурные решения и их обоснование. ★ 2 858звёзд репо 030-architecture-adr-general Juan Antonio Breña Moral Скилл 030-architecture-adr-general ведёт диалог с разработчиком и оформляет архитектурные решения (ADR) для Java-проектов в формате MADR. Помогает зафиксировать выбор базы данных или фреймворка. CX Codex +1 373установок adr-drafting giuseppe-trisciuoglio Скилл adr-drafting опрашивает разработчика об архитектурном решении, находит соглашения в репозитории и создаёт новый markdown-документ формата ADR. Пригодится при смене стека или разделении сервисов. CX Codex +1 3 700установок develop-adr product-on-purpose Скилл develop-adr для Claude Code оформляет архитектурное решение по формату Майкла Нигарда: фиксирует контекст, выбор и последствия. CX Codex +1 886установок adr-create ruvnet Скилл adr-create для Claude Code и пяти других платформ создаёт Architecture Decision Record с порядковым номером, регистрирует его в графе AgentDB и связывает с похожими решениями. Запускается на команду с названием решения. CX Codex +1 743установок

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

Весь набор →
one-pager-prd Скилл one-pager-prd помогает оформить идею функции в одностраничный документ или PRD с проблемой, решением, метриками и границами проекта. Пригодится до детального дизайна и разработки. CX Codex +1 125установок environmental-scanning-foresight Скилл environmental-scanning-foresight отслеживает внешние тренды по шести измерениям PESTLE, ловит слабые сигналы перемен, строит сценарии будущего и ставит индикаторы для раннего предупреждения. CX Codex +1 120установок scout-mindset-bias-check Скилл scout-mindset-bias-check для Claude Code проверяет прогнозы на искажения с помощью reversal test, проверки масштаба, status quo bias и аудита доверительных интервалов. CX Codex +1 119установок domain-research-health-science Скилл domain-research-health-science структурирует клинические исследования по моделям PICOT и GRADE. Помогает оценивать риск систематических ошибок и отбирать клинически значимые исходы. CX Codex +1 119установок constraint-based-creativity Скилл constraint-based-creativity ставит ИИ в жёсткие рамки: бюджет, формат, запрет на часть инструментов. Внутри них модель выдаёт идеи, до которых не дошла бы на свободе. CX Codex +1 115установок translation-reframing-audience-shift Скилл translation-reframing-audience-shift переписывает контент под другую аудиторию: техническое описание — для менеджеров, стратегию — в конкретные шаги, экспертный текст — в простой. CX Codex +1 115установок meta-prompt-engineering Скилл meta-prompt-engineering для Claude Code превращает расплывчатый запрос в промпт с ролью, этапами, ограничениями и проверкой качества. Помогает прорабатывать промпты при различиях ответов агента от запуска к запуску. CX Codex +1 114установок systems-thinking-leverage Скилл systems-thinking-leverage ведёт разбор сложной системы по пяти шагам: карта обратных связей, точки вмешательства по иерархии Медоуз, проверка гипотез и план в файле. CX Codex +1 114установок

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

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