mcpField
S
show-me-your-work

show-me-your-work

github.com/yeachan-heoOther40.7k8 installsUpdated today
Repository

About show-me-your-work

show-me-your-work is a skill for keeping an auditable decision trail during long-running or delegated work. It appends each non-obvious decision, alternatives, and supporting evidence to a task-specific TSV file in OMC state.

Key features

  1. 01Logs decisions as they occur
  2. 02Records alternatives and evidence
  3. 03Appends to task-specific TSV files
  4. 04Handles concurrent shared-state writes
  5. 05Summarizes the trail in the final reply

Use cases

  1. 01Auditing long autonomous runs
  2. 02Tracking work while a user is away
  3. 03Creating a post-mortem trail for multi-day work

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/yeachan-heo/oh-my-claudecode --skill show-me-your-work

After installing, type/show-me-your-workin Claude Code to confirm it loaded.

Details

From the project README

Show Me Your Work

For work a human will audit after the fact, the reply is not the record — the trail is. One row per non-obvious decision, written as it is made.

When to use

  • long, autonomous, or multi-phase work ("run until done", overnight runs)
  • any task the user steps away from and will trust on return
  • multi-day programs where the trail is the post-mortem

The trail

Append to state/decision-trail-{task-slug}.tsv under OMC's state root (create with a header row on first write; one file per task slug when sessions share a checkout). The task slug is lowercase kebab-case and is part of the canonical path. Resolve the state root the way OMC's own scripts do — the checkout's .omc/ by default; when OMC_STATE_DIR is set or a parent .omc-workspace redirects state, the root moves with it, so sibling sessions on the shared root see the same trail. Sibling sessions sharing that root also share the file: hold a lock around the header-exists check and each append — the same file-lock the verification-ledger writer uses (withFileLock on a <trail>.lock sidecar) — or concurrent first writes duplicate the header and racing appends lose rows:

ts <TAB> task <TAB> decision <TAB> rejected <TAB> evidence
  • decision: what you chose, one sentence.
  • rejected: the real alternatives you weighed and the one-line reason each lost. "None considered" is a valid, damning entry.
  • evidence: the command, output, or citation that decided it.

Cell guard: a cell starting with =, +, -, or @ is prefixed with ' so spreadsheet readers cannot parse it as a formula; tabs and newlines inside a cell become spaces. Append only — the trail is never rewritten.

Rules

  • Log at decision time, not at recap time; a trail reconstructed at the end is fiction with a timestamp.
  • Routine mechanical steps are not decisions; judgment calls, scope changes, and risk acceptances are.
  • The final reply summarizes the trail and links it; the trail itself stays the auditable artifact. It is local runtime state under OMC's state root — by repository policy it is not committed; when stakes need an immutable record, quote the decisive rows into the PR description or the linked issue instead of force-adding runtime state.

Comments

Markdown supported