git-workflow

Guides committing, pushing, and resolving merge conflicts in this repository.

64|11|Updated May 24, 2026
One-click install
npx skills add https://github.com/AlexanderMattTurner/agent-glovebox --skill git-workflow-alexandermattturner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow
Source: https://github.com/AlexanderMattTurner/agent-glovebox/tree/main/.claude/skills/git-workflow
Command: npx skills add https://github.com/AlexanderMattTurner/agent-glovebox --skill git-workflow-alexandermattturner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? This Skill prevents costly git mistakes in this repository by encoding the exact rules for committing, pushing, and handling merge conflicts, including when to defer conflicts to the auto-resolve workflow instead of resolving them by hand. ## Core Features & Use Cases - Conventional Commit discipline: Enforces commitlint-compatible messages written via quoted heredocs, with no amend, rebase, squash, or force-push allowed. - Merge conflict triage: Decides whether a conflict belongs to the auto-resolve bot or to a hand resolution, and how to audit the bot's remerge-diff output. - Push and worktree safety: Covers detached-worktree pushes, zsh quoting traps, push supersede damping, and backgrounding long hook suites. - Use Case: When a PR shows a dirty mergeable_state or a merge-conflict label, activate this Skill to determine whether to let the auto-resolve workflow land it or to resolve it by hand with the correct evidence trail. ## Quick Start Ask the assistant to commit and push the current changes following this repository's git workflow rules.

Frequently Asked Questions about git-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a commit message that passes commitlint?

Use the Conventional Commits format: a type like feat, fix, or ci, an optional scope, and an imperative lowercase subject under 72 characters. Write the body through git commit -F - with a quoted heredoc so zsh does not mangle backticks or dollar signs.

Should I resolve a merge conflict myself or let the bot handle it?

By default, leave the conflict to the auto-resolve workflow, which regenerates files and pushes the merge. Resolve by hand only when evidence shows the workflow will not act, such as a declined or handed-off mark, a missing consent label, or a stacked-child PR.

Why does my git push fail with 'src refspec does not match any' in zsh?

Zsh applies a colon history modifier to unbraced variables, so "$sha:refs/heads/x" loses characters after the colon. Brace the variable as "${sha}:refs/heads/x" or build the refspec with printf to avoid the parse.

Can I amend or rebase a commit to fix a bad message?

No. This repository forbids amend, rebase, squash, force-push, and --no-verify. Fix any mistake, including a rejected commit message, with a new commit, and resolve conflicts only with merge commits.

How do I audit the auto-resolve bot's merge resolution?

Read the remerge-diff-report comment or run git show --remerge-diff with the merge driver override, then diff the merge against each parent. Watch for deletions the other parent made that the merge silently restored, and push corrections to the PR branch.

Why does git stash fail in this repository and what should I use instead?

git stash push -u aborts on an unreadable sandbox path and a later pop can pull a foreign stash entry into your tree. Provision a detached worktree with git worktree add --detach instead to compare against HEAD safely.