coupling-analysis

Analyze code module coupling using strength, distance, and volatility metrics.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/luizgmassa/Useful-Agent-Skills --skill coupling-analysis-luizgmassa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coupling-analysis
Source: https://github.com/luizgmassa/Useful-Agent-Skills/tree/main/skills/coupling-analysis
Command: npx skills add https://github.com/luizgmassa/Useful-Agent-Skills --skill coupling-analysis-luizgmassa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you determine whether modules are too tightly connected, why change ripples across the system, and what to decouple to reduce architectural risk.

Core Features & Use Cases

  • Three-dimensional coupling model: evaluates strength, distance, and volatility to quantify maintainability pressure.
  • Dependency graph interpretation: maps module relationships and explains coupling direction and knowledge flow.
  • Actionable architecture reporting: produces prioritized issues and recommendations for extraction, merging, or contract hardening.

Quick Start

Ask for a coupling report by saying: "Analyze coupling between my modules in this codebase and tell me which dependencies are most likely causing change cascades."

Frequently Asked Questions about coupling-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze module coupling to identify what is causing change cascades in my codebase?

To analyze module coupling, you must build a dependency graph and evaluate relationships using strength, distance, and volatility. This process identifies tightly connected modules and produces a prioritized report recommending what to extract or merge to reduce architectural risk.

What is the three-dimensional coupling model for evaluating architectural health?

The three-dimensional coupling model evaluates architectural health by measuring strength, distance, and volatility between modules. This framework quantifies maintainability pressure and helps determine whether modules are too tightly connected or why change ripples across the system.

How do I assess dependency volatility when checking integration quality?

You assess dependency volatility by analyzing subdomain types and git or code signals. Evaluating volatility alongside strength and distance helps determine integration quality and identifies which dependencies are most likely causing change cascades across your modules.

Can I evaluate coupling distance using shared encapsulation hierarchy and organizational factors?

Yes, you can estimate coupling distance by analyzing the shared encapsulation hierarchy and organizational factors. Combining distance with strength and volatility measurements provides a balance-score based report that highlights prioritized architectural issues for contract hardening.

When should I decide to extract or merge modules during software refactoring?

You should decide to extract or merge modules during software refactoring after generating a balance-score based report. This report prioritizes architectural findings by evaluating coupling strength, distance, and volatility, guiding you on what to decouple to reduce maintainability pressure.

What is the best way to map dependency direction and knowledge flow for a module inventory?

The best way to map dependency direction and knowledge flow is to build a comprehensive module inventory and construct a dependency graph. Interpreting this graph reveals coupling direction and explains how knowledge flows between modules to pinpoint architectural risks.