Show me your work

Maintain one append-only TSV decision log. Record decisions and checkpoints, not every command.

Start the trail

Copy references/decision-log-template.tsv to .audit/<task-slug>.tsv in the active work directory. Keep it uncommitted unless the trail is part of the review contract.

Columns:

• ts: UTC timestamp.
• phase: phase or workstream.
• decision: the concrete choice or action.
• why: the reason in plain language.
• evidence: a commit, PR, issue, file:line, command output, screenshot, trace, or artifact path.
• result: observable state such as tests green, reverted, UNPROVEN, or open.

Use scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result> so cells stay single-line and spreadsheet-safe.