Minimize Reader Load
Trigger
When code requires too many hops, wrappers, hidden states, or mental joins.
Rule
Reduce indirection, mutable scope, and one-caller abstractions until the causal path is easy to hold in one mind.
Application
- Name the concrete decision this principle changes.
- Apply the rule to that decision, not as a decorative citation.
- Prefer evidence from the current repository/runtime over generic preference.
- If the principle conflicts with an explicit user constraint, keep the constraint and state the tradeoff.