The rest of a post-it
A post-it used to be a name and a prompt — enough to start a Claude Code session, not enough to remember why. The backlog adds what the work is about, and a check against it.
An epic is a reason with several stories under it. A story is one post-it, the thing you
work on. A task is a story cut out of another one. Each gets a key, K150: one number for
your whole account, the same in every repository and on every machine, never reused.
Why decisions, and why a counter-check
You explain a piece of work for half an hour, the model says it understood, and then it builds something that quietly contradicts the one thing you settled at minute twenty. You notice three days later, and by then you cannot prove you said it.
So the discussion happens in rounds of four questions at most, each saying where it is —
Round 3 of about 8 — and each written to k0 before the next is asked. What comes out is a row of
decisions, D1, D2, one sentence each, about behaviour rather than code. A decision is never
rewritten: a new one supersedes it and both stay. Stories inherit their epic's, shown as K7·D3.
When the work is done, /k0-verify takes the decisions one at a time and records a verdict for
each — kept, violated or not applicable — with the evidence. A run that skips one is refused, and a
story with a broken decision cannot be marked Done until the work is put right or the decision is
superseded.
How to use it
- Say yes when the installer offers to copy the commands into
~/.claude/skills/. - Press
+on a repository: Story for something you already know you want, Epic for something big, which opens a terminal running/k0-epic. - Press the one button on the note — Discuss, Plan or Work. A terminal opens with the command already in it.
- When it is built,
/k0-verify, then Done on the note — or/k0-donefrom the session.
| Command | What it does |
|---|---|
/k0-story | one story, straight onto the board |
/k0-epic | rounds, decisions, then stories you approve |
/k0-discuss | the same rounds on a story that exists |
/k0-plan | plan mode, with the decisions as constraints |
/k0-work | the work, in a worktree of its own |
/k0-verify | the counter-check |
/k0-done | closes the story once the session has finished |
/k0-next | what to pick up now, and why |
Closing it from the session
Done on the note shuts the terminal at once. Asked from inside that terminal — /k0-done, or a
line at the end of a skill of your own, such as a commit-and-push that should also close the story
— k0 does not cut the session off mid-answer: the note says closes when finished, and the story
goes to Done, window and all, the moment the session has finished. /k0-done runs the
counter-check first if the story never had one. A broken decision still stops it, and the story
comes back to you in Review with the reason in its Log. k0-board done does the same from a
terminal.
Small print
Each repository with a backlog grows a .k0/ folder, one Markdown file per epic and story. Commit
it: it is how a board is rebuilt, keys and all, on a machine that has never seen it.
"backlog": false in ~/.k0/config.json switches the feature off.