| name | git-workflow |
| description | Essential Git patterns for effective version control, eliminating redundant Git guidance per agent. |
| user-invocable | false |
| disable-model-invocation | true |
| license | Apache-2.0 |
| compatibility | claude-code |
| metadata | {"updated_at":"2025-10-30T17:00:00.000Z"} |
| tags | ["git","version-control","workflow","best-practices"] |
| progressive_disclosure | {"entry_point":{"summary":"Essential Git patterns for effective version control, eliminating redundant Git guidance per agent.","when_to_use":"When working with version control, branches, or pull requests.","quick_start":"1. Review the core concepts below. 2. Apply patterns to your use case. 3. Follow best practices for implementation."}} |
Git Workflow
Essential Git patterns for effective version control. Eliminates ~120-150 lines of redundant Git guidance per agent.
Commit Best Practices
Conventional Commits Format
<type>(<scope>): <subject>
<body>
<footer>
Types:
feat: New feature
fix: Bug fix
docs: Documentation only
refactor: Code change that neither fixes bug nor adds feature
perf: Performance improvement
test: Adding or updating tests
chore: Build process, dependencies, tooling
Examples:
feat(auth): add OAuth2 authentication
Implements OAuth2 flow using Google provider.
Includes token refresh and validation.
Closes
fix(api): handle null response in user endpoint
Previously crashed when user not found.
Now returns 404 with error message.
perf(db): optimize user query with index
Reduces query time from 500ms to 50ms.
Atomic Commits
git commit -m "feat: add user authentication"
git commit -m "test: add auth tests"
git commit -m "docs: update API docs for auth"
git commit -m "add auth, fix bugs, update docs"
Branching Strategy
Git Flow (Feature Branches)
git checkout main
git pull origin main
git checkout -b feature/user-authentication
git add src/auth.py
git commit -m "feat(auth): implement login endpoint"
git checkout main
git pull origin main
git checkout feature/user-authentication
git rebase main
git push -u origin feature/user-authentication
Trunk-Based Development