Files
leo-claude-mktplace/plugins/git-flow
lmiranda e5ca804692 feat: v3.0.0 architecture overhaul
- Rename marketplace to lm-claude-plugins
- Move MCP servers to root with symlinks
- Add 6 PR tools to Gitea MCP (list_pull_requests, get_pull_request,
  get_pr_diff, get_pr_comments, create_pr_review, add_pr_comment)
- Add clarity-assist plugin (prompt optimization with ND accommodations)
- Add git-flow plugin (workflow automation)
- Add pr-review plugin (multi-agent review with confidence scoring)
- Centralize configuration docs
- Update all documentation for v3.0.0

BREAKING CHANGE: MCP server paths changed, marketplace renamed

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 16:56:53 -05:00
..
2026-01-20 16:56:53 -05:00
2026-01-20 16:56:53 -05:00

git-flow

Git workflow automation with intelligent commit messages and branch management.

Overview

git-flow streamlines common git operations with smart defaults, conventional commit messages, and workflow enforcement. It supports multiple branching strategies and adapts to your team's workflow.

Commands

Command Description
/commit Create commit with auto-generated conventional message
/commit-push Commit and push in one operation
/commit-merge Commit and merge into target branch
/commit-sync Full sync: commit, push, and rebase on base branch
/branch-start Start new feature/fix/chore branch
/branch-cleanup Clean up merged branches
/git-status Enhanced status with recommendations
/git-config Configure git-flow settings

Workflow Styles

Style Description Best For
simple Direct commits to main Solo projects
feature-branch Feature branches, merge when done Small teams
pr-required All changes via pull request Code review workflows
trunk-based Short-lived branches, frequent integration CI/CD heavy

Installation

Add to your project's .claude/settings.json:

{
  "plugins": ["git-flow"]
}

Configuration

Set environment variables in .env or ~/.config/claude/git-flow.env:

GIT_WORKFLOW_STYLE=feature-branch
GIT_DEFAULT_BASE=development
GIT_AUTO_DELETE_MERGED=true
GIT_AUTO_PUSH=false
GIT_PROTECTED_BRANCHES=main,master,development,staging
GIT_COMMIT_STYLE=conventional
GIT_CO_AUTHOR=true

Or use /git-config for interactive configuration.

Features

Smart Commit Messages

Analyzes staged changes to generate appropriate conventional commit messages:

feat(auth): add password reset functionality

Implement forgot password flow with email verification.
Includes rate limiting and token expiration.

Branch Naming

Enforces consistent branch naming:

feat/add-user-authentication
fix/login-timeout-error
chore/update-dependencies

Safety Checks

  • Warns before commits to protected branches
  • Confirms force push operations
  • Prevents accidental branch deletion

Conflict Resolution

The git-assistant agent helps resolve merge conflicts with analysis and recommendations.

Usage Examples

Start a Feature

/branch-start add user authentication

→ Created: feat/add-user-authentication
  Based on: development

Commit Changes

/commit

→ Analyzing changes...
→ Proposed: feat(auth): add login component
→ Committed: abc1234

Full Sync

/commit-sync

→ Committed: abc1234
→ Pushed to origin
→ Rebased on development
→ Status: Clean, up-to-date

Integration

For CLAUDE.md integration instructions, see claude-md-integration.md.

License

MIT