| name | git-workflow-standards |
| description | Use when managing branches, resolving merge conflicts, syncing with main, or working with worktrees |
| metadata | {"author":"dryvist"} |
Git Workflow Standards
Worktree Structure
All development uses dedicated worktrees. Never work directly on main.
Create a worktree for the change; remove it when the work is done.
Every branch with commits MUST have an associated PR.
Orphaned branches must get a PR or be deleted.
Stale worktree: A branch with no open PR, no uncommitted changes, and either a merged PR
whose headRefOid matches local HEAD, or a deleted remote ([gone]) with no commits ahead
of the default branch (git log origin/<default>..HEAD --oneline is empty). Branches with open
PRs, local-only branches without merged PRs, local commits beyond the merged PR head, and
worktrees with uncommitted changes are NEVER stale. Use git worktree remove (never --force)
— Git natively blocks removal of dirty worktrees.
Branch Hygiene
- Sync main daily:
git pull
- Long-running branches: rebase from main weekly
- Before PRs: ensure branch is on latest main
- Never branch from feature branches — always from main
- Commit messages: conventional-commit prefixes only, no emoji (see
pr-standards)
| Method | When |
|---|
git merge origin/main | Default — preserves history, safer |
git rebase origin/main | Only if branch has NOT been pushed yet |
Sync main workflow:
git fetch origin main && git pull origin main
git merge origin/main --no-edit
Merge Conflict Resolution
NEVER assume newer is correct. Analyze both versions.
- Understand — read full file, check
git log --oneline -10 -- <file>
- Analyze — identify what each side changed and why, check compatibility
- Resolve — use the resolution table below
- Verify — run
pre-commit run --files <file>, read resolved file
| Scenario | Resolution |
|---|
| Additive changes | Keep both |
| Same logic modified | Combine intent of both |
| One is a bug fix | Always include the fix |
| One is a refactor | Apply refactor, then add other change |
| Truly incompatible | Prefer branch's changes, add comment |
Escalate to human review for complex business logic, fundamental
contradictions, or security-sensitive code.
| Command | Purpose |
|---|
git diff --name-only --diff-filter=U | List conflicted files |
git log --merge -p <file> | Show commits causing conflict |
git show :1:<file> | Common ancestor version |
git show :2:<file> | HEAD (your branch) version |
git show :3:<file> | Incoming (their branch) version |
git merge --abort | Abort and return to pre-merge state |
Related Skills
- sync-main (git-workflows) — Syncs main and merges into current or all PR branches
- refresh-repo (git-workflows) — Full repo sync including PR status and worktree cleanup
- pr-standards (git-standards) — PR creation guards, issue linking, and review standards
Source: dryvist/claude-code-plugins — distributed by TomeVault.
