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