> ## 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.

# Create and manage lanes

> Create lanes from a branch or another lane, then rename, archive, or delete them when the work is done.

Create a lane whenever a task deserves its own branch and review path.

## Create a lane

<Steps>
  <Step title="Open Lanes">
    Click **New lane** from the Lanes view.
  </Step>

  <Step title="Name the task">
    Use a short outcome name like `fix-auth-redirect` or `add-health-endpoint`.
  </Step>

  <Step title="Choose the source">
    Start from the primary branch, an existing branch, or another lane when creating stacked work.
  </Step>

  <Step title="Create">
    ADE creates the worktree and shows the lane in the list.
  </Step>
</Steps>

## Attach an existing worktree

If you already created a Git worktree outside ADE, attach it from the lane actions. ADE tracks the lane but does not move the directory.

## Rename, archive, or delete

| Action  | Use it when                                                                               |
| ------- | ----------------------------------------------------------------------------------------- |
| Rename  | The task name is unclear. This changes ADE metadata, not necessarily the Git branch name. |
| Archive | The work may be useful later but should leave the active list.                            |
| Delete  | The worktree is no longer needed. Commit or stash anything important first.               |

<Warning>
  Deleting a managed worktree can remove uncommitted changes. ADE warns before destructive cleanup, but review the lane status first.
</Warning>

## Good cleanup habits

* Archive stalled experiments instead of keeping every lane active.
* Delete lanes after their PRs merge and follow-up work is complete.
* Keep lane names tied to outcomes, not model names.
* Use History if you need to find what happened in a deleted or archived lane.