Add branch navigation guide for local/remote mapping

Author: claude

.git-branches-guide.md

@@ -0,0 +1,62 @@
+# QuantCoder Branch Guide
+
+## Quick Switch Commands
+
+```bash
+# Switch to stable production (1.0)
+git checkout main
+
+# Switch to improved testing (1.1)
+git checkout beta
+
+# Switch to cutting edge (2.0) ⭐
+git checkout gamma
+```
+
+## Branch Mapping
+
+| Local Branch | Version | Remote Branch |
+|--------------|---------|---------------|
+| `main` | 1.0.0 | `origin/main` |
+| `beta` | 1.1.0-beta.1 | `origin/refactor/modernize-2025` |
+| `gamma` | 2.0.0-alpha.1 | `origin/claude/refactor-quantcoder-cli-JwrsM` |
+
+## Common Operations
+
+### Check current branch
+```bash
+git branch
+```
+
+### Pull latest changes
+```bash
+git pull
+```
+
+### Push your changes
+```bash
+git push
+# Git knows where to push based on tracking
+```
+
+### See all branches
+```bash
+git branch -vv
+# Shows local branches with tracking info
+```
+
+## Package Info
+
+- **main**: Uses `quantcli` package
+- **beta**: Uses `quantcli` package (improved)
+- **gamma**: Uses `quantcoder` package (new)
+
+## Why Different Remote Names?
+
+The remote uses technical naming for system requirements.
+Your local names are clean and user-friendly.
+**This is normal and a Git best practice!**
+
+---
+
+**Need help?** See `docs/BRANCH_VERSION_MAP.md`