Complexity Audit

Identify concrete, fixable complexity issues in a codebase. Focus on changes that reduce the cost of reading, modifying, and debugging code -- not style preferences or nitpicks.

Workflow

1. Read project documentation (README, AGENTS.md, architecture docs) to understand intended patterns and conventions
2. Identify the largest and most-modified source files as starting points
3. Search for patterns in each category below, working outward from hot paths
4. Produce findings per the output format

Patterns

Abstraction

• Premature wrappers, base classes, or indirection layers serving only one caller
• Helper functions under ~5 lines used once -- inline when the logic reads clearly at the call site
• Import chains where duplicating a few lines would be simpler than the dependency
• "Utility" modules that are grab-bags of unrelated functions