architectural-analysis — скилл для Claude Code: аудит архитектуры кода
Разбирает кодовую базу и находит проблемы проектирования: мёртвый код, дубли, запутанные типы и циклы. Только чтение, если вы сами не разрешили правки.
npx skills add pedronauck/skills --skill architectural-analysis -a claude-codeЧто делает architectural-analysis
Скилл проводит архитектурный аудит в заданных границах: сначала находит точки входа и зависимости через rg --files и точечные поиски, потом разбирает кандидатов по каталогу сигналов из references/detection-catalog.md. Пороги там — подсказки, а не готовые диагнозы.
Мёртвым код не объявляется, пока не проверены динамическая загрузка, рефлексия, хуки фреймворка, тесты и опубликованные API. Публичный экспорт без потребителей в этом чекауте удалять не советуют. Каждую существенную находку скилл подтверждает по исходнику: путь, строка, цена поддержки и минимальное исправление.
Для широкого аудита он опирается на assets/report-template.md и сохраняет отчёт в .audits/architectural-analysis-<timestamp>.md, отдельно помечая проверенные и непроверенные участки. Стиль кода, профилирование производительности, безопасность и ревью фич в его область не входят. Сам аудит ничего не меняет в проекте: правки возможны только при явном разрешении, которое вы дали заранее.
Какие задачи решает
- найти мёртвые экспорты и ответственности, которые дублируются
- разобрать циклы зависимостей между модулями
- понять, почему типы и владение кодом запутались
- получить отчёт с путями и строками вместо общих замечаний
Примеры запросов агенту
- Проведи архитектурный аудит пакета
billingи покажи, где дублируются ответственности - Сохрани отчёт аудита в
.auditsи отметь, какие участки не проверял - Проверь, действительно ли экспорт из
src/legacy/index.tsнигде не используется
Как установить architectural-analysis
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill architectural-analysis -a claude-code2Вручную: положить файлы
~/.claude/skills/architectural-analysis/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/architectural-analysis/
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill architectural-analysis -a codex2Вручную: положить файлы
.agents/skills/architectural-analysis/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill architectural-analysis -a cursor2Вручную: положить файлы
.cursor/skills/architectural-analysis/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills architectural-analysis2Вручную: положить файлы
.github/skills/architectural-analysis/SKILL.md1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill architectural-analysis -a gemini-cli2Командой платформы
gemini skills install https://github.com/pedronauck/skills --path skills/mine/architectural-analysisВручную: положить файлы
.devin/skills/architectural-analysis/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill architectural-analysis -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о architectural-analysis
Как установить architectural-analysis в Claude Code?
Выполните npx skills add pedronauck/skills --skill architectural-analysis -a claude-code. Скилл окажется в ~/.claude/skills/architectural-analysis/SKILL.md.
Что делает architectural-analysis?
Аудит архитектуры: ищет мёртвый код, дубли, путаницу с типами и дорогие в поддержке места. Каждую находку подтверждает по исходнику и предлагает минимальное исправление.
Он удаляет мёртвый код сам?
По умолчанию аудит только читает. Применить находки он может, если явное разрешение уже дано.
