improve-architecture · rohitg00 — скилл для Claude Code
Скилл improve-architecture диагностирует проблемы архитектуры кода — запутанные границы, дублирование, неправильные швы — и предлагает приоритизированный план минимальных изменений без переписи.
MIT ★ 2 966 обновлён 2026-09-29
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflowЧто делает improve-architecture
Скилл анализирует фрагмент кодовой базы, находит узкие места в структуре и выписывает пошаговые ходы, которые её улучшают. Начинает с карты текущей формы: точки входа, модули, потоки данных. Затем ищет настоящие проблемы — бог-модули, утёкшие границы, дублированную логику, циклические зависимости, швы в неправильных местах — и ранжирует ходы по рычагу (облегчение боли на единицу работы). Для крупных изменений предлагает написать решение в docs/decisions/.
Вывод — это план, который ты одобряешь перед тем, как делать правки в коде. Скилл не переписывает: его задача диагностика и рекомендация, не исполнение. Гарантирует, что каждый ход решает названную проблему, а не гонку за чистотой.
Какие задачи решает
- найти модули, которые везде импортируются и становятся узким местом
- обнаружить дублированную логику, которая расходится между реализациями
- развязать циклические зависимости между компонентами
- выправить границы модулей, которые не соответствуют предметной области
- расставить швы так, чтобы код было проще менять
Примеры запросов агенту
- Аудит архитектуры в
src/auth/— найди узкие места и предложи трёхходовый план улучшений - В нашей системе всё тянет из
utils— как развязать и разделить её? - Посмотри, как устроены модели данных, и предложи минимальные переносы, чтобы граница между слоём бизнес-логики и слоем хранения была чёткой
Как установить improve-architecture
1Через маркетплейс плагинов
/plugin marketplace add rohitg00/pro-workflow/plugin install pro-workflow@pro-workflowКоманда ставит плагин pro-workflow целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill improve-architecture -a claude-code3Вручную: положить файлы
~/.claude/skills/improve-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/improve-architecture/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill improve-architecture -a codex2Вручную: положить файлы
.agents/skills/improve-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill improve-architecture -a cursor2Вручную: положить файлы
.cursor/skills/improve-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rohitg00/pro-workflow skills/improve-architecture2Вручную: положить файлы
.github/skills/improve-architecture/SKILL.md1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill improve-architecture -a gemini-cli2Командой платформы
gemini skills install https://github.com/rohitg00/pro-workflow --path skills/improve-architectureВручную: положить файлы
.devin/skills/improve-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об improve-architecture
Как установить improve-architecture в Claude Code?
Выполни по очереди: /plugin marketplace add rohitg00/pro-workflow, затем /plugin install pro-workflow@pro-workflow, потом npx skills add rohitg00/pro-workflow --skill improve-architecture -a claude-code. Конфигурация будет в ~/.claude/skills/improve-architecture/SKILL.md.
Что делает скилл improve-architecture?
Анализирует структуру кода, находит проблемы вроде запутанных границ и дублирования, и предлагает приоритизированный список минимальных ходов, которые её улучшат. Не переписывает код — только выписывает план.
Нужны ли тесты перед использованием скилла?
Не всегда. Скилл диагностирует и предлагает; ты решаешь, какие ходы делать. Для крупных структурных перемен скилл рекомендует сначала закрыть поведение тестами — тогда рефакторинг будет безопаснее.
Исходный текст
SKILL.md · MIT
---
name: improve-architecture
description: Audit an area of the codebase and propose the smallest structural moves that improve it - untangle boundaries, kill duplication, fix seams, break cycles. Produces a prioritized plan and decision records, not a rewrite. Use when a codebase feels tangled, hard to change, or is becoming a ball of mud, or when asked to improve or refactor architecture.
user-invocable: true
---
# improve-architecture
Invest in the shape of the system a little at a time rather than paying for a
rewrite later. This skill diagnoses and proposes; it does not rewrite on its own.
## Method
1. **Map first.** Get the current shape before judging it - entry points,
modules, data flow, who calls whom. Reuse `module-map` for the one-screen
view; do not skip to opinions.
2. **Find the strain.** Look for the load-bearing problems, not style nits:
- God modules that everything imports and nothing can change safely.
- Leaky boundaries - a module reaching into another's internals instead of
its surface.
- Duplicated logic that drifts (the same rule implemented three ways).
- Wrong seams - the code is split where it does not bend and fused where it
does.
- Cyclic dependencies.
- A shape that fights the domain (see `domain-modeling` - boundaries in code
should track boundaries in the language).
3. **Propose the smallest move.** For each problem, the least change that
relieves it: extract a boundary, collapse a duplicate, invert a dependency,
move a seam. Prefer a sequence of safe steps over one big cut.
4. **Rank by leverage.** Order the moves by pain relieved over effort. Say which
are safe now and which need a test net first (pair with `tdd`).
5. **Record the big calls.** For a structural change a future reader would
question, write a decision record in `docs/decisions/NNNN-slug.md`: context,
choice, alternatives rejected, why.
## Guardrails
- Diagnose, do not rewrite. The deliverable is a plan the user approves before
any code moves.
- No churn for taste. A move must relieve a named strain; "cleaner" is not a
reason.
- Three similar lines beat a premature abstraction - do not trade duplication
for indirection unless the duplication actually drifts.
- Keep behavior fixed. Structural moves are refactors; land them behind green
tests.
## Output
A prioritized list: each item is the problem, the smallest move, the risk, and
whether it needs a test net first. Plus decision records for the big moves. No
code changes until the user picks what to do.
© Rohit Ghumare · MIT · rohitg00/pro-workflow
Похожие скиллы
Все скиллы по теме «Код-ревью и рефакторинг» →Сначала — improve-architecture от других авторов.