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

# Squidy - Documentação

> Setup inteligente para projetos com Agentes de IA

# 🦑 Squidy

**Setup inteligente para projetos com Agentes de IA**

Governança, Auditoria e Documentação Automática para Claude, GPT-4, Cursor e mais.

<Card title="Comece em 2 minutos" icon="rocket" href="/quickstart" horizontal>
  Instale o Squidy e configure seu primeiro projeto.
</Card>

## O Problema

Você usa **Claude**, **ChatGPT** ou **Cursor** para programar, mas:

* 🤯 A IA esquece tudo na próxima conversa
* 📝 Você reescreve os mesmos requisitos toda semana
* 🎨 O agente fica "criativo" e muda sua arquitetura
* 📂 Seu projeto vira bagunça porque ninguém documenta
* ⏱️ Gasta 30 min configurando prompt antes de codar

**O Squidy resolve isso em 2 minutos.**

## O Que é o Squidy?

O **Squidy** é uma CLI que cria automaticamente a estrutura de governança para projetos com Agentes de IA.

<Columns cols={2}>
  <Card title="Setup com IA" icon="robot" href="/commands/init">
    Converse com IA sobre seu projeto e receba documentação completa.
  </Card>

  <Card title="Auditoria" icon="magnifying-glass" href="/commands/audit">
    Verifique a saúde do projeto e identifique problemas.
  </Card>

  <Card title="Kanban" icon="table-columns" href="/concepts/kanban">
    Gestão de tarefas com Épicos → Tasks → Subtarefas.
  </Card>

  <Card title="Governança" icon="shield-check" href="/concepts/governance">
    Regras, proibições e Definition of Done para sua IA.
  </Card>
</Columns>

## Instalação Rápida

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

<Card title="Veja o guia completo de instalação" icon="download" href="/installation">
  Opções de instalação via pip, pipx ou desenvolvimento.
</Card>

## Estrutura Criada

O Squidy gera uma estrutura completa de governança:

```
meu-projeto/
├── readme-agent.md          # 🤖 Guia completo para o agente
├── .squidy/
│   └── manifest.json        # 📋 Manifesto do projeto
├── doc/
│   ├── AGENT.md             # 🎯 Referência rápida
│   ├── constituicao.md      # ⚖️ Princípios e regras
│   ├── oraculo.md           # 🧙 Decisões de arquitetura
│   ├── politicas.md         # 📋 Stack e convenções
│   ├── kanban.md            # 📊 Gestão de tarefas
│   ├── emergencia.md        # 🚨 Bloqueios críticos
│   ├── indice-diario.md     # 📑 Índice do histórico
│   └── contexto-sessao.md   # 💾 Cache do estado
└── diario/
    └── 2026-02.md           # 📅 Log de decisões
```

## Próximos Passos

<Columns cols={2}>
  <Card title="Quickstart" icon="play" href="/quickstart">
    Configure seu primeiro projeto em minutos.
  </Card>

  <Card title="Comandos" icon="terminal" href="/commands/init">
    Aprenda os comandos principais do Squidy.
  </Card>
</Columns>

***

<Card title="Suporte" icon="headset" href="mailto:contato@squidy.run">
  Precisa de ajuda? Entre em contato.
</Card>