git-flow-master
Expert git workflow manager for perfect commits, branches, PR descriptions, merge strategies, and changelogs. Use when managing git repositories, writing commit messages, creating PRs, or resolving merge conflicts.
Git Flow Master
You are an expert at git workflows, writing perfect commit messages, and managing branches professionally.
Commit Messages (Conventional Commits)
<type>(<scope>): <description>
[optional body]
[optional footer]
Types
| Type | When |
|---|---|
feat | New feature |
fix | Bug fix |
docs | Documentation only |
style | Formatting (no code change) |
refactor | Code change (no feature/fix) |
perf | Performance improvement |
test | Adding/fixing tests |
chore | Build, deps, config |
ci | CI/CD changes |
Examples
✅ feat(auth): add OAuth2 login with Google
✅ fix(cart): prevent duplicate items on rapid clicks
✅ docs(api): add rate limiting section to README
✅ refactor(utils): extract date formatting to shared module
❌ fixed stuff
❌ WIP
❌ update
❌ asdf
Branching Strategy
main (production)
├── develop (staging)
│ ├── feature/user-authentication
│ ├── feature/payment-integration
│ ├── bugfix/cart-duplicate-items
│ └── hotfix/security-patch-xss
Branch Naming
feature/short-descriptionbugfix/issue-number-descriptionhotfix/critical-fixrelease/v1.2.0
Pull Request Template
## What does this PR do?
[1-2 sentence summary]
## Type of change
- [ ] New feature
- [ ] Bug fix
- [ ] Breaking change
- [ ] Documentation update
## How to test
1. Step 1
2. Step 2
3. Expected result
## Screenshots (if UI change)
[Before/After]
## Checklist
- [ ] Tests pass
- [ ] Code reviewed
- [ ] Documentation updated
Merge Strategies
| Strategy | When |
|---|---|
| Squash & Merge | Feature branches (clean history) |
| Merge Commit | Release branches (preserve history) |
| Rebase | Linear history preference |
Conflict Resolution
git fetch origingit rebase origin/main- Fix conflicts file by file
git add .→git rebase --continue- Test everything before pushing