# Dependency Graph Analysis

> ===DEPENDENCY_GRAPH_ANALYSIS===

- Skill: `elevanaltd-hestai-mcp/dependency-graph-analysis` (Agent Skill)
- Install (CLI): `npx skillmds@latest add elevanaltd-hestai-mcp/dependency-graph-analysis`
- Raw SKILL.md: https://api.skillmd.com/api/skills/elevanaltd-hestai-mcp/dependency-graph-analysis/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: elevanaltd (https://skillmd.com/u/elevanaltd-hestai-mcp)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/elevanaltd-hestai-mcp/dependency-graph-analysis

---

===DEPENDENCY_GRAPH_ANALYSIS===
META:
  TYPE::SKILL
  VERSION::"1.0.0"
  STATUS::ACTIVE
  PURPOSE::"Dependency chain analysis, cycle detection, and coupling metrics"

§1::CORE
AUTHORITY::BLOCKING[direct_cycles⊕package_cycles]⊕ADVISORY[transitive_cycles⊕coupling_metrics⊕dependency_direction]
SCOPE::dependency_mapping⊕cycle_detection⊕coupling_measurement⊕direction_enforcement
PRINCIPLE::"Depend toward stability — unstable modules must not be depended upon by stable ones"

§2::PROTOCOL
MAPPING_PROCEDURE::[
  1::identify_modules[packages⊕classes⊕services⊕files],
  2::trace_imports_and_references[static⊕dynamic⊕config],
  3::build_directed_graph[module→dependency],
  4::classify_direction[toward_stability⊕toward_instability]
]
CYCLE_DETECTION::[
  SIGNAL::module_A_imports_B_and_B_imports_A[direct_cycle],
  SIGNAL::transitive_cycle[A→B→C→A],
  SIGNAL::package_level_cycle[pkg_A⇌pkg_B],
  SEVERITY::[direct_cycle::BLOCKING,transitive_cycle::ADVISORY,package_cycle::BLOCKING]
]
COUPLING_METRICS::[
  AFFERENT::count_incoming_dependencies[who_depends_on_me],
  EFFERENT::count_outgoing_dependencies[who_do_I_depend_on],
  INSTABILITY::efferent_div_total[0_stable→1_unstable],
  FAN_OUT::efferent_gt_7→high_coupling_signal,
  FAN_IN::afferent_gt_10→core_module[protect_stability]
]
DIRECTION_ENFORCEMENT::[
  RULE::depend_toward_lower_instability[stable_abstractions],
  VIOLATION::stable_module_depending_on_unstable→refactor_with_interface,
  PATTERN::dependency_inversion[introduce_abstraction_at_boundary]
]

§3::GOVERNANCE
MUST_ALWAYS::[
  map_before_measuring,
  detect_cycles_before_coupling_analysis,
  cite_instability_scores_in_findings,
  recommend_direction_fixes_for_violations
]
MUST_NEVER::[
  skip_cycle_detection,
  measure_coupling_without_graph,
  ignore_transitive_dependencies,
  accept_package_level_cycles
]
ESCALATION::complexity_guard[when_cycles_detected⊕instability_violations_systemic]

§5::ANCHOR_KERNEL
TARGET::analyze_dependency_chains_and_enforce_direction
NEVER::[skip_cycle_detection,measure_without_graph,ignore_transitive_deps,accept_package_cycles]
MUST::[map_all_dependencies,detect_cycles,compute_coupling_metrics,enforce_depend_toward_stability]
GATE::"Are dependencies directed toward stability, and are there any cycles?"
===END===