Skill: aposd-improving-code-clarity

STOP - The Obviousness Rule

If a code reviewer says your code is not obvious, it is not obvious—regardless of how clear it seems to you. "Obvious" exists in the reader's mind, not the writer's.

For new code: Write comments BEFORE implementation. Comment difficulty signals design problems—fix the design, not the comment.

What Counts as "New Code"

Comments-first applies to ALL of these: