Show me your work

Keep one canonical log.

The format

A single TSV file, one row per decision. Cells stay single-line. Evidence is a pointer, not prose. The header row is:

ts	phase	decision	why	evidence	result

• ts. ISO8601 timestamp.
• phase. The phase or workstream.
• decision. What was chosen or done, one line.
• why. The reason in plain words. If a principle drove it, say it plainly, not as a jargon tag.
• evidence. A link or path that proves it: commit SHA, PR number, file:line, or an artifact or screenshot path. Never a paragraph.
• result. The outcome or predicate state: tests green, reverted, INCONCLUSIVE, open.