> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-ade-im-seeing-error-messag-eright-58df792e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lane Context

> How ADE scopes context to a lane — lane and session state plus selected artifacts — while agents inspect the repository directly for product and architecture knowledge.

## How lane context works

ADE keeps the context it injects local to the work being done. When an agent starts in a lane, it receives:

* **Lane and session state** — the lane's branch, base, intent (as you have set it), and the current session's metadata.
* **Selected artifacts** — any artifacts you have attached to the session, plus worker run details when the session belongs to a worker run.
* **Explicit instructions** — the prompt you send and any standing instructions for the lane.

ADE does **not** auto-generate or auto-inject PRD, architecture, or "project context" summaries. When an agent needs product or architecture knowledge, it inspects the repository directly — reading the actual files, history, and configuration — rather than relying on a generated summary that can drift out of date.

<Note>
  This is a deliberate design choice. Generated summaries go stale the moment the code changes; direct repo inspection is always current. ADE injects the minimum lane/session context an agent needs to orient, and trusts the agent to read the repo for everything else.
</Note>

***

## Editing the lane intent

The lane intent is a short statement of what the lane exists to accomplish. ADE derives an initial intent from the branch name and early commits; refine it to be specific — a precise intent meaningfully improves agent behavior.

Weak: `Fix auth`

Strong: `Add a refresh token endpoint (POST /auth/refresh) that validates, rotates, and returns a new access/refresh token pair. The login endpoint must also return a refresh token.`

Edit the intent in the right inspector. The intent is also used to pre-fill PR titles and descriptions.

***

## Audit and replay artifacts

ADE stores a small set of compatibility artifacts under `.ade/artifacts/packs/` for audit and replay. These are records of what happened — they are not automatically prepended to all agent prompts as ambient context, but specific packs are explicitly provided to the relevant agent when needed (for example, the Conflict Pack is handed to the resolver agent when resolving a merge conflict):

| Artifact            | Purpose                                                                                                                                                                                           |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Conflict Pack**   | Resolution context created when a conflict is detected between two lanes — the conflicting file regions, each lane's intent, and suggested resolution strategies. Provided to the resolver agent. |
| **Plan Pack**       | A versioned coding plan generated during a Worker run's Planning phase — the goal, steps, assumptions, risks, and executor assignments.                                                           |
| **Worker run Pack** | A deterministic snapshot of a worker run at a point in time — plan, completed steps, artifacts, interventions, and cost — used for resume, audit, and replay.                                     |

These files are plain Markdown / JSON. You can read them in any editor, diff them across versions, or use them outside ADE.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Lane Overview" icon="code-branch" href="/lanes/overview">
    Learn how lanes isolate work, state, branches, and agent sessions.
  </Card>

  <Card title="Agent Context" icon="database" href="/chat/context">
    Understand how agents manage context windows and inspect repo context.
  </Card>
</CardGroup>