README.md says twenty scripts and the directory holds twenty-three #13

New Issue

Closed

opened 2026-08-17 23:25:34 -05:00 by null · 0 comments

null commented

2026-08-17 23:25:34 -05:00

Owner

README.md opens with "twenty scripts that enforce both". docs/architecture/scripts/ holds 23 since Batch 01 added restore-check.sh, controls.sh and preflight.sh.

This is the same drift already fixed once in this batch: scaffold.sh's header said "thirteen documents" and was three behind. A count in prose beside a list in code is wrong the moment the list grows, and nothing checks it — doc-claims.sh verifies that named paths exist, not that stated numbers are true.

Fix it the way scaffold.sh was fixed: stop carrying a number rather than carrying a fresh one that will be stale again after the next script.

While in there, the day-one table in the same file lists the scripts worth knowing about on the first day and predates all three of the new ones. restore-check.sh in particular belongs beside backup.sh, which currently sends the reader to a script whose own header says it is only half the job.

Verify: README.md states no count of scripts that a directory listing could contradict, and its day-one table names restore-check.sh beside backup.sh.

`README.md` opens with "twenty scripts that enforce both". `docs/architecture/scripts/` holds 23 since Batch 01 added `restore-check.sh`, `controls.sh` and `preflight.sh`. This is the same drift already fixed once in this batch: `scaffold.sh`'s header said "thirteen documents" and was three behind. A count in prose beside a list in code is wrong the moment the list grows, and nothing checks it — `doc-claims.sh` verifies that named paths exist, not that stated numbers are true. Fix it the way scaffold.sh was fixed: stop carrying a number rather than carrying a fresh one that will be stale again after the next script. While in there, the day-one table in the same file lists the scripts worth knowing about on the first day and predates all three of the new ones. `restore-check.sh` in particular belongs beside `backup.sh`, which currently sends the reader to a script whose own header says it is only half the job. Verify: README.md states no count of scripts that a directory listing could contradict, and its day-one table names restore-check.sh beside backup.sh.