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

| Comando | Uso |
|---|---|
| `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 health --json` | Consolida readiness, doctors, intelligence e quality |
| `sdd ci --strict-release` | Roda o gate de release do pacote |
| `sdd ci --strict-release --dry-run --json` | Mostra a matriz do gate sem rodar checks caros |
| `sdd maintenance report` | Mostra saúde rápida por área |

## Fluxo

| Comando | Stage |
|---|---|
| `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

| Comando | Uso |
|---|---|
| `sdd artifact init|save|status` | Persistência local de artefatos |
| `sdd artifact link` | Registra ponteiros externos no traceability map |
| `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 |
| `sdd health --strict` | Gate read-only que falha também em status `warn` |

## Extensibilidade

| Comando | Uso |
|---|---|
| `sdd clients list|doctor|sync` | Superfícies por editor/client |
| `sdd capabilities list|doctor|sync|recommend` | Catálogo de capabilities por target |
| `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|doctor` | MCP read-only |
| `sdd acp serve|doctor|config` | Agent Client Protocol v1 |
| `sdd context build|recommend|materialize` | Context packs e blocos gerenciados |
| `sdd context build --metadata-only` | Handoff curto sem conteúdo longo |
| `sdd intelligence learn|status|health|repair` | Índices derivados e reparo de memória operacional |
| `sdd optimize status|compress` | Wrappers opcionais de contexto |
| `sdd diagram attach|doctor` | Companions visuais para IDEA/PRD/Tech Spec |
| `sdd demand enqueue|list|status|approve|reject` | Fila de demandas do motor autônomo |
| `sdd auto tick|run|status` | Motor auditável de execução do fluxo |
