G-14Repo Conventions as Context

A checked-in instructions file that loads every session — how a codebase tells an agent its rules.

Key insight

Put in it what is expensive to discover and cheap to state: the build command, the generated directory, the pattern that looks fine and breaks production. Because it is in the tree, it changes through review, like the code it describes.

Failure mode

Restating what the code already says. Those lines go stale on the first refactor and then actively mislead every session, which is worse than never having written them.

G-14Repo Conventions as Context

Elsewhere in the atlas