Add a structural check over HQ's own records

novox/hq

Nothing in this repository was verified by anything but reading, which is how
a superseded decision stayed live in the constitution and in the to-be README
at the same time. Both were found by a person looking, and nothing stopped a
third.

Five checks: links resolve; `decisions:`/`extends:` name records that exist and
are accepted; a governing document citing a superseded record must name its
replacement in the same paragraph; supersession is symmetric; filename number
matches heading number.

Each was made to fail before it was made to pass. The live-citation check was
verified against a reconstruction of the actual incident -- the to-be README
citing ADR 0017 as live guidance -- and reports it with file and line.

It found one thing nobody had noticed: ADR 0018 never declared that it
superseded 0011, though 0011 has named 0018 as its superseder since August.
Fixed.

Deliberately not checked, and said so in the README: 02-DECISIONS and
01-RESEARCH may cite superseded records freely, because a decision record
discusses history and research records what was observed. 00-as-is may rest on
one, per 0056. Flagging those would put noise on correct documents, and a check
that cries wolf gets suppressed -- which costs more than not having it.

Two bugs found by running it: the frontmatter reader iterated an inline list as
characters, and the as-is exemption was missing entirely.

This commit is contained in:

jschoubben

2026-08-27 20:18:35 +02:00

parent e1f4c7d9e0

commit 03874f3fe2

3 changed files with 321 additions and 0 deletions

									
										02-DECISIONS/0018-the-mesh-creates-no-symlinks.md
									
		+1
		
												View File
												
				@@ -3,6 +3,7 @@ status: accepted

				date: 2026-08-23

				deciders: jochen

				reconstructed: false

				supersedes: 0011-the-installer-owns-linking.md

				extends: 0011-the-installer-owns-linking.md

				---