software-architecture — скилл для Claude Code
Скилл задаёт агенту правила разработки: ранние возвраты, разбиение длинных функций, доменные имена вместо utils. Пригодится, когда агент пишет или разбирает код проекта.
npx claude-code-templates@latest --skill development/software-architectureЧто делает software-architecture
Скилл опирается на Clean Architecture и Domain Driven Design. Агент получает набор правил стиля: ранний возврат вместо вложенных условий, стрелочные функции, разбиение компонентов длиннее 80 строк и файлов длиннее 200 строк. Дублирование кода предлагается убирать через переиспользуемые функции и модули.
Отдельный блок — про библиотеки. Перед тем как писать своё, агент ищет готовое решение: пакет в npm, сторонний сервис или API. Своя реализация оправдана для доменной логики, чувствительных к производительности участков и кода, где нужен полный контроль над безопасностью. Пример из описания: логику повторов берут из cockatiel, а не пишут руками.
Есть и список антипаттернов. Имена вроде utils, helpers, common и shared считаются плохой практикой — вместо них ждут OrderCalculator или InvoiceGenerator. Бизнес-логику нельзя мешать с UI, а запросы к базе держать в контроллерах. Вложенность ограничена тремя уровнями, функции — 50 строками. Правила жёсткие, и на большом легаси-проекте агент начнёт предлагать рефакторинг там, где вы его не просили.
Какие задачи решает
- разложить бизнес-логику по слоям без привязки к фреймворку
- вынести запросы к базе из контроллеров
- заменить имена вида
utilsиhelpersна доменные - разбить функцию на части, пока она не разрослась
- выбрать готовую библиотеку вместо своей реализации
Примеры запросов агенту
- Спроектируй модуль оформления заказов по Clean Architecture
- Разбери этот файл и скажи, где бизнес-логика смешана с UI
- Проверь код на антипаттерны и предложи, что вынести в отдельный модуль
Как установить software-architecture
1Через claude-code-templates
npx claude-code-templates@latest --skill development/software-architecture2Через Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill software-architecture -a claude-code3Вручную: положить файлы
~/.claude/skills/software-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/software-architecture/
Вручную: положить файлы
.agents/skills/software-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/software-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates software-architecture2Вручную: положить файлы
.github/skills/software-architecture/SKILL.mdКомандой платформы
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/software-architectureВручную: положить файлы
.devin/skills/software-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о software-architecture
Как установить software-architecture в Claude Code?
Через шаблоны: npx claude-code-templates@latest --skill development/software-architecture. Второй способ — npx skills add davila7/claude-code-templates --skill software-architecture -a claude-code. Файл скилла ложится в ~/.claude/skills/software-architecture/SKILL.md.
Что делает software-architecture?
Даёт агенту правила качественной разработки: ранние возвраты, ограничения на длину функций и файлов, доменные имена, разделение слоёв. Агент применяет их, когда пишет код, проектирует архитектуру или разбирает существующий код.
На чём основан этот скилл?
На принципах Clean Architecture и Domain Driven Design. Из них следуют требования к именованию, границам между контекстами и изоляции бизнес-логики от инфраструктуры.
