Complexity Mitigator

Intent

Reduce incidental complexity (understanding cost) while preserving essential domain meaning.

Core Mindset

• Keep essential complexity; vaporize the incidental.
• There is no silver bullet refactor; identify the dominant source of understanding cost before prescribing moves.
• Optimize for reader comprehension first, then for extraction.
• Minimal incision, maximal precision: change only what reduces cognitive load.
• Prefer boring, local clarity over cleverness.
• Sometimes the smallest viable cut is not a refactor. It may be:
  • a learning artifact that clarifies behavior, or
  • deletion/delegation to an existing facility.
• Grow changes in safe cuts; do not prescribe a grand rewrite.
• Recommend one preferred default unless tradeoffs are genuinely close.
• Reduce "understanding cost": fewer branches to hold in mind, fewer places to jump, fewer states to simulate.