by vladikk
Claude Code plugin for designing modular systems from functional requirements and reviewing existing codebases for modularity problems with actionable improvement recommendations. Based on the Balanced Coupling model.
# Add to your Claude Code skills
git clone https://github.com/vladikk/modularityTL;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)
Requires v1.0.33 or later.
No comments yet. Be the first to share your thoughts!
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
/modularity:review — Modularity ReviewAnalyzes an existing codebase for coupling imbalances. Use when:
How it works:
Usage:
/modularity:review
The review output includes hyperlinks to coupling.dev for each coupling concept referenced.
/modularity:design — Modular DesignDesigns modular architectures from functional requirements. Use when:
How it works:
Each step requires your approval before proceeding.
Usage:
/modularity:design
Both skills are grounded in the Balanced Coupling model, which evaluates coupling across three dimensions:
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.
Claude Opus 4.5 or later. The skills rely on nuanced architectural reasoning that benefits from the most capable models.
This work is licensed under CC BY-NC-SA 4.0. For commercial use, contact skill at coupling dot dev.
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.