Skip to content

Commit 013cba2

Browse files
randleeclaude
andcommitted
docs(sc-gh-stacks): web-UI stack merge is sanctioned for humans, not a workaround
Field-confirmed: GitHub's UI stack merge is the same native flow gh stack merge drives (bottom layers land, upper PRs retarget automatically). Only gh pr merge retries and hand-rolled REST remain forbidden; agents use gh stack merge <pr#> --yes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent a5fb55b commit 013cba2

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

  • packages/sc-gh-stack/skills/managing-gh-stacks

packages/sc-gh-stack/skills/managing-gh-stacks/SKILL.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,10 @@ description: >
88
dependency graph onto stacks and worktrees, convert several existing PRs into
99
one stack, keep a stack cleanly rebased as fixes merge into middle layers, or
1010
land a whole stack in one CI cycle. Also use when GitHub refuses a normal
11-
merge because a PR is "part of a stack" — never work around that with
12-
`gh pr merge`, the web UI, or raw REST calls. Read this before running any
13-
`gh stack` command — the tool is new, blocks under a PTY, and cannot be
14-
driven from prior knowledge.
11+
merge because a PR is "part of a stack" — the answer is `gh stack merge`,
12+
never retrying `gh pr merge` or hand-rolling REST calls. Read this before
13+
running any `gh stack` command — the tool is new, blocks under a PTY, and
14+
cannot be driven from prior knowledge.
1515
---
1616

1717
# Managing gh Stacks
@@ -113,7 +113,7 @@ one agent per stack:
113113
| Task graph → parallel dev plan | `sc-stack-plan` | tasks, trunk, repo_root | stacks + worktree creation commands + open questions |
114114
| Flat PRs → one stack | `sc-stack-convert` | trunk, layers (bottom→top), repo_root | decision log: branches before/after/pushed, resolutions, surfaced conflicts |
115115
| Trunk moved / mid-stack fix merged | `sc-stack-sync` | worktree, fix_branch? | decision log: same contract |
116-
| `gh pr merge` refused: PR is "part of a stack" | none — run `gh stack merge <pr#> --yes` || merges that PR and every unmerged PR below it, atomically; never fall back to raw REST or the web UI |
116+
| `gh pr merge` refused: PR is "part of a stack" | none — run `gh stack merge <pr#> --yes` || merges that PR and every unmerged PR below it, atomically; PRs above retarget automatically. Never hand-roll REST calls. (GitHub's web UI stack merge is the same native flow — fine for humans, not agent-drivable.) |
117117

118118
Read `references/playbook-graph-to-stacks.md`, `references/playbook-convert.md`, or
119119
`references/playbook-sync.md` first — each is a worked example including the agent prompt and

0 commit comments

Comments
 (0)