gpu-cli Decision Trail
Keep one reviewable, append-only decision trail for a branch worked by people
and agents. The trail records what was decided, why, perceived confidence,
evidence, and outcome. It uses bd when available and falls back to TSV.
Use one command namespace:
/decision-trail <command> [arguments]
| Command | Use for | Read |
|---|---|---|
| `toggle [on | off] [branch]` | Start or stop tracking for a branch |
| `track " because " [--confidence high | medium | low]` |
show [branch] [--pr] |
Render, validate, and optionally publish a trail to its PR | references/show.md |
Route the first argument to its reference. With no argument, show this command table and ask which operation is wanted. Treat an unrecognized argument as a request to show the current branch's trail.
Shared runtime
All helpers live in .agents/skills/decision-trail/. Read
references/config-schema.md only when changing
tracking configuration, and references/row-format.md
only when changing row semantics. Run the relevant helper rather than manually
editing .decision-trail/ state.
toggle on materializes a committed .decision-trail/ runtime and configures
Git's relative core.hooksPath. Tell the user to commit .decision-trail/
after enabling it.
The optional Claude Code Stop hook enriches meaningful commit stubs; the Git
post-commit hook captures the stubs regardless.
Validation
Run bash tests/selftest.sh after changing the bundled runtime.