stacked-prs
Installation
SKILL.md
Stacked PRs
Build, publish, synchronize and validate stacked pull requests without corrupting branch topology, and decide the topology, provenance and native membership that landing an existing stack depends on.
The package identity is provider-neutral. Git is the source of truth for branch ancestry; provider PR metadata is the source of truth for review bases. GitHub through gh is the first documented provider adapter.
Landing, post-landing promotion and retargeting, and cleanup of an existing manual or GitHub-native stack have one executable owner: the ship-workflow skill's stack graph run. This skill authors its explicit stack decision packet and delegates to it once (§5); it has no hand-run landing or cleanup procedure of its own.
Reference Files
| File | Contents | Load When |
|---|---|---|
references/stack-model.md |
Stack inference, explicit ordering, native detection and the explicit stack decision packet | Inspecting, publishing, validating, or delegating a stack |
references/provider-adapters.md |
Provider adapter contract and GitHub gh commands for listing, creating, retargeting and checking PRs |
Creating, retargeting or checking PRs |
references/sync-algorithm.md |
Slice proof, expected-old leases and the standalone restack procedure | Syncing a stack after a parent or base moves |
references/merge-discipline.md |
Parent-first landing rules, landing proofs, retention and endpoints the delegated run enforces | Deciding what to select and what an outcome means |
references/metadata-format.md |
Optional metadata schema and validation rules | .stack-prs.yaml exists or inference is ambiguous |
references/provenance.md |
Commit-trailer stack identity, stamping, verification, merge-mode coupling | Creating, splitting, syncing, or choosing a merge method |
references/github-native.md |
Native detection, linking eligibility, native sync and the native prefix policy | A GitHub-native stack is requested or detected |