roadkeeplisted
Install: claude install-skill alegauss/roadkeep
# roadkeep — call the command, never type the format
The line format is a schema at the point of insertion, not a convention to remember. Every
field is validated before a sentence exists, so a refusal costs a retry and never a
deletion. Read `roadkeep.toml` for this project's prefix, id shape, paths, markers and
limits (L6); nothing below hardcodes them. `roadkeep` is the installed entry point —
`python -m roadkeep.cli` when it is not on PATH.
## The loop, in four calls
**`brief`** picks the next line and briefs it in one read — the tier it chose by, the deps,
the design section, what shipping it unblocks and the non-goals that bind it — so a session
starts with a call and not a file read. **`add`** files a new task. **`ship <id> --why
"<what now works>"`** closes one across three files in a single transaction, or none of
them. **`lint`** is the gate that says whether any of it landed, and it exits non-zero,
which is the whole difference between a gate and advice.
`<verb> --help` has the flags, and every field a schema can derive — the id, the `→ §<id>`
pointer, the status default, every dep annotation — is **derived and never typed**. Where
two workers share a checkout, reach for `brief --claim`: it answers and takes the line in
one transaction, so the next caller is sent elsewhere. Over the tool surface that is its
own tool, named `claim`.
## The reads, which are the half that goes unfound
None of these writes anything, so asking is free — and each is a turn you do n