loom-doc-hygienelisted

# doc-hygiene Rules to apply on **every** documentation edit. Docs are a living source of truth, not an append-only log. A reader should be able to trust that what a doc says now is what is true now. ## Rules 1. **No contradictions.** A document must not assert two things that cannot both be true. Before adding a statement, scan the surrounding doc for anything it conflicts with and reconcile them in the same edit. 2. **Rewrite in place — never append "UPDATE:" notes.** When information becomes outdated, debunked, or false, **edit the original sentence/section to be correct**. Do not leave the stale text and bolt on "UPDATE:", "EDIT:", "Note (2026):", "~~struck-through~~ now actually…", or a trailing correction. Replace the wrong content with the right content as if it had always been right. (Git history preserves what changed — the doc itself should read clean.) 3. **Tidy loose ends.** Resolve dangling references, half-finished sentences, TODOs that are now done, and links to things that moved or were deleted. If a section is now empty or redundant, remove it. 4. **Keep docs bounded.** Don't let a doc grow without limit. Prefer revising existing sections to adding new ones. Consolidate duplicated explanations into one canonical place and link to it. Length should track the size of the subject, not the number of times it was touched. 5. **Shallow, stable structure for a notes collection.** In a multi-note vault/docs tree, keep a **one-level** folder taxonomy — don't pi