Core readability rules
- Reduce the layers a reader must trace.
- Prefer direct flow over indirection.
- Avoid unnecessary wrappers, abstractions, and pass-through helpers.
- Inline logic when the abstraction does not remove real complexity.
- A reader should not need to jump across many files or functions to understand the main path.
- Reduce the state a reader must hold in their head.
- Keep functions small and locally understandable.