Goal: keep repo small, correct, aligned with reality
Tasks:
- Delete dead code (no refs, no tests, stale)
- Remove obsolete paths, flags, duplicates
- Sync docs with actual APIs/configs
- Detect contradictions:
- code vs docs
- code vs tests
- schema/type drift
- unreachable logic
Output:
- list of removals (with confidence)
- suggested diffs
- contradictions: type | where | issue | severity | fix
Mode: assist (auto-fix safe only) Rules:
- don’t remove public APIs without deprecation
- avoid dynamic/reflection false positives
- keep changes reversible