feat: Add comprehensive Git workflow guide for ClickIt development and release processes

Author: jsonify

README.md

@@ -150,10 +150,49 @@ swift build -c release
 swift test -c release
 ```
 
+## Documentation
+
+### 📋 **Complete Development Workflow**
+- **[Git Workflow Guide](docs/git-workflow-guide.md)** - Complete step-by-step git workflow from feature development to production release
+- **[Fastlane Guide](docs/fastlane-guide.md)** - Automated build and release system documentation
+
+### 🚀 **Quick Reference**
+
+#### **Daily Development**
+```bash
+# 1. Start new feature
+git checkout main && git pull && git checkout -b feature/my-feature
+
+# 2. Develop and test
+fastlane dev  # Build and launch for testing
+
+# 3. Merge to staging for beta testing
+git checkout staging && git merge feature/my-feature
+
+# 4. Create beta release
+fastlane auto_beta
+```
+
+#### **Production Release**
+```bash
+# 1. Promote staging to main
+git checkout main && git merge staging
+
+# 2. Automated release with version bumping
+fastlane bump_and_release bump:minor  # 1.0.0 → 1.1.0
+```
+
+### 📚 **Additional Documentation**
+- **[CLAUDE.md](CLAUDE.md)** - Development guidance and project overview
+- **[BUILD_AND_DEPLOY.md](BUILD_AND_DEPLOY.md)** - Manual build and deployment instructions
+- **[CERTIFICATE_SETUP.md](CERTIFICATE_SETUP.md)** - Code signing certificate setup
+
 ## Contributing
 
 Contributions are welcome! Please read our contributing guidelines and check the Issues tab for open tasks.
 
+**Before contributing**: Read the [Git Workflow Guide](docs/git-workflow-guide.md) to understand our branch strategy and release process.
+
 ## License
 
 MIT License - see LICENSE file for details

docs/fastlane-guide.md

@@ -11,6 +11,13 @@ This guide explains how to use Fastlane for automating ClickIt development and r
 - [Troubleshooting](#troubleshooting)
 - [Advanced Usage](#advanced-usage)
 
+## 📋 Prerequisites
+
+**Git Workflow Knowledge Required**: This guide assumes you understand the ClickIt git workflow. If you're unsure about branch management, merging features to staging, or the complete development process, please read **[git-workflow-guide.md](git-workflow-guide.md)** first.
+
+**Quick Summary**: 
+- Features → `staging` branch → beta release → `main` branch → production release
+
 ## Installation
 
 ### Prerequisites
@@ -281,11 +288,12 @@ fastlane bump_and_release bump:minor force:true
 
 #### Zero-Friction Beta Release
 ```bash
-# Switch to staging branch
+# After merging your feature to staging:
 git checkout staging
+git pull origin staging
 
-# Make sure everything is committed
-git add . && git commit -m "Ready for beta"
+# Ensure clean working directory
+git status  # Should show "working tree clean"
 
 # One command beta release with auto-tagging
 fastlane auto_beta
@@ -294,11 +302,14 @@ fastlane auto_beta
 
 #### Zero-Friction Production Release  
 ```bash
-# Switch to main branch
+# After merging staging to main:
 git checkout main
+git pull origin main
+git merge staging
+git push origin main
 
-# Make sure everything is committed  
-git add . && git commit -m "Ready for production"
+# Ensure clean working directory
+git status  # Should show "working tree clean"
 
 # One command production release with auto-tagging
 fastlane auto_prod version:1.2.0