code-health-audit

What problem does it solve?

The code-health-audit analyzes the entire repository to identify opportunities to improve code health — dead code, unused dependencies, modularisation opportunities, hardcoded patterns extractable to algorithms, and opportunities for algorithm and memory-layout optimisations, as well as complexity hotspots, inconsistent patterns, API surface bloat, configuration drift, documentation rot, and test-coverage gaps, highlighting active risks. It reads project context and writes diagnostic tests (unit, integration, benchmarks, equivalence checks) to resolve uncertainty before findings are issued, and produces categorised plan files — never editing production source code.

Core Features & Use Cases

• Repository-wide analysis identifying dead code, dependency hygiene, modularisation opportunities, pattern extraction, algorithm and memory-layout optimisation potential, and risk surface across the codebase.
• Reads the project context, conducts targeted research per substantive system, and writes diagnostic tests when such tests would resolve uncertainty before reporting findings.
• Produces fully justified, categorised plan files and includes a live Obligation Evidence Map; does not modify production sources.

Quick Start

Run the audit across the repository to generate a plan with findings and corresponding diagnostic tests.