# Stacked Prs

> Manage stacked PRs with proper visualization, merge-based updates, and iterative CodeRabbit feedback cycles

- Skill: `majiayu000/stacked-prs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/stacked-prs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/stacked-prs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/stacked-prs

---


# Stacked PRs Workflow

Workflows for managing stacked (dependent) pull requests with proper visualization, merge-based updates, and iterative CodeRabbit review cycles.

## Core Principles

1. **No Force Pushes** - Always use merge commits, never rebase/force-push
2. **Draft First** - PRs start as drafts until CI passes and CodeRabbit approves
3. **Bottom-Up Processing** - Address feedback from lowest PR in stack first
4. **Comprehensive Reviews** - Address all CodeRabbit comments including nitpicks
5. **Visual Stack** - Use PR titles and descriptions to show stack relationships

## Skill Contents

### Sections

- [Core Principles](#core-principles) (L25-L32)
- [Workflow Overview](#workflow-overview) (L61-L69)
- [Quick Reference](#quick-reference) (L70-L100)
- [Scripts](#scripts) (L101-L106)
- [References](#references) (L107-L116)
- [Key Requirement: CodeRabbit Approval](#key-requirement-coderabbit-approval) (L117-L127)
- [Programmatic Automation](#programmatic-automation) (L128-L152)
- [Skill Dependencies](#skill-dependencies) (L153-L159)
- [Related](#related) (L160-L163)

### Available Resources

**📚 references/** - Detailed documentation
- [automation patterns](references/automation-patterns.md)
- [merge workflow](references/merge-workflow.md)
- [pr formatting](references/pr-formatting.md)
- [readiness checklist](references/readiness-checklist.md)
- [review cycles](references/review-cycles.md)

**🔧 scripts/** - Automation scripts
- [check stack status](scripts/check-stack-status.ts)

---

## Workflow Overview

| Phase | Description | Reference |
|-------|-------------|-----------|
| **Creation** | Create stacked PRs with proper titles and descriptions | `references/pr-formatting.md` |
| **Updates** | Merge changes through the stack (no rebasing) | `references/merge-workflow.md` |
| **Reviews** | Process CodeRabbit feedback in cycles | `references/review-cycles.md` |
| **Readiness** | Mark ready only after CI + CodeRabbit approval | `references/readiness-checklist.md` |

## Quick Reference

### PR Title Format

```text
[JIRA-KEY] type(scope): description (PR N/M)
```

### Stack Visualization (in PR Description)

```markdown
## PR Stack

| # | PR | Title | Status |
|---|-----|-------|--------|
| 1 | #78 | PNPM migration | Merged |
| 2 | **#79** | Shell to JS | This PR |
| 3 | #80 | Skills content | Depends on #79 |
| 4 | #81 | Validation & CI | Depends on #80 |
```

### Merge Flow (Not Rebase)

```bash
# After fixing issues in PR #79
git checkout feat/pr-80-branch
git merge feat/pr-79-branch --no-edit
git push origin feat/pr-80-branch
# Repeat for subsequent PRs in stack
```

## Scripts

| Script | Purpose |
|--------|---------|
| `scripts/check-stack-status.ts` | Check CI and CodeRabbit status for all PRs in stack |

## References

| Reference | Content |
|-----------|---------|
| `references/pr-formatting.md` | PR title and description templates |
| `references/merge-workflow.md` | How to propagate changes through the stack |
| `references/review-cycles.md` | Processing CodeRabbit feedback iteratively |
| `references/readiness-checklist.md` | When to mark PRs ready for review |
| `references/automation-patterns.md` | Polling loops, callbacks, and autonomous operation |

## Key Requirement: CodeRabbit Approval

PRs should only be marked "Ready for Review" when:

1. All CI checks pass
2. All CodeRabbit comments addressed (including nitpicks)
3. CodeRabbit has approved (happens automatically after addressing feedback)
4. All previous PRs in the stack are merged

**Important**: Do NOT explicitly request CodeRabbit approval. It approves automatically after you've addressed all its comments and pushed fixes.

## Programmatic Automation

For autonomous AI agents, use polling loops to monitor status:

```typescript
async function waitForPRReady(prNumber: number, repo: string, maxAttempts = 30, intervalMs = 60000) {
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    const status = await checkPRStatus(prNumber, repo);

    if (status.ciPassed && status.coderabbitApproved && status.openComments === 0) {
      return { ready: true, status };
    }

    console.log(`Attempt ${attempt}/${maxAttempts}: CI=${status.ciPassed}, CR=${status.coderabbitApproved}, Comments=${status.openComments}`);

    if (attempt < maxAttempts) {
      await sleep(intervalMs);
    }
  }
  return { ready: false, reason: 'timeout' };
}
```

See `references/automation-patterns.md` for complete polling implementations.

## Skill Dependencies

| Skill | Purpose |
|-------|---------|
| `coderabbit-workflow` | Thread replies, comment export, local CLI reviews |
| `pr-workflow` | Base PR management patterns |

## Related

- [coderabbit-workflow](.claude/skills/coderabbit-workflow/SKILL.md) - Detailed CodeRabbit workflow patterns
- [pr-workflow](.claude/skills/pr-workflow/SKILL.md) - GitHub CLI commands for PR management
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY -->
<!-- Source: bitsoex/ai-code-instructions → global/skills/stacked-prs/SKILL.md -->
<!-- To modify, edit the source file and run the distribution workflow -->