guarding-architecture — скилл для Claude Code: как установить
Защищает архитектурные границы проекта и превращает правила в автоматические тесты сборки. Пригодится при сквозных правках модулей или случайных импортах.
npx skills add riekelt/principal-engineer --skill guarding-architecture -a claude-codeЧто делает guarding-architecture
Скилл требует навыка principal-engineering в качестве основы. Он учит агента фиксировать архитектурные инварианты как строгие правила: формулировка, практический сценарий сбоя и автоматическая проверка. Вместо абстрактных пожеланий создаются конкретные запреты импортов, правила изоляции критических путей и проверки направлений зависимостей.
Архитектурные правила разделяются на два документа: стабильные принципы без имён классов и меняющаяся спецификация с владельцами и тестами. При нарушении контракт не подгоняют под кривой код — его отправляют на рефакторинг. Если проверку нельзя запустить в пайплайне сборки, агент оформляет её как именованный пункт код-ревью.
Исключения допустимы только через официальные поправки или временные подтверждённые разрешения с датой окончания. Попытка добавить импорт «только на время» сразу расценивается как разрушение модульности.
Какие задачи решает
- закрыть несанкционированные импорты между изолированными модулями
- перенести архитектурные соглашения в проверяемые тесты сборки
- защитить горячий путь выполнения от медленного ввода-вывода
- оформить временные архитектурные исключения через срок действия и согласование
Примеры запросов агенту
- Проверь изменения в заказе: они не должны добавлять вызовы из домена во внешние транспорты.
- Зафиксируй правило изоляции критического пути в виде архитектурного контракта и теста.
- Оформи временное исключение для импорта аналитики с датой окончания и фиксацией в спецификации.
Как установить guarding-architecture
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill guarding-architecture -a claude-code2Вручную: положить файлы
~/.claude/skills/guarding-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/guarding-architecture/
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill guarding-architecture -a codex2Вручную: положить файлы
.agents/skills/guarding-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill guarding-architecture -a cursor2Вручную: положить файлы
.cursor/skills/guarding-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install riekelt/principal-engineer guarding-architecture2Вручную: положить файлы
.github/skills/guarding-architecture/SKILL.md1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill guarding-architecture -a gemini-cli2Командой платформы
gemini skills install https://github.com/riekelt/principal-engineer --path plugins/principal-engineer/skills/guarding-architectureВручную: положить файлы
.devin/skills/guarding-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill guarding-architecture -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора4
Похожие
Рядом в теме «Код-ревью и рефакторинг»
Всё по теме «Код-ревью и рефакторинг» →Вопросы о guarding-architecture
Как установить guarding-architecture в Claude Code?
Выполните команду npx skills add riekelt/principal-engineer --skill guarding-architecture -a claude-code в терминале.
Что делает guarding-architecture?
Он превращает архитектурные инварианты в автотесты сборки и правила код-ревью, запрещая размывать границы модулей ради сиюминутных правок.
Что требуется перед началом работы с навыком?
Для работы необходим скилл principal-engineering, на чьи правила и механизмы опираются архитектурные контракты.
