diff --git a/AGENTS.md b/AGENTS.md
index 40fd7ba..28834d0 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -48,6 +48,7 @@ This repository is a browser-first photo mapping prototype.
 - Make small, focused changes.
 - Commit every git change set before finishing a task.
 - Use conventional commit messages.
+- Document each committed change set in `Changelog.md` with a short summary.
 - Verify the result with `git diff --check` when possible.
 - Update the README only when the user-facing setup or features change.
 
diff --git a/Changelog.md b/Changelog.md
new file mode 100644
index 0000000..75e1fa0
--- /dev/null
+++ b/Changelog.md
@@ -0,0 +1,44 @@
+# Changelog
+
+This file summarizes the project's git history in short, readable steps.
+
+## Foundation
+
+- `28c91a4` / `cc5a567`: Initialized the project metadata and the TypeScript server skeleton.
+- `caea566` / `4ef8ae3`: Documented the structure and added the first map-based web interface.
+
+## Nextcloud Import
+
+- `3ec8b28` / `3d92cff`: Added browser-side Nextcloud share loading and documented the import flow.
+- `9fe4752`: Routed share requests through the server proxy.
+- `36f6504` / `8218583` / `c21a67d`: Added progressive loading, cancel support, and cleaned up abort handling.
+
+## UI And Timeline
+
+- `047177c` / `800ee47`: Localized the UI and improved API error messages.
+- `4084db1` / `cf2b768` / `465b214`: Added the interactive timeline, fixed share parsing, and enabled zoomable date ranges.
+- `e094745` / `d710438` / `f819785`: Refined spacing, added dark mode, and tightened the visual style.
+- `13a8739` / `0e1d1f6` / `e557231` / `d50f668` / `5f2bd97` / `faeecfa` / `96ef037`: Added marker thumbnails and progressively cleaned up the copy and wording.
+
+## Packaging And Refactors
+
+- `c34c0fc` / `a0a6c8e` / `4de12db`: Added Docker support and the initial agent guidance.
+- `44588da` / `d98ec5f` / `b30a711`: Stabilized the sidebar, validated proxy targets, and throttled photo rendering.
+- `55c0051` / `465aba4` / `c465cc9` / `45d1b2d`: Renamed the project to mapix and refined the timeline behavior.
+- `e7e876a` / `5cb853b` / `18f566c` / `fe7787d` / `bb1d388` / `e2e41a7`: Added CI and several map and UI refactors.
+- `fb60196` / `fd02b09` / `5464c1f` / `6eb95cb` / `ffd2ca8`: Compact photo tiles, restored dark theme behavior, and tightened popup layout.
+
+## Recent Enhancements
+
+- `7193457` / `5d3b91a` / `01c27a9` / `a12d87c` / `28387dc`: Added client-side thumbnails and improved the fullscreen overlay and popup spacing.
+- `6d5d168` / `2669f87` / `d2e77d9` / `99cad2f`: Stabilized scrolling, fixed thumbnail sizing, and moved the theme toggle to the top right.
+- `f3fdf15` / `ab8cad1` / `1d04468`: Restored timeline selection highlighting, added route visibility toggling, and followed the system color scheme by default.
+- `62b1745` / `9c1a6ac` / `f061dd2` / `ee75333` / `df17afe`: Split server assets, extracted proxy handlers, modularized the client, and covered proxy URL handling.
+- `8eec2d4` / `0ea9e43` / `5e10be4`: Polished map control states, clarified timeline selection states, and bundled browser dependencies locally.
+- `4dd9e5e` / `ffd094d` / `11d8b42` / `f621a4e`: Added brand assets, introduced the themed sidebar logo, switched to PNG assets, and reduced the logo size.
+- `871e2c2`: Expanded the README with a screenshot and a fuller feature overview.
+
+## Notes
+
+- The repo now keeps browser dependencies and static brand assets local so the runtime does not depend on third-party CDNs.
+- Commit history is expected to be reflected here in short summaries after each committed change set.