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

# Project setup

> What ADE checks when you open a repository for the first time.

Project setup is a convenience flow, not a gate. You can skip any step and configure it later in **Settings**.

## Setup checklist

<Steps>
  <Step title="Developer tools">
    ADE checks for Git and other useful local tools. Git is the important one because lanes use worktrees.
  </Step>

  <Step title="AI providers">
    Connect or verify at least one provider so chats and workers can run.
  </Step>

  <Step title="GitHub">
    Optional, but recommended if you want PR creation, CI status, review comments, and merge workflows inside ADE.
  </Step>

  <Step title="Linear">
    Optional. Connect Linear if you want issues linked to lanes, PRs, CTO planning, and follow-up notes.
  </Step>

  <Step title="Project preferences">
    Review project name, default branch, lane defaults, and any suggested process or test commands.
  </Step>
</Steps>

## Where settings live

Most configuration is local to your machine. Provider credentials and secrets stay out of Git. Project-specific defaults can be shared deliberately, but ADE keeps local runtime state under `.ade/`.

<CardGroup cols={2}>
  <Card title="Settings overview" icon="sliders" href="/configuration/settings">
    See the main settings sections.
  </Card>

  <Card title="Configuration overview" icon="folder-tree" href="/configuration/overview">
    Understand local project state and shared defaults.
  </Card>
</CardGroup>