Repository navigation
Plan statuses are draft, approved, active, complete, abandoned; the gate, the guides and the template say so, with a state diagram #219
Description
Context
Ruled 2026-09-21. A plan's working statuses are five words: draft, approved, active,
complete, abandoned. chartered, introduced by #199 on 2026-09-10, was the agent's word, not
the owner's, and goes. in-progress says what active says and goes with it.
Today the vocabulary is written in four places and none of them says this:
| Where | Says today |
|---|---|
docs/guides/development-process.md line 225 |
draft, chartered, complete, abandoned |
docs/plans/TEMPLATE.md line 22 |
the same four |
docs/documentation-standards.md line 30 |
draft, in-progress, complete, abandoned |
.github/scripts/Test-Frontmatter.sh line 41 |
draft in-progress complete abandoned approved Approved active |
Found on #213's branch, where the gate rejected the process's own word. Resolved there by setting
the plan to approved.
Work
- The five words, in one place:
docs/plans/TEMPLATE.mdkeeps the list;development-process.md
anddocumentation-standards.mdsay what each means and point at the template;
Test-Frontmatter.shreads its working-status list from the template'sstatus:line, so the
four cannot drift again. development-process.md § Documents on every commitgains a mermaidstateDiagram-v2-- ruled
2026-09-21, "i want the diagram in our development process guidelines":
[*] --> draft·draft --> approved(review) ·approved --> active(work begins) ·
active --> complete(the last commit of the pull request) ·draft --> abandoned,
approved --> abandoned,active --> abandoned(dropped) ·complete --> [*],
abandoned --> [*].- The tracked plans carrying
charteredorin-progressare corrected to the state they are in. - A test in the gate's own terms: the five pass,
charteredandin-progressfail.
Plan and design documents
| Kind | Document |
|---|---|
| Plan | arrives with the branch |
| Design | development-process.md § Documents on every commit — where the diagram lands |
| Design | docs/plans/TEMPLATE.md — the one list |
| Design | #199 — where chartered came from |
Activity
David-Noble-at-work commentedon Sep 21, 2026
Third copy of the vocabulary, also stale: docs/documentation-standards.md line 30 lists the working-document statuses as draft, in-progress, complete, abandoned. #199 corrected development-process.md and TEMPLATE.md and missed this one and the gate. Four places define the same four words and two of them are wrong. Proposal for the fix: one source -- the gate reads its list from TEMPLATE.md's status line, documentation-standards.md points at the template rather than restating -- and a mermaid stateDiagram in development-process.md beside the sentence, so the transitions are drawn, not only described: draft --> chartered (review), chartered --> complete (last commit of the PR), chartered --> abandoned, draft --> abandoned.
doc(windows): the plan's status is one the gate accepts (#213)
[-]The frontmatter gate rejects 'chartered', the status the process ruled, and still accepts 'in-progress'[/-][+]Plan statuses are draft, approved, active, complete, abandoned; the gate, the guides and the template say so, with a state diagram[/+]feat(windows): Remove-BrokenLinks.ps1, the base's first common.Window…
doc(process): plan the status words and the process epic's features (#…
doc(process): five plan statuses with a state diagram; the process ep…
doc(process): five plan statuses with a state diagram; the process ep…