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