show-me-your-work

Create a TSV file with columns ts, phase, decision, why, evidence, and result, then append one row per decision point using the log.sh helper script. Log forks, completed units with verification results, pivots, and blockers rather than every trivial action.

Use a single TSV file where each row records an ISO8601 timestamp, the work phase, a one-line decision, a plain-language reason, an evidence pointer like a commit SHA or file:line, and the outcome. Cells stay single-line and evidence is a pointer, never prose.

By default the log is a working artifact kept at decisions.tsv or under .audit/ and left out of git. Commit it only when the work is ambitious enough that a reviewer needs the trail to trust the result.

The log is audited against the session transcript to confirm every row maps to a real action and each evidence pointer resolves. A read-only subagent on a different model then reviews the trail and flags weak evidence, skipped verification, or risky choices.

Spreadsheet applications parse cells starting with those characters as formulas, so attacker-controlled text like PR titles could execute when a reviewer opens the file. The script prefixes such cells with a single quote to prevent formula injection.