vladikk/modularity

What it solves

This project provides a way to prevent "big ball of mud" architectures and technical debt in AI-generated codebases. It moves beyond simple code-level feedback to address architectural inefficiencies, misdrawn boundaries, and unmanaged coupling between software components.

How it works

It is a plugin for Claude Code that implements the Balanced Coupling model. This model evaluates software coupling across three dimensions: integration strength (how much knowledge is shared), distance (the socio-technical cost of evolution), and volatility (the probability of change).

The plugin offers two primary skills:

• /modularity:review: Analyzes existing code and requirements to identify coupling imbalances and provide actionable recommendations for improvement.
• /modularity:design: Creates modular architectures from functional requirements, producing design documents, integration contracts, and test specifications while iterating until the design is clean.

Who it’s for

Software architects and developers who use Claude Code and want to ensure their systems remain modular and maintainable, especially when working with rapidly generated AI code.

Highlights

• Architectural focus: Focuses on high-level system design rather than just line-by-line code review.
• Balanced Coupling Model: Every recommendation is based on a concrete mathematical-like rule rather than intuition.
• Automated Design: Can generate full module design specs and integration contracts from functional requirements.
• Claude Code Integration: Operates directly as a plugin within the Claude Code environment.