architectural-design-principles — скилл для Claude Code: слои
Справочник архитектурных правил для системного дизайна: слои, направление зависимостей, ports and adapters, двенадцать факторов облачных приложений. Помогает оформить ограничения так, чтобы их проверяли тесты, а не обещания.
npx skills add databricks-solutions/consort --skill architectural-design-principles -a claude-codeЧто делает architectural-design-principles
Скилл содержит набор архитектурных правил, которые выше уровня функций и классов. Пока software-design-principles говорит, как писать код внутри модуля, это скилл описывает, как устроена сама система: на какие слои она разбита, как они друг от друга зависят, где живёт конфиг и состояние, как персистентность присоединяется как сервис.
Центральная идея — каждое правило должно быть защищено fitness-функцией, то есть тестом или автоматической проверкой, которая валится на CI, если правило нарушено. Просто написать «зависимости указывают внутрь» недостаточно; нужна проверка в сборке, которая этого добьёт. Скилл предлагает чек-лист перед merge: направление зависимостей, слой persistence, конфиг в переменных окружения, statelessness, backing services как ресурсы, политика моков.
Импортируется workflow-скиллами (consort, lakebase-scm-workflows). Используй его, когда определяешь границу системы, решаешь, что такое backing service, картируешь конфиг на окружение, или пишешь fitness-функции, которые будут держать архитектуру честной по мере её эволюции.
Какие задачи решает
- убедить команду, что архитектурные ограничения надо автоматизировать
- настроить проверку слоёв и направления зависимостей
- определить, где может жить конфиг и состояние
- спроектировать слой персистентности через ORM
- добавить fitness-функции для эволюции схемы БД
Примеры запросов агенту
- Объясни, как спроектировать слои приложения так, чтобы HTTP не импортировал сервис
- Покажи, как оформить правило про то, что raw SQL только в слое repository
- Напиши fitness-функции для чека-листа перед merge
Как установить architectural-design-principles
1Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill architectural-design-principles -a claude-code2Вручную: положить файлы
~/.claude/skills/architectural-design-principles/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/architectural-design-principles/
1Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill architectural-design-principles -a codex2Вручную: положить файлы
.agents/skills/architectural-design-principles/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill architectural-design-principles -a cursor2Вручную: положить файлы
.cursor/skills/architectural-design-principles/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install databricks-solutions/consort architectural-design-principles2Вручную: положить файлы
.github/skills/architectural-design-principles/SKILL.md1Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill architectural-design-principles -a gemini-cli2Командой платформы
gemini skills install https://github.com/databricks-solutions/consort --path skills/architectural-design-principlesВручную: положить файлы
.devin/skills/architectural-design-principles/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill architectural-design-principles -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о architectural-design-principles
Как установить architectural-design-principles в Claude Code?
Выполни npx skills add databricks-solutions/consort --skill architectural-design-principles -a claude-code, затем посмотри файл ~/.claude/skills/architectural-design-principles/SKILL.md.
Что такое architectural-design-principles?
Это справочник правил архитектуры системы — слои, направление зависимостей, конфиг в переменных окружения, backing services, stateless processes. Каждое правило связано с fitness-функцией, которая его проверяет на CI.
Чем это отличается от software-design-principles?
software-design-principles говорит о коде внутри модуля (SOLID, DRY, чистый код). architectural-design-principles описывает устройство всей системы и её слоёв — это уровень выше.
