khaneliman avatar

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-tools

Run it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.

Contents

Discovered from source

Skills 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.tsv or .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