adr-architecture — скилл для Claude Code: пишет ADR с альтернативами
Скилл adr-architecture для Claude Code оформляет ADR: собирает контекст, отклонённые варианты и последствия, проверяет черновик по рубрике. Фиксирует выбор технологии или изменение архитектуры.
лицензия не указана 118 установок ★ 203 обновлён 2026-09-01
npx skills add lyndonkl/claude --skill adr-architecture -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/adr-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/adr-architecture/
1Через Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill adr-architecture -a codex2Вручную: положить файлы
.agents/skills/adr-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill adr-architecture -a cursor2Вручную: положить файлы
.cursor/skills/adr-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install lyndonkl/claude skills/adr-architecture2Вручную: положить файлы
.github/skills/adr-architecture/SKILL.md1Через Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill adr-architecture -a gemini-cli2Командой платформы
gemini skills install https://github.com/lyndonkl/claude --path skills/adr-architectureВручную: положить файлы
.devin/skills/adr-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill adr-architecture -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 со ссылкой на предыдущий.