stacked-prs
Installation
SKILL.md
Stacked PRs
Build, publish, synchronize, validate, merge, and clean up stacked pull requests without corrupting branch topology.
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.
Reference Files
| File | Contents | Load When |
|---|---|---|
references/stack-model.md |
Stack inference, explicit ordering, and .stack-prs.yaml rules |
Inspecting, publishing, validating, or cleaning a stack |
references/provider-adapters.md |
Provider adapter contract and GitHub gh commands |
Creating, retargeting, checking, merging, or deleting PRs |
references/sync-algorithm.md |
Rebase and force-with-lease synchronization workflow | Syncing a stack after a parent or base moves |
references/merge-discipline.md |
Bottom-up merge and branch cleanup rules | Merging or closing out a stack |
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 merging any stack |