Modularity Skills

Кратко: Плагин для Claude Code, предназначенный для проектирования и анализа модульных программных систем на основе модели Balanced Coupling.

Инструментов для анализа кода на уровне реализации предостаточно: лучшие практики, граничные случаи, потенциальные баги. Это полезно, но именно там дорогостоящие ошибки не прячутся. В эпоху AI код генерируется быстрее, чем когда-либо, а значит и технический долг накапливается быстрее. Любая архитектурная неэффективность, любая неверно проведённая граница, любая неуправляемая связанность превратится в «большой ком грязи» с темпом, который раньше был невозможен.

Этот плагин работает на архитектурном уровне. Он включает два скилла:

• /modularity:review анализирует существующую кодовую базу на дисбалансы связанности: какие знания корректно инкапсулированы, что утекает через границы компонентов и где ждут своего часа каскадные изменения. Формирует конкретные рекомендации по улучшению модульности.
• /modularity:design работает в обратном направлении — проектирует модульные архитектуры из функциональных требований и создаёт документы по дизайну модулей с интеграционными контрактами, спецификациями тестов и полной оценкой связанности.

Оба скилла основаны на модели Balanced Coupling, поэтому каждая рекомендация привязана к конкретному измерению (сила интеграции, дистанция, волатильность), а не к интуиции.

«Один из самых полезных скиллов Claude Code для ваших vibe-coded проектов на сегодняшний день!» — Alexei Ledenev (pumba, k8s-mcp-server, ccgram)

Установка

Требуется Claude Code версии v1.0.33 или новее.

Добавьте маркетплейс и установите плагин:

Как вариант, клонируйте репозиторий и загрузите напрямую:

git clone https://github.com/vladikk/modularity.git
claude --plugin-dir ./modularity

Скиллы

/modularity:review — Ревью модульности

Анализирует существующую кодовую базу на дисбалансы связанности. Используйте когда:

• Проводите ревью кода на предмет проблем со связанностью
• Оцениваете качество архитектуры
• Выявляете риски распределённого монолита
• Разбираетесь, почему изменения в одной области ломают другие

Как работает:

1. Читает ваш код и функциональные требования
2. Задаёт вопросы о классификации домена (core/supporting/generic), структуре команды и известных болевых точках
3. Составляет карту интеграций между компонентами по трём измерениям: сила интеграции, дистанция и волатильность
4. Применяет правило баланса для выявления дисбалансов
5. Формирует документ ревью (Markdown + HTML) с таблицей обзора связанности, описанием проблем и конкретными рекомендациями по улучшению

Использование:

Вывод ревью содержит гиперссылки на coupling.dev для каждого упомянутого концепта связанности.

/modularity:design — Модульное проектирование

Проектирует модульные архитектуры из функциональных требований. Используйте когда:

• Проектируете новую систему с нуля
• Создаёте архитектурную документацию для существующей системы
• Формируете спецификации дизайна на уровне модулей с интеграционными контрактами и спецификациями тестов

Как работает:

1. Читает ваши функциональные требования и задаёт уточняющие вопросы
2. Классифицирует области домена по волатильности (core/supporting/generic субдомены)
3. Проектирует модульную архитектуру, оценивая связанность по всем трём измерениям
4. Формирует документы дизайна для каждого модуля (ответственности, инкапсулированные знания, интеграционные контракты, векторы изменений)
5. Формирует спецификации тестов для каждого модуля
6. Формирует обзорный документ архитектуры
7. Самостоятельно проверяет дизайн на дисбалансы модульности и итерирует до получения чистого результата

Каждый шаг требует вашего подтверждения перед продолжением.

Использование:

Модель Balanced Coupling

Оба скилла основаны на модели Balanced Coupling, которая оценивает связанность по трём измерениям:

• Сила интеграции — объём знаний, разделяемых между компонентами (intrusive > functional > model > contract)
• Дистанция — социотехническая стоимость совместной эволюции компонентов (структура кода, границы команд, зависимости времени выполнения)
• Волатильность — вероятность того, что компонент потребует изменений, оцениваемая с точки зрения бизнес-домена

Правило баланса: BALANCE = (STRENGTH XOR DISTANCE) OR NOT VOLATILITY

Связанность сбалансирована, когда сила и дистанция уравновешивают друг друга, или когда волатильность достаточно низка, чтобы нейтрализовать дисбаланс.

Подробнее на coupling.dev.

Рекомендуемые модели

Claude Opus 4.5 или новее. Скиллы опираются на тонкие архитектурные рассуждения, которые выигрывают от использования наиболее мощных моделей.

Лицензия

Эта работа распространяется под лицензией CC BY-NC-SA 4.0. По вопросам коммерческого использования обращайтесь: skill at coupling dot dev.

Ограничение на обучение AI

Данный репозиторий и его содержимое не могут использоваться для обучения, дообучения или любой другой формы разработки моделей машинного обучения без явного письменного разрешения автора.