---
name: rebase-assistant
description: Guide a safe git rebase of the current branch onto a target branch, including conflict triage and resolution steps. Use when asked to rebase, update a branch, or resolve rebase conflicts.
---
# Rebase assistant

## Goal
Rebase the current branch onto a target branch safely, with built-in conflict resolution guidance.

## Inputs to confirm (ask if missing)
- Target branch (explicit branch name or "default branch").
- Preferred conflict bias when ambiguous: keep ours, keep theirs, or manual merge.
- Protected paths or file types to avoid touching.

## Workflow
1) Identify the target branch
   - If user says "default branch": discover via `git remote show origin` (read "HEAD branch").
   - If ambiguous or no remote: ask the user which branch to use.
2) Preflight checks
   - `git status -sb` (must be clean before rebase).
   - `git fetch --prune` to sync remotes.
   - Optional safety branch (ask before creating): `git branch backup/<current-branch>`.
3) Start the rebase
   - `git rebase <target-branch>`
4) If conflicts occur, resolve (repeat per file)
   - Inspect conflict list:
     - `git status -sb`
     - `git diff --name-only --diff-filter=U`
   - Classify and inspect:
     - Content conflicts: open file, resolve markers.
     - Delete/modify or rename conflicts: decide keep vs delete explicitly.
     - Binary conflicts: choose ours/theirs only.
   - Show base/ours/theirs when useful:
     - `git show :1:<path>`
     - `git show :2:<path>`
     - `git show :3:<path>`
   - File-level choice when safe:
     - `git checkout --ours <path>`
     - `git checkout --theirs <path>`
   - Stage resolved files: `git add <path>`
   - Continue: `git rebase --continue`
5) Finish and verify
   - Ensure no conflicts: `git status -sb`
   - Suggest a fast test/build if available.

## Safety rules
- Never run `git reset --hard`, `git clean -fd`, or `git rebase --abort` unless the user explicitly requests it.
- Always show candidate commands before applying destructive changes.

## Deliverables
- The exact rebase command used and target branch.
- Conflict list grouped by type with per-file resolution guidance.
- Completion command and a short verification suggestion.