show-me-your-work

SKILL.md

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.

Copy references/decision-log-template.tsv (the header row) to start a clean log. Columns:

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, trace, or screenshot path. Never a paragraph.

result. The outcome or predicate state: tests green, reverted, pixel-diff 0, INCONCLUSIVE, open.

An example, plain-spoken so a reviewer reads it at a glance.