# SDD Clients

Este diretorio documenta as superficies nativas geradas por `sdd clients sync`.

## Targets

- `cli`: harness determinístico `sdd`.
- `codex`: `AGENTS.md`, `.codex/config.toml`, `.codex/agents/` e `.agents/skills/`.
- `claude-code`: `.claude/commands/`, `.claude/agents/` e `.claude/skills/`.
- `cursor`: `.cursor/model-routing.yaml`, `.cursor/rules/`, `.cursor/commands/`, `.cursor/agents/` e `.cursor/skills/`.
- `opencode`: `.opencode/commands/` e `.opencode/agents/`.
- `devin`: `.devin/config.json`, `.devin/rules/`, `.devin/agents/`, `.devin/skills/`, `.devin/workflows/`, `AGENTS.md` e `.agents/skills/`.
- `antigravity`: `.agents/rules/` e `.agents/skills/`.
- `trae`: `.trae/commands/`, `.trae/rules/` e `.trae/skills/`.

Use `sdd clients doctor` para validar cobertura e `sdd clients sync --targets all` para gerar ou atualizar as superficies no projeto instalado.

## MCP e traces

- `sdd mcp serve --root .`: expõe artifacts, context packs, traces e doctor de clients via MCP stdio read-only.
- `sdd mcp config --targets all --root .`: gera `.mcp.json`, `.cursor/mcp.json`, regra CodeGraph do Cursor e faz merge das permissões MCP no Claude.
- `sdd trace list --json`: lista eventos normalizados de `.sdd/*.jsonl`.
- `sdd trace show <run_id> --json`: mostra árvore de execução por `run_id`/`parent_run_id`.
- `sdd trace summary --orchestration "<nome>" --json`: resume status, tipos de evento, stages e raízes.
- `sdd trace doctor`: valida parse dos arquivos `.sdd/events.jsonl`, `.sdd/subagents.jsonl`, `.sdd/task-gates.jsonl` e `.sdd/runs.jsonl`.

O MCP não substitui o contrato local: a trilha canônica continua nos JSONL redigidos em `.sdd/`.

## Capabilities

`templates/capability-catalog.yaml` é o contrato v2 para recursos portáveis. Ele descreve cada capability, sua fonte canônica, adapters por client, fallback provider-neutral e validações semânticas.

- `sdd capabilities list`: lista capabilities e adapters.
- `sdd capabilities doctor --targets all`: valida fonte canônica, cobertura por target, drift gerado e checks semânticos.
- `sdd capabilities sync --targets all`: regenera surfaces conhecidas e copia adapters declarados no catálogo.
- `sdd capabilities recommend --root . --write`: materializa recomendações de skills/rules/MCP/hooks para o projeto atual.
- `sdd clients doctor --strict`: executa `clients doctor` e também `capabilities doctor`.

## Resource adoption map

- Codex: `.agents/skills`, `.codex/config.toml`, plugins, hooks, MCP, automations e worktrees.
- Claude Code: skills, commands compatíveis, subagents, hooks, MCP e settings.
- OpenCode: commands, agents/subagents, skills compatíveis com `.agents`, MCP, plugins e permissions.
- Cursor: rules, skills, subagents, MCP, hooks, CLI/cloud agent.
- Devin: `AGENTS.md`, Knowledge, Playbooks, API/schedules e workflows.
- Trae/Antigravity: rules, skills e commands como adapters portáveis.
