Simplify

Simplification means fewer moving parts, clearer names, smaller surfaces, and less surprise. Do not flatten useful domain detail just to make something shorter.

Workflow

1. Find the real source of complexity: branching, state, naming, dependency direction, data shape, side effects, or wording.
2. Preserve public behavior unless the user explicitly wants a behavior change.
3. Prefer local improvements before broad rewrites.
4. Remove abstractions that are used once or hide simple logic.
5. Keep abstractions that encode a real invariant or prevent repeated mistakes.
6. Validate with existing tests or the smallest relevant check.

Code heuristics