Code and everything surrounding it — commits, PRs, comments — should be treated as communication to future readers, not just instructions for machines. A pull request is best structured like a book: each commit is a chapter, ordered to tell a coherent story. Commit messages should be self-contained and verb-first, explaining why changes exist rather than just what they do. This discipline becomes even more critical with AI-generated code, where atomic commits make the agent's reasoning auditable and gaps in logic visible before they reach production.
Table of contents
A PR is a storyThe reader on the other sideAI-generated code makes this more important, not lessStructure is part of the message447 Impressions