---
description: When changing implementation, update relevant docs
alwaysApply: true
---

# Documentation update discipline

- When you make an **implementation change** (Python/SQL/frontend), you must also update the **relevant documentation**
  in `docs/` (and/or `CLAUDE.md` if it’s normative guidance) in the same change set.
- The docs update must cover:
  - what behavior changed (externally visible / operational impact),
  - where it is implemented (file/function names),
  - how to verify it (DB table/view, API endpoint, or operational check).

If there is no existing relevant document, add a short section to the closest module doc under `docs/04-modules/`.
