diff --git a/CLAUDE.md b/CLAUDE.md
index 50c27bc..78e55c2 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -15,6 +15,10 @@ Every merge into `main` is a release. Before committing any change to `mdcms.py`
 
 In practice: check out `development`, do the work, push to `development`, PR `development` → `main` when ready to release.
 
+## Unreleased changelog
+
+`docs/unreleased.md` is a living document that tracks every fix or feature on `development` that has not yet been merged to `main`. Keep it current: whenever a change lands on `development`, add or update an entry in `unreleased.md` in the same commit (or a follow-up commit to `development`). When a batch of changes is merged to `main` and released, clear the entries that were released and leave the file in place for the next round of work.
+
 ## What this project is
 
 MD-CMS is a markdown-based static site system with two distinct parts: