← ClaudeAtlas

roadkeeplisted

Call the roadkeep CLI instead of editing a project's governed ROADMAP.md, CHANGELOG.md, IMPROVEMENTS.md, DECISIONS.md or STRATEGY.md. Use when adding, shipping, retiring or recording a task, changing a marker, writing a rationale section or a decision record, picking what to work on next, or reading a backlog, ledger or dependency graph — and whenever an edit to one of those files was denied or `roadkeep lint` reported a violation. Trigger words: roadmap, backlog, changelog, decision, ADR, task line, block, ship, retire, next task, roadkeep.
alegauss/roadkeep · ★ 1 · Data & Documents · score 74
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