Project-Template/docs/history/BATCH_LEDGER.md

1.8 KiB

Batch ledger —

Status: Archived
Owner: <who maintains this>
Last reviewed: <YYYY-MM-DD>
Governs: what the batches were, before the tracker held them
Review trigger: Nothing. Superseded by the tracker; kept for the record.

Why this file is archived rather than deleted

Planning used to live in markdown as a numbered batch list. It now lives in the tracker: milestones are batches, issues are deliverables, and severity is P0 / P1 / P2 / release-blocker.

This file is what that list was. It is kept because the reasoning in it is still worth reading, and deleted files are not readable.

It must not be updated. A batch list beside the tracker is a second answer to "what is open", and two records of the same thing will disagree without saying which is right. That is precisely why the work moved. If you are tempted to add a batch here, add a milestone instead.

Its Status: Archived is therefore not a nicety — it is the machine-readable form of "do not treat this as current".

"Ledger: missing" on the project screen is the correct answer

The Command Center's docs report still looks for a batch ledger — at docs/planning/FUTURE.md, named here without backticks deliberately, because doc-claims.sh treats a backticked path as a claim that the file exists and this one must not — and reports it as missing for every repository that has moved planning into the tracker. That is the expected state and not a gap to close: the report's own contract is that a tracker-first project shows a missing ledger and no batch percentages.

Creating that file to turn the line green would rebuild, in a new name, the exact second record this one was archived for.

The batches, as they stood

Batch What it covered Outcome
<> <> <>