---
title: Empacotamento
description: Como distribuir a camada e manter layout compacto.
context: Release local, layout compact, flat e checklist.
---

# Empacotamento

O layout recomendado para projetos consumidores é `compact`. Ele mantém a raiz pequena e coloca suporte reutilizável em `.sdd/`.

## Layout compacto

```text
AGENTS.md
CLAUDE.md
sdd.config.yaml
.agents/
.claude/
.codex/
.cursor/
.devin/
.opencode/
.trae/
.sdd/
```

## Layout flat

Use `--layout flat` apenas para desenvolvimento da própria camada ou projetos legados que esperam `schemas/`, `templates/`, `adapters/` e `presets/` na raiz.

```bash
sdd install /caminho/do/projeto --preset generic --layout flat
```

## Checklist de release

```bash
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --locked --all-features
cargo build --release
target/release/sdd mcp config --targets all --force
sdd ci --strict-release
sdd maintenance report
```

Use `sdd ci --strict-release --name <slug>` quando a release estiver ligada a uma orquestração específica e você quiser incluir health/diagramas desse ciclo. Em CI ou checkout limpo, gere antes as configs MCP locais para que `clients doctor --strict` valide observabilidade MCP sem versionar arquivos com paths absolutos. Atualize `VERSION`, `Cargo.toml`, `Cargo.lock` e docs afetadas no mesmo ciclo.
