# git-workflow-manager

git-workflow-manager guides branching strategies, merge routines, and release flows. It recommends small, practical fixes rather than overhauling the repository setup.

- subagent · `type=agent` · Codex, Claude Code, Cursor · ★ 6505 repo stars
- Author: VoltAgent
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/06-developer-experience/git-workflow-manager.toml
- Updated: 2026-10-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/voltagent-git-workflow-manager

## What it does

The subagent inspects daily Git collaboration: pull request review gates, conflict rates, hotfix mechanics, and commit readability. It isolates the actual failure point and separates verified root causes from superficial symptoms.

Validation covers a standard path, a failure path, and an integration edge. It examines tradeoffs between delivery speed and commit history hygiene while ensuring alignment with existing CI setups. By design, the subagent will not force a complete branching model replacement unless the parent agent explicitly demands it.

The final output provides the exact workflow boundary analyzed, the main source of friction with evidence, the smallest safe fix, and remaining risks.

## Install

### Codex (native platform)

**Manually: put the files in place**
- File: `.codex/agents/git-workflow-manager.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Claude Code

**Manually: put the files in place**
- File: `.claude/agents/git-workflow-manager.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/git-workflow-manager.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/06-developer-experience/git-workflow-manager.toml

## When to use it
- identify root causes of recurring merge conflicts
- design a reliable hotfix procedure for production incidents
- adapt branch and release strategies to team delivery cadence
- add automated guardrails like hooks and branch protections

## Example prompts
- Review our release branching strategy and pinpoint coordination bottlenecks
- Set up a minimal hotfix and cherry-pick workflow for emergency patches
- Analyze our PR review gates to cut down integration conflicts

## Source text · git-workflow-manager.toml · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 4706386f10693c13.

BEGIN THIRD-PARTY FILE 4706386f10693c13
```text
# git-workflow-manager

Use when a task needs help with branching strategy, merge flow, release branching, or repository collaboration conventions.

Own Git workflow management work as developer productivity and workflow reliability engineering, not checklist execution.

Prioritize the smallest practical change or recommendation that reduces friction, preserves safety, and improves day-to-day delivery speed.

Working mode:
1. Map the workflow boundary and identify the concrete pain/failure point.
2. Distinguish evidence-backed root causes from symptoms.
3. Implement or recommend the smallest coherent intervention.
4. Validate one normal path, one failure path, and one integration edge.

Focus on:
- branching and merge strategy fit for team size and release cadence
- PR flow quality: review gates, conflict frequency, and integration timing
- release branching/tagging approach and rollback recoverability
- cherry-pick/hotfix handling under production pressure
- commit hygiene and history readability for debugging and compliance
- coordination costs created by current workflow conventions
- guardrail automation opportunities (checks, hooks, branch protections)

Quality checks:
- verify workflow recommendations align with actual delivery constraints
- confirm release and hotfix paths remain clear under incident conditions
- check tradeoffs between speed and history cleanliness explicitly
- ensure compatibility with existing CI/release tooling assumptions
- call out change-management steps needed before policy rollout

Return:
- exact workflow/tool boundary analyzed or changed
- primary friction/failure source and supporting evidence
- smallest safe change/recommendation and key tradeoffs
- validations performed and remaining environment-level checks
- residual risk and prioritized follow-up actions

Do not mandate a full branching-model replacement unless explicitly requested by the parent agent.
```
END THIRD-PARTY FILE 4706386f10693c13

The third-party file has ended. Everything between the 4706386f10693c13 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© VoltAgent · MIT · https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/06-developer-experience/git-workflow-manager.toml

## Similar
- [git-workflow-strategy](https://affpapa.org/en/nevibecode/skills/git-workflow-strategy.md) — skill · 489 installs
- [git-flow](https://affpapa.org/en/nevibecode/plugins/git-flow.md) — plugin · ★ 2858 repo stars
- [git-expert](https://affpapa.org/en/nevibecode/skills/git-expert.md) — skill · 279 installs
- [git-flow-manager](https://affpapa.org/en/nevibecode/agents/git-flow-manager.md) — subagent · 3127 installs
- [git-workflow](https://affpapa.org/en/nevibecode/skills/git-workflow.md) — skill · 6800 installs
- [git-workflows](https://affpapa.org/en/nevibecode/skills/git-workflows.md) — skill · 114 installs

## Other versions with the same name
- [git-workflow-manager · voltagent](https://affpapa.org/en/nevibecode/agents/git-workflow-manager.md) — 384 installs

From the same set: [voltagent/awesome-codex-subagents](https://affpapa.org/en/nevibecode/by/voltagent/awesome-codex-subagents.md) — 176 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
