stack-pr

/orc:stack-pr

Convert a single big branch into a stack of smaller, chained PRs. Use this when the size gate fires on /orc:ship, or anytime you've ended up with a 600-LOC branch and want to break it down before review.

Arguments

• --smart — dispatch the orc-stack-analyzer agent to propose logical slices from the diff (rather than the default commit-based slicing). Use when commits are messy (WIP, fixups, no Conventional Commits).
• --base <branch> — target a non-default base (e.g. develop). Defaults to origin/HEAD.
• --draft — open every PR in the stack as a draft.
• --max-loc <N> — override the per-slice LOC budget (default: 300).
• --repos a,b / --repo a / --all-repos / --this-repo — workspace-mode targeting. See orc:workspace-mode.

Workflow

Phase 0 — Detect context

!orc-workspace-detect --banner

Context is injected above (ORC_* vars are exported for any Bash you run — do not re-run detection). Per-slice budget resolution: orc-pr-size budget ${ARG_MAX_LOC:+--max-loc "$ARG_MAX_LOC"}; per-slice LOC: orc-pr-size loc --base <slice-base>.

In workspace mode, resolve targetRepos from flags or AskUserQuestion. The stack lives per repo; cross-repo stacking is intentionally out of scope.

Phase 1 — Detect tooling

if command -v gh-stack >/dev/null 2>&1; then
  STACK_TOOL="gh-stack"
elif gh stack --help >/dev/null 2>&1; then
  STACK_TOOL="gh-stack-ext"
else
  STACK_TOOL="none"
fi

If none, present AskUserQuestion:

1. Install — run gh extension install github/gh-stack. Continue when complete.
2. Use plain-gh fallback — chain via gh pr create --base <prev-branch> per layer. No extension needed.
3. Cancel.

Never auto-install.

Phase 2 — Verify preconditions

Invoke orc:verification-before-completion (tests pass, lint clean). Then per repo:

git status --porcelain                              # must be empty
git rev-list --merges "$base"..HEAD                 # must be empty
n_commits=$(git rev-list --count "$base"..HEAD)     # must be ≥ 2
git rev-list "@{u}..HEAD" --count 2>/dev/null       # should be 0; warn if not