- Keep
README.mdaligned with the implementation. When behavior, commands, validation gates, artifacts, hooks, CLI usage, tools, or workflow semantics change, update the README in the same change so it describes the current code rather than aspirational or stale behavior.