Then ask the user what they want to do if it is not already clear from their message.

Branching

When creating a new branch:

Confirm the base branch (usually main or develop).
Pull the latest changes: git pull origin <base>.
Create a descriptive branch name following the pattern <type>/<short-description>:
- feat/add-login-page
- fix/null-pointer-in-auth
- chore/update-dependencies
- docs/api-reference
Create and switch: git checkout -b <branch-name>.

Committing

Write commits that follow the Conventional Commits spec:

<type>(<optional scope>): <short imperative summary>

[optional body explaining *why*, not what]

[optional footer: BREAKING CHANGE, closes #issue]

Allowed types: feat, fix, docs, style, refactor, perf, test, chore, ci, build, revert.

Rules:

Summary is ≤ 50 characters, lowercase, no trailing period.
Use the body for non-obvious reasoning.
Reference issues with closes #<n> or refs #<n>.

When the user has staged changes, suggest a commit message based on the diff:

git diff --cached

Pull Requests

Before opening a PR:

Rebase onto the latest base branch to keep history linear:
```
git fetch origin
git rebase origin/main
```
Run tests and linters.
Push the branch: git push -u origin <branch-name>.
Draft a PR description using this template:

## What & Why
<!-- One paragraph explaining the change and its motivation. -->

## How
<!-- Key implementation decisions. -->

## Testing
<!-- How was this tested? -->

## Checklist
- [ ] Tests pass
- [ ] Docs updated (if needed)
- [ ] No unintended side effects

Merge conflict resolution

When conflicts are detected:

List conflicting files: git diff --name-only --diff-filter=U.
For each file, show the conflict markers and explain both sides.
Suggest the correct resolution based on the intent of each change.
After resolving, stage the file: git add <file>.
Continue the rebase or merge: git rebase --continue / git merge --continue.

Keeping history clean

Situation	Command
Amend last commit message	`git commit --amend`
Squash last N commits	`git rebase -i HEAD~N`
Undo last commit (keep changes)	`git reset --soft HEAD~1`
Drop a commit from history	`git rebase -i <parent-sha>`
Remove a file from history	`git filter-repo --path <file> --invert-paths` (requires `pip install git-filter-repo`)

Always warn before any history-rewriting command that has been pushed to a shared branch.

Output format

After every operation, show:

The exact commands run
The output
What the next step is

Keep explanations concise. If something could go wrong, warn proactively.

git-workflow

Git Workflow Skill

Detect context