adr — скилл для Claude Code: что делает и как установить
Помогает вести записи архитектурных решений по методологии MADR и Олафа Циммермана прямо в чате с агентом.
лицензия не указана 146 установок ★ 54 обновлён 2026-02-26
npx skills add ncklrs/startup-os-skills --skill adr -a claude-codeЧто делает adr
Скилл ведёт разработчика по полному циклу архитектурных решений (ADR). Он проверяет готовность выбора по критериям START, генерирует структуру в формате MADR и отлавливает 11 типичных антипаттернов. Финальную готовность записи оценивает чеклист ECADR, требующий подтверждений и плана реализации.
Команды запускаются через аргументы: create для пошагового составления, review для разбора готового документа, check-ready и check-done для аудита критериев, а template отдаёт чистый шаблон. Тест архитектурной значимости (ASR) сразу отсекает мелочи: если изменение не несёт бизнес-рисков или влияния на смежные компоненты, тратить время на фиксацию протокола не придётся.
Какие задачи решает
- оформить архитектурный выбор в стандартном формате MADR
- проверить готовность проблемы к фиксации по критериям START
- найти антипаттерны и пробелы в готовом документе ADR
- оценить архитектурную значимость требования перед составлением записи
Примеры запросов агенту
- Проверь через
adr check-ready, готовы ли мы фиксировать переход на PostgreSQL - Сгенерируй чистый шаблон MADR с помощью
adr template - Запусти
adr reviewдля файлаdocs/adr/0004-message-queue.md
Как установить adr
1Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill adr -a claude-code2Вручную: положить файлы
~/.claude/skills/adr/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/adr/
1Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill adr -a codex2Вручную: положить файлы
.agents/skills/adr/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill adr -a cursor2Вручную: положить файлы
.cursor/skills/adr/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ncklrs/startup-os-skills skills/adr2Вручную: положить файлы
.github/skills/adr/SKILL.md1Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill adr -a gemini-cli2Командой платформы
gemini skills install https://github.com/ncklrs/startup-os-skills --path skills/adrВручную: положить файлы
.devin/skills/adr/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill adr -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об adr
Как установить adr в Claude Code?
Выполните команду npx skills add ncklrs/startup-os-skills --skill adr -a claude-code. Файл конфигурации сохранится по пути ~/.claude/skills/adr/SKILL.md.
Что делает этот скилл?
Скилл автоматизирует составление и аудит записей архитектурных решений. Он предлагает готовые шаблоны MADR, оценивает готовность контекста и проверяет полноту аргументации.
Что проверяют критерии START перед созданием ADR?
Чеклист START подтверждает наличие заинтересованных лиц, своевременность момента, наличие минимум двух альтернатив, зафиксированные требования и выбранный шаблон.