Skip to content

Statuses ​

StatusMeaning
draftBeing designed; open questions remain.
designedDesign complete — ready to implement once its dependencies are done.
in-progressBeing built.
deferredParked: not abandoned, not being worked on. Never ready.
doneBuilt, merged, and the docs describe it.
abandonedWon't be done.
supersededReplaced by another initiative (superseded_by).

Ready isn't stored: an initiative is ready when it is designed and every initiative linked under its ## Dependencies is done.

Other words that work ​

You writeMeans
proposed, proposal, exploratory, unresolved, idea, design, designing, in-designdraft
ready, design complete, design settleddesigned
in-review, wipin-progress
parked, on-hold, backlog, futuredeferred
complete, completed, implementeddone
cancelled, canceled, rejected, dropped, won't do (wont-do), wontfixabandoned
replacedsuperseded

The word you wrote is kept for display — draft (Proposed) — and behaviour follows the core status. Map anything else per collection:

yaml
statuses:
  spiked: designed
  archive: done

Why work stopped ​

Abandoned, superseded and deferred initiatives say so at the top, in a callout under their title that Brindley keeps in step and removes when the work is reopened:

markdown
> [!WARNING]
> **Abandoned** (2026-10-07): Mermaid can't draw a word cloud.

Give the reason with set_status's reason — required to abandon, optional to supersede (the callout links the replacement) or defer. It is also kept as status_note and shown in the README's Closed list. Put the fuller story in outcome, which becomes an ## Outcome section.

Status folders ​

In an existing layout, a file without a status takes it from the sub-folder it's in: completed/ → done, deferred/ → deferred, superseded/ → superseded, plus any word mapped above. Front-matter always wins. Brindley moves files between folders only for a collection that opts in with folders: (see Front-matter).

MIT licensed · Named after James Brindley, engineer of the Bridgewater Canal