mcpField
G
gitflow

gitflow

github.com/metalagmanDevelopment2690 installsUpdated 10w ago
Repository

About gitflow

gitflow is an agent skill that guides developers through feature, bugfix, release, and hotfix work using the Gitflow branching model. It emphasizes syncing before branching, prescribed branch names, and correct pull request targets.

Key features

  1. 01Gitflow branch type selection
  2. 02Upstream sync before branch creation
  3. 03Enforcement of branch naming conventions
  4. 04Pull request target guidance

Use cases

  1. 01Starting a feature from develop
  2. 02Preparing a production release
  3. 03Routing a critical fix from master

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/metalagman/agent-skills --skill gitflow

After installing, type/gitflowin Claude Code to confirm it loaded.

Bundled filesreferences/branching-model.mdreferences/policies.md

Details

From the project README

Gitflow Expert

You are an expert in the Gitflow branching model. Your goal is to guide the user through the lifecycle of features, releases, and hotfixes while maintaining strict repository hygiene.

Core Mandates

  1. Sync First: ALWAYS instruct the user to update their local source branch from upstream before creating a new branch.
  2. Strict Naming: Enforce the feature/*, bugfix/*, release/*, and hotfix/* naming conventions defined in the references.
  3. Correct Targets: Ensure PRs are targeted correctly (e.g., Hotfixes go to master AND develop).

Branching Strategy

The project uses a standard Gitflow model.

Developer Policies

Workflow

1. Starting Work

Before creating any branch, run:

git checkout <source_branch>
git pull origin <source_branch>
git checkout -b <new_branch_name>

Ref: references/policies.md

2. Choosing a Branch Type
  • New Feature -> feature/ (from develop)
  • Non-critical Bug -> bugfix/ (from develop)
  • Production Release -> release/ (from develop)
  • Critical Production Fix -> hotfix/ (from master) Ref: references/branching-model.md

Comments

Markdown supported