---
title: CLI
description: Mapa operacional dos comandos `sdd`.
context: Comandos de setup, fluxo, artifact store, providers, qualidade e automação.
---
# CLI
O binário `sdd` é a fonte das regras determinísticas locais. Agents podem escrever texto e tomar decisões assistidas, mas devem chamar o CLI para estado, validação, artifact store, skills, workflows e guardrails.
## Setup e saúde
| `sdd init` | Instala a camada no projeto atual |
| `sdd init "<nome>"` | Cria artifact store de orquestração |
| `sdd install <path>` | Instala em outro projeto |
| `sdd update` | Atualiza arquivos gerenciados |
| `sdd doctor` | Valida instalação base |
| `sdd ci` | Roda validações do pacote |
## Fluxo
| `sdd discover` | Project Discovery |
| `sdd risk` | Risk Classification |
| `sdd idea` | Ideia |
| `sdd prd` | PRD |
| `sdd techspec` | Tech Spec |
| `sdd tasks` | Tasks |
| `sdd refinement` | Refinement |
| `sdd execution` | Execution |
| `sdd adr` | ADR |
| `sdd review` | Review |
| `sdd memory` | Memory |
| `sdd orchestration` | Fluxo completo |
## Governança
| `sdd artifact init|save|status` | Persistência local de artefatos |
| `sdd validate-artifact` | Validação isolada por schema |
| `sdd eval stage|orchestration` | Avaliação determinística contextual |
| `sdd quality report` | Relatório agregado de prontidão |
| `sdd trace list|show|summary|doctor` | Auditoria de eventos |
## Extensibilidade
| `sdd clients list|doctor|sync` | Superfícies por editor/client |
| `sdd skills list|doctor|sync|recommend|validate` | Catálogo híbrido de skills |
| `sdd workflow list|validate|run|status` | DSL de workflows |
| `sdd providers list|doctor` | Provider/model/effort/auth |
| `sdd mcp serve|config` | MCP read-only |
| `sdd context build|recommend|materialize` | Context packs e blocos gerenciados |
| `sdd intelligence learn|status|health` | Índices derivados |
| `sdd optimize status|compress` | Wrappers opcionais de contexto |