Show me your work

Keep one append-only decision log for work the user will review later.

Start the trail

For a new log, copy references/decision-log-template.tsv to decisions.tsv in the work directory. Reuse an existing log without overwriting it. When several runs overlap, use .audit/<task-slug>.tsv. Keep the file local unless the user explicitly asks to place it elsewhere.

The columns are:

• ts: ISO 8601 timestamp.
• phase: phase or workstream.
• decision: one concrete choice or checkpoint.
• why: the reason in plain words.
• evidence: a resolvable path, command output, test result, trace, or screenshot. Use a pointer, not a paragraph.
• result: the observed state, such as tests pass, reverted, INCONCLUSIVE, or open.

Use scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result> to append a row. The helper writes the header, removes tabs and newlines from cells, and protects spreadsheet readers from formula execution.