trail-record
Record
Git records what changed. This records why, whose decision it was, and what was rejected — the part that decides whether the next person can safely touch the code.
The thing that is actually lost. A diff is recoverable forever. The conversation that
produced it is gone when the session ends: what the operator asked for, what the agent
proposed, where the operator said "no, not like that", and what the agent did instead.
Six months later git blame names a commit. It cannot say that the obvious approach was
tried and rejected for a reason that still holds.
Language
Write the record in the language the work was conducted in. If the operator spoke Russian, the record is Russian — it is read by the same people who did the work.
Quote the operator verbatim, in their own words, never translated and never paraphrased. A paraphrase has already decided what they meant, and the whole value of the correction sections is that they preserve what was actually said.