prepare repo

README.md

@@ -1,6 +1,8 @@
 # CMS Monorepo (Bun + Biome + Next.js)
 
 Roadmap and progress are tracked in `TODO.md` (also visible in admin at `/todo`).
+Branch model and promotion flow are documented in `BRANCHING.md`.
+Commit schema and changelog workflow are documented in `CONTRIBUTING.md`.
 
 A baseline monorepo with:
 
@@ -113,6 +115,22 @@ Notes:
 - `dev` remains your local non-docker Bun workflow.
 - Staging and production compose files are templates and still require real secrets, registry strategy, and deployment host wiring.
 
+## Changelog
+
+- Changelog file: `CHANGELOG.md`
+- Commit schema: Conventional Commits (see `CONTRIBUTING.md`)
+- Generate/update changelog from git commits:
+
+```bash
+bun run changelog:release
+```
+
+- Preview generated output without writing file:
+
+```bash
+bun run changelog:preview
+```
+
 ## Recommended next packages
 
 - Auth: `better-auth` or `next-auth`