Stacked Diffs Workflow

Implement stacked diffs workflows for breaking large code changes into reviewable PRs.

4|1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/doanchienthangdev/omgkit --skill stacked-diffs-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Stacked Diffs Workflow
Source: https://github.com/doanchienthangdev/omgkit/tree/main/plugin/skills/methodology/stacked-diffs
Command: npx skills add https://github.com/doanchienthangdev/omgkit --skill stacked-diffs-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill tackles the challenge of managing large, complex code changes by breaking them down into smaller, more manageable, and reviewable units, significantly improving the code review process.

Core Features & Use Cases

  • Stacked PRs: Create a chain of dependent Pull Requests, each building on the previous one.
  • Parallel Review: Enables reviewers to examine multiple related changes simultaneously.
  • Efficient Updates: Facilitates easy modification of any commit within the stack.
  • Use Case: When developing a major new feature that touches multiple parts of the codebase, use this Skill to create a series of small, focused PRs (e.g., data model changes, API endpoints, UI components, tests) that can be reviewed and merged independently in order.

Quick Start

Use the stacked diffs skill to create a new branch for the first step of a feature stack.

Frequently Asked Questions about Stacked Diffs Workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break down large code changes into smaller, reviewable pull requests?

Stacked diffs break down large code changes into smaller, reviewable chunks by creating a chain of dependent pull requests. This allows reviewers to examine multiple related changes simultaneously, reducing context switching.

What is the stacked diffs workflow for managing dependent Git branches?

The stacked diffs workflow manages dependent Git branches by creating a series of small, focused pull requests that build on each other. It enables parallel code review, faster iteration, and a cleaner Git history.

How do I update a commit in the middle of a stacked PR chain?

Updating a commit within a stacked PR chain is facilitated by stacked diffs tools, allowing efficient modification of any commit. This ensures dependent branches remain intact while changes propagate cleanly through the stack.

Does the stacked diffs workflow work with Graphite, ghstack, and git-branchless?

The stacked diffs workflow supports tools like Graphite, ghstack, git-branchless, and Sapling for managing dependent branches and PRs. These tools facilitate creating the chain of dependent pull requests.

When should I use stacked PRs instead of a single large pull request for feature development?

Use stacked PRs when developing a major new feature that touches multiple parts of the codebase, such as data model changes, API endpoints, and UI components. It allows these focused changes to be reviewed and merged independently in order.

Why use stacked diffs for code review instead of standard branching strategies?

Stacked diffs improve code review by breaking large changes into smaller, manageable units, enabling parallel review and faster iteration. This significantly reduces the context switching required for reviewers compared to standard branching strategies.