A module-level README section: responsibility, when to use/not use, key

invariants, and a 10-line usage example; architecture note only where non-obvious. 4. Keep terminology consistent with the domain glossary; flag names that mislead.