github-workflow — Claude Code subagent: what it does, how to install
github-workflow manages Git branches, Conventional Commits, and pull requests according to team conventions. Helpful for keeping repository history structured and tidy.
no license ★ 6,091 updated 2026-01-06
.claude/agents/github-workflow.mdWhat github-workflow 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.
What it helps with
- 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 for the agent
- Create a new branch with my initials
jdfor the auth refactor - Commit staged changes following Conventional Commits format
- Open a pull request for the login fix with a testing checklist
How to install github-workflow
Manually: put the files in place
.claude/agents/github-workflow.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/github-workflow.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/github-workflow.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about github-workflow
How do I install github-workflow in Claude Code?
Place the subagent definition file into your project at .claude/agents/github-workflow.md.
What does github-workflow do?
It guides routine Git operations like branch creation, staged diff inspections, and pull request generation. All commits and PR titles conform to Conventional Commits standards.
What prerequisites does github-workflow require?
The agent runs on the sonnet model. Creating pull requests directly from the terminal requires an active, authenticated gh command-line utility.