Skip to content

The project record

Most projects keep their engineering record private and publish a polished subset. This one publishes both, and the reason is in the backlog's own header: it is written against what is actually in the repo, not against what was planned.

These documents are in the repository rather than on this site, because they are written for somebody about to change the code and they change with it.

DocumentWhat it is
BacklogEverything known to be broken, half-built, or lying. Numbered, evidenced, sized.
RoadmapWhat each milestone shipped, and what it deliberately did not.
HistoryWhy the code is shaped the way it is. Several entries record a hypothesis that turned out to be wrong.
VerificationThe hand-run acceptance checklist, per release.
DesignThe design language, and what a contributor reads before touching CSS.
ChangelogWhat shipped, per release, for somebody upgrading.

Why the backlog is public

An agent that can delete pods asks for a particular kind of trust. The most useful thing this project can offer in exchange is a complete, specific list of the ways it is currently wrong — including the ones that block sentences it would like to put on its own landing page.

Two entries have carried a Blocks: field pointing at exactly that: one blocked claiming an action rate, and one blocks claiming the agent resolves incidents. The first was resolved by finding the entry itself was wrong. The second is still open.

The distinction between history and changelog

They are different documents on purpose. A changelog says what shipped, per release, for someone upgrading. The history says why the code is shaped the way it is, for someone about to change it — and it keeps the entries where the hypothesis was wrong, because those are the expensive ones to re-learn.

Contributing

CONTRIBUTING.md in the repository has the short version. The one rule worth stating here: config needs a reader in src/ in the same commit. An option nothing reads is config that behaves like a comment, and the backlog has a whole section named after that failure.

AGPL-3.0-only · Source