# github-workflow

github-workflow manages Git branches, Conventional Commits, and pull requests according to team conventions. Helpful for keeping repository history structured and tidy.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 6091 repo stars
- Author: ChrisWiles
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ChrisWiles/claude-code-showcase/tree/HEAD/.claude/agents/github-workflow.md
- Updated: 2026-01-06
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/github-workflow

## What it does

This subagent enforces repository conventions across daily Git actions. It runs on the `sonnet` model. Branches receive standard prefixes built from contributor initials followed by a task slug.

Before committing, the agent inspects modified files with `git status` and staged differences via `git diff --staged`. It categorizes commit messages using Conventional Commits prefixes such as `feat`, `fix`, `docs`, or `refactor`. PR titles follow the exact same structure to keep the changelog consistent.

Publishing a pull request triggers `gh pr create` prefilled with change summaries and a test plan checklist. Without the GitHub CLI installed and authenticated in your environment, PR generation will fail.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

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

### Codex

**Manually: put the files in place**
- File: `.codex/agents/github-workflow.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/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/github-workflow.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/ChrisWiles/claude-code-showcase/tree/HEAD/.claude/agents/github-workflow.md

## When to use it
- name Git branches using developer initials and task slugs
- write Conventional Commits with standard type prefixes
- generate pull requests via GitHub CLI with test plan checklists
- verify diffs, local tests, and lint rules before pushing code

## Example prompts
- Create a new branch with my initials `jd` for the auth refactor
- Commit staged changes following Conventional Commits format
- Open a pull request for the login fix with a testing checklist

## Similar
- [devkit.github.create-pr](https://affpapa.org/en/nevibecode/commands/devkitgithubcreate-pr.md) — command · ★ 372 repo stars
- [github-pr](https://affpapa.org/en/nevibecode/skills/github-pr.md) — skill · 205 installs
- [github-repo-health-wasp-drone](https://affpapa.org/en/nevibecode/agents/github-repo-health-wasp-drone.md) — subagent · ★ 96 repo stars
- [github-pr-creation](https://affpapa.org/en/nevibecode/skills/github-pr-creation.md) — skill · 240 installs
- [jackin-create-pr](https://affpapa.org/en/nevibecode/skills/jackin-create-pr.md) — skill · 469 installs
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github-github.md) — MCP server · 5908 installs

From the same set: [chriswiles/claude-code-showcase](https://affpapa.org/en/nevibecode/by/chriswiles/claude-code-showcase.md) — 11 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
