A WAD stays current

The document is maintained continuously — drift between WAD and reality is the failure mode the format exists to prevent.

A WAD written once and abandoned is worse than no WAD — it answers questions wrongly with confidence. The format fights drift three ways: extractors re-derive machine-readable facts from the live system on every run; wcl diff against the last reviewed revision makes any drift visible as a change list; and decisions are captured as adr blocks at the moment they're made, not reconstructed later.

The habits: after a meaningful change lands, re-run the extractors, update the hand-authored blocks the change invalidates, and record new decisions. Periodically, have an LLM read the git commit history since the last sweep and flag what the WAD hasn't caught up with — commits are the change log the document must answer to. The keep-current process turns all of this into a runbook.