elixir-cyclic-deps

What problem does it solve?

Detects and helps remove compile-time cyclic dependencies in Elixir projects that cause mix xref failures and broken builds, focusing on minimal code changes to restore a clean compile graph.

Core Features & Use Cases

• Accurate cycle detection using mix xref with both compile-connected and compile labels to find modules involved in cycles.
• Minimal-change remediation strategies such as extracting helper modules, moving code, inverting dependencies, or splitting modules to break cycles with low churn.
• Verification workflow that re-runs xref checks, compiles with warnings-as-errors, and runs tests or lint tasks to ensure the fix is safe for CI and local development.

Quick Start

Use the elixir-cyclic-deps skill to run mix xref cycle checks, propose a minimal code change to break any compile-time cycles, and verify the project compiles and tests pass.