> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-ade-mobile-chat-stability-54bd7ef0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide: stacked PRs

> Create, review, and land a chain of dependent PRs with ADE lanes.

Use stacked PRs when one feature is too large for a single review but each slice depends on the previous slice.

## 1. Create the base lane

Create a lane from `main` for the first slice of work. Commit the foundation there.

## 2. Create child lanes

Select the base lane and create a child lane for the next slice. Repeat only as needed.

```text theme={null}
main
  feature-auth-models
    feature-auth-ui
      feature-auth-tests
```

## 3. Open PRs

Open PRs from the bottom of the stack upward:

* Base lane targets `main`.
* First child targets the base lane branch.
* Next child targets the first child branch.

ADE keeps this relationship visible in Lanes, Graph, and PRs.

## 4. Review in order

Review the base PR first. Child PRs will be easier to understand once the parent is approved.

## 5. Land the stack

<Steps>
  <Step title="Merge the base PR">
    Land the first PR into `main`.
  </Step>

  <Step title="Update the child">
    Rebase or retarget the next PR so it now builds on `main`.
  </Step>

  <Step title="Repeat">
    Continue up the stack until all slices are merged.
  </Step>
</Steps>

## Tips

* Keep each PR small enough to review independently.
* Avoid deep stacks unless the dependency is real.
* Use Graph to see the chain.
* Run tests again after rebasing a child.
* If a child becomes independent, split it into a sibling lane.

<CardGroup cols={2}>
  <Card title="Stacked lanes" icon="layer-group" href="/lanes/stacks">
    Understand the lane model.
  </Card>

  <Card title="Pull requests" icon="code-pull-request" href="/tools/pull-requests">
    Review and merge from ADE.
  </Card>
</CardGroup>
