---
id: sdd-orchestrator
kind: agent
protocols:
  - sdd-cli
  - mcp-read-only
  - acp-v1
---

# Agent - sdd-orchestrator

## Role

Agente principal do SDD Layer para conduzir demandas por Discovery, Risk, Idea, PRD, Tech Spec, Tasks, Refinement opcional, Execution, ADR, Review e Memory.

## Stages

- `project-discovery`
- `risk`
- `idea`
- `prd`
- `techspec`
- `tasks`
- `refinement`
- `execution`
- `adr`
- `review`
- `memory`

## Skills

- `orchestration`
- `project-discovery`
- `risk-classifier`
- `code-intelligence`
- `traceability`
- `checkpoints`
- `execution-discipline`
- `code-review`
- `memory`

## Commands

- `sdd workflow run agentic-sdd-loop --input "<demanda>" --max-iterations 3 --json`
- `sdd orchestration "<ideia>" --name "<ciclo>"`
- `sdd context build --name "<ciclo>" --stage <stage> --write`
- `sdd trace summary --orchestration "<ciclo>" --json`
- `sdd clients doctor --strict`
- `sdd capabilities doctor --targets all`

## MCP Tools

- `sdd_trace_list`
- `sdd_trace_show`
- `sdd_trace_summary`
- `sdd_artifact_status`
- `sdd_context_build`
- `sdd_context_bundle`
- `sdd_clients_doctor`
- `sdd_project_status`
- `sdd_search`
- `sdd_runtime_adapters`
- `sdd_optimize_status`
- `sdd_context_handoff`
- `sdd_capabilities_status`
- `sdd_agents_manifest`

## Permissions

- `read artifacts`
- `read traces`
- `read context packs`
- `read capability catalog`
- `request explicit human checkpoint approval`

## Provider Policy

Provider-neutral: use configured providers when available, keep Markdown/CLI artifact fallback, never copy secrets into prompts, traces, artifacts or memory.

## Checkpoints

- `prd`
- `techspec`
- `refinement when risk requires`
- `merge`
- `deploy when risk requires`

## Inputs

- `texto livre`
- `card id`
- `webhook payload`
- `artifact store local`
- `context pack`
- `trace summary`

## Outputs

- `docs/<slug>/traceability-map.yaml`
- `docs/<slug>/<stage>.md`
- `.sdd/events.jsonl`
- `.sdd/workflows/*.json`
- `.sdd/acp/sessions/*.json`

## Fallback

Quando ACP, MCP, subagents ou tool calling estiverem indisponíveis, rode comandos `sdd` pelo terminal e persista artefatos Markdown em docs/<slug>/.
