auditlisted

# Auditing the registers **Check, do not reassure.** The result of an audit is a list of findings, or the sentence "I checked N things and found nothing" — never "everything looks fine". ## 1. Structural conformance — run the checker, do not rewrite it ``` python3 ${CLAUDE_PLUGIN_ROOT}/scripts/conform.py docs/architecture ``` It checks the artefacts, the sections of every decision record, agreement between the index and the directory, the numbering and shape of open questions, and the phase register. It detects the Polish and English variants from `README.md`. Exit code 1 on any problem, so it works as a CI gate. **Before trusting it**, run the proof that it can fail: ``` bash ${CLAUDE_PLUGIN_ROOT}/scripts/selftest.sh ``` Fifteen cases across both languages: each defect the checker claims to find is introduced into a copy of a known-good set and must be caught. ### Why the checker looks the way it does Four successive versions of this check produced false results, each for a different reason: | defect | effect | |---|---| | a pattern matching only the plural form of a word | missed the singular; reported six sections absent that were all present | | a keyword list for "rejected alternatives" | missed a rejection phrased as "we do not create X, because…" | | a regular expression the tool refused to compile | the error went to stderr, the script printed "clean" | | a loop over an unquoted variable in a shell that does not word-split | one iteration instead of eleven,