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, design-pending, spec, drain-exempt, roadmap) 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

Vendor the queue-kit/ directory into your repo, register its gates in gates.list, and keep your queue in the tracked file the kit points at.

Quick start

bash gate-sdk/bin/run-gates.sh --emit queue-index    # list selectable work
bash gate-sdk/bin/run-gate-tests.sh 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.