Skip to content

Add the stacked PR management skill - #654

Merged
jamiepine merged 1 commit into
mainfrom
jamiepine/stacked-pr-skill
Aug 18, 2026
Merged

Add the stacked PR management skill#654
jamiepine merged 1 commit into
mainfrom
jamiepine/stacked-pr-skill

Conversation

@jamiepine

Copy link
Copy Markdown
Member

Documents how to manage dependent PRs as a linear stack, so layers get reviewed one diff at a time instead of each higher PR showing everything beneath it.

Covers gh stack for creating, linking, rebasing, restructuring, and merging a stack, plus the manual gh pr fallback for when native stacked PRs aren't available on a repo. It encodes the rules this repo already follows: run just preflight and just gate-pr before pushing, create new PRs as drafts, and treat authorization for one remote action as covering that action only.

Based on main rather than the current worker-registry stack — it's a standalone skill doc with no code dependency, so there's no reason to block it behind five layers.

Documents the linear-stack workflow: the bottom PR targets the trunk and
each PR above targets the branch below it, so every review shows only
that layer's diff.

Covers gh stack for creating, linking, rebasing, restructuring, and
merging a stack, with the manual gh pr fallback for when native stacked
PRs are unavailable. Encodes the repository rules that already apply:
run just preflight and just gate-pr before pushing, create new PRs as
drafts, and treat each remote action as needing its own authorization.
@coderabbitai

coderabbitai Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 21d34726-5e10-4b9f-939a-d4a353540f05

📥 Commits

Reviewing files that changed from the base of the PR and between 34b1647 and 59d3c26.

📒 Files selected for processing (1)
  • .agents/skills/stacked-pr-management/SKILL.md

Walkthrough

Added the stacked-pr-management skill. It documents native GitHub stacked pull-request workflows, manual fallback procedures, failure handling, and handoff requirements.

Changes

Stacked PR Management

Layer / File(s) Summary
Concepts and prerequisites
.agents/skills/stacked-pr-management/SKILL.md
Defines stack invariants, authorization rules, prerequisites, feature checks, and preflight stop conditions.
Stack creation and submission
.agents/skills/stacked-pr-management/SKILL.md
Documents procedures for creating, extending, linking, and submitting stacked pull requests.
Inspection and stack maintenance
.agents/skills/stacked-pr-management/SKILL.md
Documents stack inspection, navigation, cascading rebases, synchronization, restructuring, and dissolution.
Merge, fallback, and handoff procedures
.agents/skills/stacked-pr-management/SKILL.md
Documents merge validation, manual fallback operations, failure handling, and handoff reporting.

Estimated code review effort: 2 (Simple) | ~10 minutes

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch jamiepine/stacked-pr-skill

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@jamiepine
jamiepine marked this pull request as ready for review August 18, 2026 00:55
@jamiepine
jamiepine merged commit ab2c160 into main Aug 18, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant