A Claude Code plugin, vladikk/modularity, addresses the growing problem of technical debt and architectural inefficiency in AI-accelerated software development. It provides two core skills: /modularity:review for analyzing existing codebases for coupling imbalances and /modularity:design for architecting new systems from functional requirements. The plugin targets developers and architects seeking to improve software maintainability and reduce costly architectural mistakes by applying the concrete principles of the Balanced Coupling model.

How It Works

This plugin operates at the architectural level, employing the Balanced Coupling model to evaluate software design. The model assesses coupling across three dimensions: integration strength (knowledge sharing), distance (socio-technical cost), and volatility (business domain change probability). The /modularity:review skill analyzes existing code against these dimensions to identify and report on coupling imbalances, offering actionable recommendations. Conversely, /modularity:design generates modular architectures from functional requirements, producing detailed design documents, integration contracts, and test specifications, while continuously self-reviewing for modularity issues.

Quick Start & Requirements

• Installation:
  • Via Claude Code marketplace: /plugin marketplace add vladikk/modularity followed by /plugin install modularity@vladikk-modularity.
  • Alternatively, clone the repository: git clone https://github.com/vladikk/modularity.git and load via claude --plugin-dir ./modularity.
• Prerequisites: Claude Code v1.0.33 or later.
• Recommended Models: Claude Opus 4.5 or later for nuanced architectural reasoning.
• Documentation: Further details on the Balanced Coupling model are available at coupling.dev.

Highlighted Details

• Operates at the architectural level, identifying systemic issues beyond typical code-level feedback.
• Provides actionable recommendations grounded in the Balanced Coupling model's dimensions (integration strength, distance, volatility).
• /modularity:review generates detailed coupling overview tables and issue descriptions.
• /modularity:design produces comprehensive module design documents, integration contracts, and test specifications.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or roadmap are provided in the README.

Licensing & Compatibility

• License: CC BY-NC-SA 4.0 (Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International).
• Restrictions: The license prohibits commercial use without explicit written permission from the author (contact skill at coupling dot dev). Additionally, the repository and its contents are restricted from use in training, fine-tuning, or developing machine learning models without explicit written permission.

Limitations & Caveats

The plugin is strictly for non-commercial use unless explicit permission is obtained. Its content is explicitly barred from AI model training. Usage is dependent on specific versions of Claude Code and Claude Opus.