---
title: Mapa de comandos
description: Referência dos comandos principais, sincronizada com o contrato Clap do CLI.
context: Consulta rápida para operadores e agents.
---

# Mapa de comandos

Esta página é gerada por `npm run docs:generate` a partir dos enums Clap em `src/main.rs`. Edite a fonte do CLI ou o script de geração quando um comando mudar.

| Grupo | Comandos |
|---|---|
| Setup e saúde | `init`, `install`, `update`, `doctor`, `health`, `ci` |
| Clients | `clients list`, `clients doctor`, `clients sync` |
| Capabilities | `capabilities list`, `capabilities doctor`, `capabilities sync`, `capabilities recommend` |
| Skills | `skills list`, `skills doctor`, `skills sync`, `skills recommend`, `skills validate` |
| Workflow | `workflow list`, `workflow validate`, `workflow run`, `workflow status` |
| MCP e ACP | `mcp serve`, `mcp config`, `mcp doctor`, `acp serve`, `acp doctor`, `acp config` |
| Trace e contexto | `trace list`, `trace show`, `trace summary`, `trace doctor`, `context build`, `context recommend`, `context materialize`, `context build --metadata-only` |
| Manutenção | `maintenance report` |
| Providers | `providers list`, `providers doctor` |
| Stages | `discover`, `risk`, `idea`, `prd`, `techspec`, `tasks`, `refinement`, `execution`, `adr`, `review`, `memory`, `resolve-input`, `orchestration` |
| Artifact store | `artifact init`, `artifact save`, `artifact status`, `artifact link`, `validate-artifact` |
| Avaliação e qualidade | `eval stage`, `eval orchestration`, `quality report` |
| Intelligence e otimização | `intelligence learn`, `intelligence status`, `intelligence health`, `intelligence repair`, `optimize status`, `optimize compress` |
| Diagramas | `diagram attach`, `diagram doctor` |
| Automação | `demand enqueue`, `demand list`, `demand status`, `demand approve`, `demand reject`, `auto tick`, `auto run`, `auto status`, `hook`, `worktree`, `bot`, `tui` |

## Comandos frequentes

```bash
sdd doctor
sdd clients doctor --strict
sdd skills doctor --strict
sdd workflow validate standard-sdd --json
sdd init "minha-orquestracao"
sdd orchestration "minha ideia"
sdd quality report --name "minha-orquestracao" --json
```

## Como aprofundar

Use `sdd <comando> --help` para opções completas. Para subcomandos, use `sdd <grupo> <subcomando> --help`.

## Manutenção

```bash
cd docs-site
npm run docs:generate -- --check
```

Se o check falhar, rode `npm run docs:generate -- --write`, revise o diff e confirme que a página ainda ensina o fluxo correto.
