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

# Linear

> Connect Linear so ADE can link issues, lanes, PRs, CTO context, and follow-up notes.

Linear is optional. Connect it when your planning and review loop already runs through Linear issues.

## What the integration does

<CardGroup cols={2}>
  <Card title="Issue context" icon="clipboard-list">
    Attach Linear issue details to lanes, chats, CTO prompts, and PRs.
  </Card>

  <Card title="Status updates" icon="arrow-right-arrow-left">
    Publish useful progress and closeout notes back to issues.
  </Card>

  <Card title="Delegation" icon="users">
    Ask the CTO to plan or route work from a Linear issue.
  </Card>

  <Card title="Traceability" icon="link">
    Keep the issue, lane, commits, PR, and proof connected.
  </Card>
</CardGroup>

## Connect Linear

<Steps>
  <Step title="Open Settings -> Integrations">
    Choose Linear and start the connection flow.
  </Step>

  <Step title="Authenticate">
    Use OAuth or a token with the required issue access for your workspace.
  </Step>

  <Step title="Choose defaults">
    Select the workspace/team ADE should use when creating or linking work.
  </Step>

  <Step title="Test with one issue">
    Link an issue to a lane and verify it appears in the lane and CTO context.
  </Step>
</Steps>

## Good CTO prompts with Linear

```text theme={null}
Read ENG-142 and propose a lane plan with acceptance criteria.
```

```text theme={null}
Summarize what changed on the PR linked to ENG-142 and draft a Linear update.
```

```text theme={null}
Which Linear issues are blocked by current PR or CI state?
```

<Note>
  ADE uses the permissions granted to your Linear connection. If issue updates fail, reconnect Linear or check the token scopes.
</Note>