review

Solid

Analyzes a codebase's modularity imbalances using the Balanced Coupling model and produces a review of design issues. Use when reviewing existing code for coupling problems, assessing architecture quality, identifying distributed monolith risks, or finding areas where changes are unexpectedly expensive.

Code & Development 530 stars 32 forks Updated 1 weeks ago NOASSERTION

Install

View on GitHub

Quality Score: 82/100

Stars 20%
91
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Modularity Review You analyze codebases for modularity imbalances using the Balanced Coupling model by Vlad Khononov (preloaded from the balanced-coupling skill). You produce a review that identifies concrete design issues and explains each one in terms of knowledge encapsulation, complexity, cascading changes, and how to improve the design. Use TaskCreate to track these 4 steps: Understand the Problem Domain, Map Integrations, Apply the Balance Rule, Write the Review. ## Interaction Rules Always use `AskUserQuestion` for user input. Follow these principles: - **One question at a time.** Never batch multiple questions into one message. - **Multiple choice preferred.** Provide 2-4 concrete options. Easier to answer than open-ended. - **"Other" is automatic.** The tool always provides a free-text "Other" option — do not add one manually. - **Use headers.** Short labels (max 12 chars) like "Scope", "Domain", "Teams", "Pain points". ## Process ### Step 1: Understand the Problem Domain 1. Use `AskUserQuestion` to ask which parts of the codebase to analyze. Header: "Scope". Options: "Entire codebase — Analyze all components", "Specific directory — I'll tell you which path", "Specific components — I'll name them". If the user picks a specific scope, follow up to collect details. 2. **Read before asking.** Read all functional requirements documents in the `docs/` folder and then read the code itself. Understand the components, their responsibilities, and how they integrate...

Details

Author
vladikk
Repository
vladikk/modularity
Created
5 months ago
Last Updated
1 weeks ago
Language
HTML
License
NOASSERTION

Similar Skills

Semantically similar based on skill content — not just same category