Skills › Compound Engineering › ce-babysit-pr › stack-commands.md

stack-commands.md

39 lines · skills/ce-babysit-pr/references/stack-commands.md at 3449230

1# Managed-stack CLI recipes

3Load this file when the active run uses a confirmed managed stack (`manager_status == "confirmed"`) and needs `gh stack` command recipes. Soft-depend on the CLI: if `gh stack` is missing or exits unavailable (e.g. code 9), surface a clear residual — do not invent managed membership from topology.

5Always non-interactive. Prefer JSON/view probes and explicit branch names; never rely on interactive prompts. Substitute `<tracking-remote>` with the stack branches' actual tracking remote (often `origin`, but may be `upstream` or a fork remote) — never hard-code `origin` when SKILL.md already resolved a different tracking remote.

Managed-stack CLI recipes

Load this file when the active run uses a confirmed managed stack (manager_status == "confirmed") and needs gh stack command recipes. Soft-depend on the CLI: if gh stack is missing or exits unavailable (e.g. code 9), surface a clear residual — do not invent managed membership from topology.

Always non-interactive. Prefer JSON/view probes and explicit branch names; never rely on interactive prompts. Substitute <tracking-remote> with the stack branches' actual tracking remote (often origin, but may be upstream or a fork remote) — never hard-code origin when SKILL.md already resolved a different tracking remote.

Raw lines 1 to 6

7## After an owned push on the active layer (dependents exist)

9```bash

10gh stack rebase "<first-open-dependent-branch>" --upstack --no-trunk --remote <tracking-remote>

11gh stack push --remote <tracking-remote>

12```

14Starting at the first dependent excludes the active target from the cascading rebase. Quote the branch name — git branch names may contain shell metacharacters. On conflict: `gh stack rebase --abort`, then surface a needs-human / stack-sync residual.

After an owned push on the active layer (dependents exist)

gh stack rebase "<first-open-dependent-branch>" --upstack --no-trunk --remote <tracking-remote>
gh stack push --remote <tracking-remote>

Starting at the first dependent excludes the active target from the cascading rebase. Quote the branch name — git branch names may contain shell metacharacters. On conflict: gh stack rebase --abort, then surface a needs-human / stack-sync residual.

Raw lines 7 to 15

16## Discover order / next open layer

18```bash

19gh stack view --json

20```

Discover order / next open layer

gh stack view --json

Raw lines 16 to 21

22## Land one prefix (only under `posture:stack-land`)

24Merge the **bottom-most open settled** PR — `gh stack merge <PR>` merges the full stack prefix through that PR atomically. Never merge an upstack active PR while downstack PRs remain open when single-prefix landing is intended.

26```bash

27gh stack merge <BOTTOM_MOST_OPEN_SETTLED_PR> --yes --squash

28gh stack sync --remote <tracking-remote>

29```

31Re-probe the landed PR before advancing: on merge-queue bases the CLI may succeed after enqueue while the PR stays OPEN — keep watching or return a queued residual until `pr_state` is `MERGED`. Only then treat the just-merged PR as a **layer transition** (stop watcher, re-probe, continue next open non-draft needing work with posture restated) — not a run-level Terminal stop for this babysit invocation.

Land one prefix (only under `posture:stack-land`)

Merge the bottom-most open settled PR — gh stack merge <PR> merges the full stack prefix through that PR atomically. Never merge an upstack active PR while downstack PRs remain open when single-prefix landing is intended.

gh stack merge <BOTTOM_MOST_OPEN_SETTLED_PR> --yes --squash
gh stack sync --remote <tracking-remote>

Re-probe the landed PR before advancing: on merge-queue bases the CLI may succeed after enqueue while the PR stays OPEN — keep watching or return a queued residual until pr_state is MERGED. Only then treat the just-merged PR as a layer transition (stop watcher, re-probe, continue next open non-draft needing work with posture restated) — not a run-level Terminal stop for this babysit invocation.

Raw lines 22 to 32

33## Forbidden on managed stack members

35```bash

36gh pr merge …

37```

39Use `gh stack merge` only. Under `posture:target` and `posture:stack-ready`, print the exact merge command when reporting ready-as-next; do not execute it.

Forbidden on managed stack members

gh pr merge …

Use gh stack merge only. Under posture:target and posture:stack-ready, print the exact merge command when reporting ready-as-next; do not execute it.

Raw lines 33 to 39