> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squidy.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Configure seu primeiro projeto com Squidy em minutos

# 🚀 Quickstart

Configure seu primeiro projeto com Squidy em 3 passos simples.

## 1. Instalação

```bash theme={null}
pip install squidy
```

Verifique a instalação:

```bash theme={null}
squidy --version
```

## 2. Inicialize seu Projeto

Execute o comando `init` para iniciar o setup interativo:

```bash theme={null}
squidy init
```

O Squidy fará perguntas sobre seu projeto:

```
🦑 Setup com Agente IA

🤖 Agente: Olá! Me conte sobre o projeto que você quer configurar.
           Exemplo: "API REST para delivery com Node e PostgreSQL"
   
Você: API REST para delivery com Node e PostgreSQL

🤖 Agente: Legal! Qual framework frontend você vai usar?
   
Você: React com TypeScript

... (mais 2-3 perguntas contextuais) ...

✅ Configuração gerada com sucesso!
```

## 3. Use com sua IA

Após o setup, instrua seu agente de IA:

> "Acesse `./readme-agent.md` e siga o ritual de onboarding"

Ou para um projeto específico:

```bash theme={null}
squidy init ./meu-novo-projeto
```

## Comandos Úteis

| Comando         | Descrição                |
| --------------- | ------------------------ |
| `squidy init`   | Setup interativo com IA  |
| `squidy audit`  | Audita o projeto atual   |
| `squidy status` | Mostra status do projeto |

## Opções do Init

```bash theme={null}
# Simular sem criar arquivos (dry-run)
squidy init --dry-run

# Setup manual (sem IA)
squidy init --manual

# Especificar diretório
squidy init ./meu-projeto
```

## Próximos Passos

<Card title="Comando Init" icon="terminal" href="/commands/init">
  Detalhes completos do comando de inicialização.
</Card>

<Card title="Conceitos de Governança" icon="shield-check" href="/concepts/governance">
  Entenda como o Squidy estrutura a governança do projeto.
</Card>