---
title: Instalação
description: Como instalar, inicializar e validar a camada SDD em um projeto.
context: Setup local, presets, layout compacto, doctor e atualização.
---

# Instalação

O projeto principal é um crate Rust com binário `sdd`. O repositório também contém superfícies para agents, clients, plugins, bot Slack e documentação.

## Pré-requisitos

| Ferramenta | Uso |
|---|---|
| Rust toolchain | Compilar e testar o CLI `sdd` |
| Git | Rastreabilidade, last updated do site e diffs de review |
| Node.js | Bot Slack e documentação Fumadocs |
| `rg` | Fallback rápido de code intelligence |

## Instalar o CLI

```bash
cargo install --path .
sdd doctor
sdd clients doctor
```

Para validar o repositório da camada:

```bash
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --locked --all-features
sdd ci --strict-release
```

## Inicializar um projeto consumidor

```bash
cd /caminho/do/projeto
sdd init
sdd doctor
sdd clients doctor
```

O layout padrão é `compact`. A raiz recebe apenas os arquivos que agents e editores precisam descobrir; o suporte reutilizável fica em `.sdd/`.

```text
seu-projeto/
├── AGENTS.md
├── CLAUDE.md
├── sdd.config.yaml
├── .agents/
├── .claude/
├── .codex/
├── .cursor/
├── .devin/
├── .opencode/
├── .trae/
└── .sdd/
```

## Presets

| Preset | Quando usar |
|---|---|
| `generic` | Fallback conservador |
| `frontend-react` | React/TypeScript |
| `backend-node` | APIs Node/TypeScript |
| `hono-api` | Hono e workers |
| `python-api` | FastAPI |
| `rust-api` | APIs Rust |
| `monorepo` | Apps/packages/services |
| `infra` | Terraform, Kubernetes e infraestrutura |

## Atualização

```bash
sdd update
sdd clients doctor
sdd skills doctor --strict
```

`sdd upgrade` é alias de `sdd update`. A atualização preserva `sdd.config.yaml`, artefatos em `docs/<slug>/` e conteúdo humano fora dos blocos gerenciados.
