elixir-cyclic-dependencies

Use mix xref graph to detect cyclic dependencies in an Elixir project by mapping compile-connected and compile-time cycles. This Skill executes those commands to establish a baseline and plan minimal refactoring changes to break the loops.

Fix mix xref cycle failures with minimal code changes by extracting helper modules, moving code, inverting dependencies, or splitting modules. This Skill recommends the least invasive refactoring strategy to break compile-time dependency cycles.

You need Elixir 1.19 or higher to run mix xref for accurate dependency cycle detection. This Skill validates your Elixir version before executing the cycle analysis workflow to ensure precise compile-connected graph results.

Check for compile-time dependency cycles when you explicitly need to resolve xref cycle failures or verify codebase health. This Skill runs a cyclecheck task after refactoring to validate that cycles are cleared and the Elixir code compiles successfully.

Compile-connected cycles persist after refactoring when structural dependencies remain unbroken between modules. This Skill analyzes compile and compile-connected graphs using mix xref to identify remaining loops and plan further minimal changes like inverting dependencies.