queue-kit

A git-native, agent-readable task tracker. The queue is a single Markdown file under version control, not an external service — so an agent session reads its work and its history from the same tree it commits to, with no credential and no network round-trip.

queue-kit formalizes that file: one slug namespace, a small tag algebra (blocked-by, spec, drain-exempt, roadmap, observed-by, cost, surface, cap-credit, recurrence, roadmap-summary, not-icebox-eligible) that encodes preconditions an agent can resolve mechanically, an index tool, a roadmap projector that renders the curated entries as a generated public page, and gates that hold the grammar a session selects work by.

Install

The steps are the kit README’s Install section. checkwright init does them for you — see the install page.

Quick start

Run these arms as the kit README spells them, PowerShell included; queue-index lists the selectable work:

gates="${GATE_SDK_NATIVE_BIN:-./scripts/checkwright-gates}"
"$gates" --emit queue-index \
  && "$gates" --run-gate-tests queue-kit/gate-tests queue-kit/checks

Contracts

The queue format and the tag algebra are defined in the kit’s SPEC.md; its README.md lists the mechanism. Back to the kit map.