work-ledger
Work ledger
The ledger is the single source of truth for a work item between sessions: its outcome, decisions, authority, live state, evidence, open questions, and next action. A session's transcript is scratch; the ledger is what the next session inherits. Items live in ~/dev/ledger/items/<primary-key>.md, shaped like ~/dev/ledger/_template.md.
1. Find the item
The work-ledger plugin attaches matching items to prompts that mention one of their keys. Otherwise search: rg -il '<key>' ~/dev/ledger/items.
Create an item from _template.md when the work is PR-bound, an incident, or likely to outlive this session, and none exists. List every identifier that should find it in keys. One-session questions need no item.
Done when you are holding the item, or have decided the task needs none.
2. Reconcile before acting
Treat the item's Decisions and Authority as accepted context: they are what Khoa already settled, with sources. Treat State as a dated claim. Before acting on it, re-check each fact you depend on against live sources (git fetch and git log, gh pr view, the deployed ref) and correct State in the file.
Done when every State fact your next step depends on is confirmed or corrected, with a new Checked time.