Keep a Codebase Maintainable

A maintainability job is not a feature with extra polish. The deliverable is a smaller, truer tree: unused gone, twins collapsed, names honest, docs matching code, diff containing only the ask.

Mined from Cooper's OMP Hindsight bank (how he actually prompts coding agents). Source instances: references/instances.md (copy also at /var/lib/hermes/workspace/omp-maintainability-asks.md).

Core principle: Keep the requested scope. Follow codebase-design for shared readability rules and examples. Remove abstractions that only forward calls; retain ones that hide complexity, enforce invariants, or translate an external interface.

When to Use

Load this when the user (or the task) sounds like any of: