show-me-your-work

Keep a single append-only TSV log with one row per decision, recording timestamp, phase, decision, rationale, evidence pointer, and result. Use the included log.sh helper to append well-formed rows, and audit the log against the run transcript before handing back.

TSV works well because GitHub renders it as a sortable table, spreadsheets open it directly, and terminal tools like column display it cleanly. Each row stays single-line with evidence as a pointer such as a commit SHA or file:line, never prose.

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

The log.sh script strips tabs, newlines, and carriage returns from every cell, then prefixes any cell starting with =, +, -, or @ with a single quote. This prevents attacker-controlled text like PR titles from executing as formulas when opened in a spreadsheet.

Self-review cannot provide fresh eyes on the work, so the skill spawns a subagent on a different model family to scan the trail and transcript. It flags weak evidence, skipped verification, and risky choices, and every reply ends with an Attention section listing the reviewer model and its flags.