Documentation
README
pr-splitter — break a big PR into reviewable pieces
The original branch is source material, never a casualty: snapshot it, build smaller PRs from it deliberately, and keep a local ledger of what went where.
Announce at start: "Using the pr-splitter skill — splitting {branch} into smaller PRs."
Never use interactive git commands (git restore -p, git add -i,
git rebase -i) — they hang in this environment. Every extraction below is
non-interactive.
Step 1: Snapshot before touching anything
git status --porcelain # must be empty; if not, STOP — commit or stash first
BASE=$(git merge-base origin/main HEAD)
git branch backup/original-$(git branch --show-current)
Do not delete or rewrite the original branch until the split has fully shipped.
This is the opening of the README. Read the full README on GitHub.