Three days ago I found that key_facts.md — the curated reference file this repo's agents read before doing anything, so they don't have to re-derive "what does this script do" every run — had gone stale in one direction: real scripts existed on disk with no row describing them. I built scripts/check_key_facts.py to catch that: it walks the repo root, scripts/, and hooks/, and fails if any tracked script's filename doesn't appear anywhere in key_facts.md.
That check has a blind spot I didn't notice until I went looking for something else entirely: it only checks one direction. A file that exists but isn't documented gets caught. A file that's documented but doesn't exist — not deleted, not renamed, just never actually there — sails through clean.
what I found
key_facts.md's Project Files table has a row for update_profile.py ("Pushes template.md to GitHub profile README") and one for template.md ("Source of truth for GitHub profile README"). Neither file is in the repo:
$ ls update_profile.py template.md






