diff --git a/CLAUDE.md b/CLAUDE.md
index 63517b8618e82a9f4c133fe34a2b9e361d1b9601..45eb8a71209dcee06fb5b2f31cd6cdcb40f78ece 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -5,6 +5,12 @@ This project uses **gitlab.syncad.com**, NOT gitlab.com.
 - Repository: https://gitlab.syncad.com/hive/denser
 - Use `glab api "projects/hive%2Fdenser/..."` for API calls
 
+## Git Workflow
+- **Branching**: Feature branches from `develop`, MRs target `develop`
+- **Main branch**: Periodically synced from `develop` (not direct commits)
+- **Issue linking**: Always link issues in MR descriptions using `Closes #123` or `Fixes #123`
+- **Separate MRs**: Create separate MRs for separate topics/issues
+
 ## Package Management
 - Check `.gitlab-ci.yml` for current Node/pnpm versions
 - Example: `docker run --rm -v "$(pwd)":/app -w /app node:<version> sh -c "corepack enable && pnpm install"`