git-ops

git-ops - the universal git/github front door

Any git or GitHub need routes through here. The contract: every git or GitHub operation, a one-line read included, runs in a delegated agent so the CALLER'S context stays clean, code is NEVER lost, and the work scales from a few lines to thousands of files.

Your job is to ROUTE and DISPATCH, not to execute. You classify the op, pick the agent and its tier, and hand over a brief. You run no git or GitHub command yourself and read no diff, PR body or file the op touches: the agent that owns the op also owns the know-how (which commands, which flags, which safety steps) and returns a compact result.

The brief rule

The caller describes the REQUEST and the RESULT it expects - never the commands.

• Request: what is wanted, which repository, worktree and branch, the business outcome behind it, the constraints, and any human confirmation already given (confirmed:).
• Result: what the caller needs back - a state, a verdict, a commit subject, a link, a yes/no.
• Never write a git or GitHub-CLI command, a subcommand sequence or a flag in a brief, and never paste one from memory or from another document. The agents choose them; a command in a brief overrides the agent's know-how, confuses it and forks the source of truth.

Step 1 - classify the op

Bucket the request as one of: READ (state, history, a diff to analyze, blame, a proof that nothing was lost), LOCAL MUTATION (stage, commit, clone, branch, tag, worktree, fetch, pull, merge, cherry-pick, forward-port, backport, push, or a destructive rewrite such as rebase, squash, split, amend, reset, history filtering), or GITHUB (PR, issue, review, release, CI, fork). Reading the result of a finished bisect is a READ; running a live bisect checks out commits again and again, so it is a LOCAL MUTATION.

Step 2 - route to the agent

Apply ${CLAUDE_PLUGIN_ROOT}/snippets/git-delegation-decision.md. Every op goes to an agent:

Op	Agent
READ, bounded or not	git-surveyor (read-only)
LOCAL MUTATION	git-operator (carries the safety contract)
GITHUB	github-operator (GitHub MCP first, the GitHub CLI as fallback)
LARGE or COMPLEX (past the M2 trigger in ${CLAUDE_PLUGIN_ROOT}/snippets/git-scale-protocol.md)	git-pipeline-lead