Add the marketplace and install the plugin:

/plugin marketplace add vladikk/modularity
/plugin install modularity@vladikk-modularity

Alternatively, clone the repo and load it directly:

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

Skills

/modularity:review — Modularity Review

Analyzes an existing codebase for coupling imbalances. Use when:

• Reviewing code for coupling problems
• Assessing architecture quality
• Identifying distributed monolith risks
• Investigating why changes in one area break things elsewhere

How it works:

1. Reads your code and functional requirements
2. Asks you about domain classification (core/supporting/generic), team structure, and known pain points
3. Maps integrations between components across three dimensions: integration strength, distance, and volatility
4. Applies the balance rule to flag imbalances
5. Produces a review document (Markdown + HTML) with a coupling overview table, issue descriptions, and concrete improvement recommendations

Usage:

/modularity:review

The review output includes hyperlinks to coupling.dev for each coupling concept referenced.

/modularity:design — Modular Design

Designs modular architectures from functional requirements. Use when:

• Designing a new system from scratch
• Creating architecture documentation for an existing system
• Producing module-level design specs with integration contracts and test specifications

How it works:

1. Reads your functional requirements and asks clarifying questions
2. Classifies domain areas by volatility (core/supporting/generic subdomains)
3. Designs the modular architecture, assessing coupling across all three dimensions
4. Produces design documents for each module (responsibilities, encapsulated knowledge, integration contracts, change vectors)
5. Produces test specifications for each module
6. Produces an architecture overview document
7. Self-reviews the design for modularity imbalances and iterates until clean

Each step requires your approval before proceeding.

Usage:

/modularity:design

The Balanced Coupling Model

Both skills are grounded in the Balanced Coupling model, which evaluates coupling across three dimensions:

• Integration Strength — how much knowledge is shared between components (intrusive > functional > model > contract)
• Distance — the socio-technical cost of co-evolving components (code structure, team boundaries, runtime dependencies)
• Volatility — the probability of a component needing to change, evaluated from the business domain perspective

The balance rule: BALANCE = (STRENGTH XOR DISTANCE) OR NOT VOLATILITY

Coupling is balanced when strength and distance counterbalance each other, or when volatility is low enough to neutralize the imbalance.

Learn more at coupling.dev.

Recommended Models

Claude Opus 4.5 or later. The skills rely on nuanced architectural reasoning that benefits from the most capable models.

License

This work is licensed under CC BY-NC-SA 4.0. For commercial use, contact skill at coupling dot dev.

AI Training Restriction

This repository and its contents may not be used for training, fine-tuning, or any other form of machine learning model development without explicit written permission from the author.