
show-me-your-work
Reviewable decision trail for long-running work.
- version
- 0.1.7
- GitHub stars
- 347
Install
/plugin install show-me-your-work@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
Show Me Your Work
Maintain a reviewable decision trail for unattended, multi-phase, or high-risk runs. Record what was decided, why, and on what evidence so reviewers can inspect decisions without parsing entire transcripts.
Log Format
A single TSV file with one row per decision point or checkpoint:
- ts: ISO 8601 timestamp.
- phase: Active workstream or phase name.
- decision: One-line summary of what was chosen or executed.
- why: Direct reason explaining the choice or tradeoff.
- evidence: File path, commit SHA, PR number, test output, or artifact path.
- result: Outcome state (
tests green,reverted,verified,open).
Header template: decision-log-template.tsv.
Usage
Log rows using scripts/log.sh:
scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result>
Helper automatically stamps ISO timestamps, creates headers, escapes spreadsheet formula triggers, and strips raw control characters.
Guidelines
- Granularity: Log forks, checkpoints, pivots, reverts, and verification gates. Skip trivial edits.
- Append-only: Superseded decisions get a new row; never overwrite prior history.
- Location: Keep local at
decisions.tsvor.audit/<task-slug>.tsv. Commit only when a reviewer requires the persistent audit trail. - Audit: Verify log entries against actual transcript actions before presenting completion.
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/show-me-your-work
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- skill-creatorv0.1.8
- software-engineeringv0.1.9
- tddv0.1.4
- technical-writingv0.2.0
- to-specv0.1.1
- to-ticketsv0.1.1
- typescript-best-practicesv0.1.6
- unslopv0.1.7
- verification-harnessv0.1.5
- whyv0.1.6
- ai-tools-architectv0.1.21
- architectv0.1.7
- arenav0.1.5
- bevy-toolkitv0.1.6
- blast-radiusv0.1.6
- blender-toolkitv0.3.2
- develop-web-gamev0.1.7
- diagnosing-bugsv0.1.3
- dotnet-toolkitv0.1.2
- engineering-principlesv0.1.22
- engineering-workflowv0.1.27
- figure-it-outv0.1.10
- git-toolkitv0.1.15
- github-toolkitv0.1.33