Modularity Skills

TL;DR: A Claude Code plugin for designing and analyzing modular software systems using the Balanced Coupling model.

There's no shortage of AI tools that provide code-level feedback: best practices, edge cases, potential bugs. That's useful, but it's not where the costly mistakes hide. In the AI era, code is generated faster than ever, and so technical debt accumulates faster too. Any architectural inefficiency, any misdrawn boundary, any unmanaged coupling will grow into a big ball of mud at a pace that wasn't possible before.

This plugin operates at the architectural level. It includes two skills:

• /modularity:review analyzes an existing codebase for coupling imbalances: what knowledge is properly encapsulated, what's leaking across component boundaries, and where cascading changes are waiting to happen. It produces actionable recommendations for improving modularity.
• /modularity:design goes the other direction, designing modular architectures from functional requirements and producing module design docs with integration contracts, test specifications, and a full coupling assessment.

Both skills are grounded in the Balanced Coupling model, so every recommendation traces back to a concrete dimension (integration strength, distance, volatility), not gut feel.

"One of the most useful Claude Code skills for your vibe-coded projects so far!" — Alexei Ledenev (pumba, k8s-mcp-server, ccgram)

Installation

Requires Claude Code v1.0.33 or later.

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: