# Empacotamento e layout limpo
O modo recomendado para projetos existentes é o layout `compact`.
## Raiz mínima
Ficam na raiz somente arquivos que Claude/Codex precisam descobrir ou que pertencem ao projeto:
```text
AGENTS.md
CLAUDE.md
sdd.config.yaml
.agents/
.claude/
.codex/
docs/<orquestracao>/ # artefatos gerados por feature
.github/workflows/... # opcional, somente com --with-ci
```
## Pacote reutilizável
Todo suporte da camada fica isolado em:
```text
.sdd/
├── adapters/
├── docs/
├── examples/ # opcional, somente com --with-examples
├── presets/
├── schemas/
├── templates/
├── tests/ # opcional, somente com --with-ci
├── VERSION
├── CHANGELOG.md
└── sdd.config.example.yaml
```
## CLI
Use a CLI instalada:
```bash
sdd init
sdd doctor
sdd init "minha-orquestracao"
sdd validate-artifact prd docs/minha-orquestracao/02-prd.md
sdd risk "alterar login com permissões"
sdd ci
```
## Instalação
```bash
sdd init --root /caminho/do/projeto
sdd install /caminho/do/projeto --preset generic
```
Para layout antigo:
```bash
sdd install /caminho/do/projeto --preset generic --layout flat
```
Use `flat` apenas quando um projeto já depender de `schemas/`, `templates/`, `adapters/` ou `presets/` na raiz.