# Git

> Git safety, staging, commit workflow, branching, pull requests, rebase, bisect, tagging, and worktrees. Load when working with branches, commits, PRs, or recovering from tricky git situations.

- Skill: `oornnery/git` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add oornnery/git`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oornnery/git/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: oornnery (https://skillmd.com/u/oornnery)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oornnery/git

---


# Git

Use when main problem is git workflow, not code.

## Boundary

Use for:

- safe staging and commit flow
- branch and PR workflow
- rebasing and syncing feature branches
- bisecting regressions
- stashing and worktrees
- tags and release-oriented git ops

Pair with:

- `skills/cicd/SKILL.md` for GitHub Actions CI and release automation
- `skills/quality/SKILL.md` when bisecting or isolating regressions
- `skills/docs/SKILL.md` when deliverable is release notes or changelog content

## Core safety rules

- stage files by name, not `git add .` or `git add -A`
- do not amend unless explicitly asked
- do not push unless explicitly asked
- do not skip hooks with `--no-verify`
- do not use destructive resets or cleanup commands casually
- do not delete dirty worktree without warning

## Common workflow

1. inspect working tree
2. group changes into logical units
3. stage explicitly by file or hunk
4. commit with precise conventional message
5. verify what remains uncommitted

Use `commands/commit.md` when task is specifically about preparing commits from current tree.

## Branching and PR workflow

Prefer short-lived feature branches and reviewable PRs.

PR checklist:

- title is conventional commit style summary
- description explains WHY
- valid passes for changed surface
- no secrets or unrelated changes included

Draft PRs appropriate for early feedback on incomplete work.

## Rebase vs merge

| Scenario                  | Preferred action |
| ------------------------- | ---------------- |
| update feature branch     | `git rebase`     |
| merge completed PR        | squash merge     |
| preserve explicit history | merge commit     |
| isolate regression        | `git bisect`     |

### Rebase pattern

```bash
git checkout feat/my-feature
git fetch origin
git rebase origin/main
```

If conflicts appear, resolve carefully and continue. Force-push only when explicitly asked and only with `--force-with-lease`.

## Bisect

Use `git bisect` when regression has known good point:

```bash
git bisect start
git bisect bad
git bisect good <commit>
```

Test each candidate commit until git identifies first bad commit.

Automated form:

```bash
git bisect start HEAD <good-commit>
git bisect run uv run pytest tests/path/to/test_file.py -v
git bisect reset
```

## Stash

Stash only when you truly need to park work temporarily:

```bash
git stash
git stash -m "description"
git stash list
git stash pop
```

Prefer worktrees over repeated stashing when you need parallel work.

## Tags and release flow

Use annotated tags for releases:

```bash
git tag -a v1.2.0 -m "release 1.2.0"
```

Create tags only after valid passes and only when release intent is clear.

## Worktrees

Use worktrees for:

- hotfixes while feature work is in progress
- isolated PR review
- verification without switching branches
- parallel agent work

Read `references/worktree.md` for full worktree guide.

## Useful commands

```bash
git status
git diff --stat
git log --oneline -10
git show <commit>
git blame path/to/file.py
git branch -a
git worktree list
```

## Related

- `commands/commit.md` -- prepare clean commits from current tree
- `commands/debug.md` -- investigate regressions before using `git bisect`
- `references/worktree.md` -- worktree patterns and caveats