К основному содержанию
скилл CX Codex

improve-architecture · rohitg00 — скилл для Claude Code

Скилл improve-architecture диагностирует проблемы архитектуры кода — запутанные границы, дублирование, неправильные швы — и предлагает приоритизированный план минимальных изменений без переписи.

MIT ★ 2 966 обновлён 2026-09-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Открыть на GitHub

Что делает 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-code

3Вручную: положить файлы

~/.claude/skills/improve-architecture/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/improve-architecture/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

improve-architecture daveebbelaar Скилл improve-architecture для Claude Code разбирает архитектуру macOS-приложения на Swift и планирует безопасный рефакторинг. Срабатывает перед крупной функцией, в конце этапа или при повторяющихся проблемах в одной области. CX Codex +1 1 000установок architecture-optimization wondelai Скилл architecture-optimization для Claude Code помогает ускорять работающий код и распутывать границы модулей. Восемь фаз фиксируют решения и измерения в docs/. CX Codex +1 1 700установок improve-code-quality wondelai Скилл improve-code-quality для Claude Code и Codex ведёт проект от непротестированного прототипа к стабильному релизу. Пошаговый план фиксирует тесты, долг и архитектурные решения прямо в папке docs/. CX Codex +1 2 700установок improve owainlewis Скилл improve для Claude Code упрощает существующий код, сохраняя его поведение. Агент ищет дубли, мёртвый код, слабые имена и лишние абстракции. CX Codex +1 372установок platform-architecture-analyze forcedotcom Скилл platform-architecture-analyze проверяет проект Salesforce DX по стандартам Well-Architected. Собирает отчёт по безопасности и лимитам платформы без изменения исходных файлов. CX Codex +1 3 100установок principal-engineering riekelt Скилл principal-engineering задаёт строгие инженерные правила перед правками: запрещает заглушать ошибки, требует чекпоинт рисков и проверку работы реальным кодом, а не догадками. CX Codex +1 25 700установок guarding-architecture riekelt Скилл guarding-architecture защищает архитектурные границы проекта и превращает правила в автоматические тесты сборки. Пригодится при сквозных правках модулей или случайных импортах. CX Codex +1 25 600установок

Из того же набора83

Весь набор →
commit Команда commit собирает изменения в осмысленный git-коммит после линтера, проверки типов и тестов. Подходит для контролируемого завершения работы над задачей. CX Codex +1 ★ 2 966звёзд репо mcp-audit Скилл mcp-audit анализирует подключённые MCP-серверы на предмет токенов, дублирования и безопасности. Запускай, когда сессии медлят или перед добавлением нового сервера. CX Codex +1 ★ 2 966звёзд репо tdd Скилл tdd задаёт для Claude Code цикл разработки через тесты: сначала падающий тест, затем минимальный рабочий код и рефакторинг. CX Codex +1 ★ 2 966звёзд репо module-shape Правило module-shape помогает держать публичный интерфейс модулей узким, а сложность — внутри. Оно пригодится при проектировании и ревью кода. CX Codex +1 ★ 2 966звёзд репо parallel-worktrees Скилл parallel-worktrees для Claude Code создаёт изолированные git-worktrees и запускает параллельные сеансы кодирования. Пока тесты или сборка идут в одном окне, начните новую задачу в другом — без ожидания и переключения контекста. CX Codex +1 ★ 2 966звёзд репо compact-guard Скилл compact-guard для Claude Code сохраняет состояние задачи перед сжатием контекста и помогает восстановить работу после него. Запускается перед /compact или при предупреждении об автосжатии. CX Codex +1 ★ 2 966звёзд репо handoff Команда handoff создаёт структурированный документ для передачи сессии другому Claude или себе в будущем. Содержит статус, решения, найденные ошибки и точку возобновления. CX Codex +1 ★ 2 966звёзд репо replay Команда replay ищет накопленный опыт и прошлые ошибки в базе SQLite перед стартом задачи. Помогает вспомнить тонкости проекта и снизить число правок. CX Codex +1 ★ 2 966звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой