diff --git a/README.md b/README.md
index 763acaa..7f361c6 100644
--- a/README.md
+++ b/README.md
@@ -341,6 +341,12 @@ This window reads the scaffold back: every beat it names, and whether prose has
 been written under it, with a progress bar over the whole outline. A beat counts
 as written when there is ordinary text between its prompt and the next one.
 
+**Heading hierarchy is preserved**: markdown headings (`#`, `##`, `###`) in the
+outline files create a nested tree structure in the Outline window. Beats under
+the same heading are grouped together under a collapsible header showing the
+progress for that section (`3/5` beats written, for example). This makes it easy
+to navigate large outlines and see progress at every level of your story structure.
+
 Beats generated by [the Mistral tool](#plot-beats-mistral) can be appended
 straight into the matching act file with **📝 Append to act_0N.md**, which
 appears when a run filled exactly one act. It appends under a dated comment
@@ -841,3 +847,18 @@ rendered as a text placeholder (not embedded).
 A quick reference for all of this — plus the chapter metadata, draft-marker
 header, and comment conventions — is built in: open **Help ▸ Markdown cheatsheet**
 from the menu bar.
+
+## Changelog
+
+### Latest
+
+- **Heading-based nesting outlines**: Markdown headings (`#`, `##`, `###`) in outline
+  files now create a hierarchical tree structure in the Outline window. Beats under
+  the same heading are grouped together under collapsible headers with progress
+  counts, making it easy to navigate large outlines and track progress at every
+  level of your story structure.
+- **Linked scene/chapter templates**: New file templates now support linked
+  planning+draft file pairs. Creating a scene in the draft folder automatically
+  creates a corresponding planning file in the Plot folder with references.
+- **Automatic workspace refresh**: File list now automatically refreshes when
+  files change on disk using a file watcher.