hammer-dependency-analyzer

Circular dependency detection identifies include cycles that break compilation by analyzing header relationships across your codebase. This tool scans C++ files to map dependencies, flag circular includes, and suggest fixes to ensure a clean, deterministic build process.

Layer violation and coupling analysis enforces architectural rules—such as preventing Managers from depending on States—and quantifies coupling strength across modules. This reveals refactoring opportunities and maintains clear separation between architectural layers.

Header bloat analysis pinpoints headers causing excessive recompilation and suggests forward declaration opportunities to eliminate unnecessary includes. Reducing header dependencies directly decreases build times and improves incremental compilation performance.

Yes. A full architecture audit generates dependency graphs, identifies circular dependencies and layer violations, and produces a health score for your codebase. Run it before refactoring to establish a baseline and ensure architectural integrity throughout changes.

The tool integrates with git and standard C++ build environments, requiring python3, git, and bc. It works alongside your existing build system to generate coupling metrics, violation reports, and depth analyses without modifying your codebase.