---
description: Etapa 0 - Project Discovery do fluxo SDD
argument-hint: "[foco opcional]"
model: claude-sonnet-4-6
---

Antes de rodar comandos `sdd`, resolva o CLI uma vez: use `sdd` quando `command -v sdd` encontrar o binário; no checkout fonte `sdd-layer`, use `cargo run --bin sdd --`; se ambos falharem, reporte instalação/PATH ausente com o comando exato que precisa ser reexecutado.

Use a skill ou subagent desta etapa se o client a expuser. Se a skill/subagent não existir ou não carregar, este adapter é o fallback executável: siga as instruções abaixo e delegue estado, persistência e validação ao CLI `sdd`.

Rode `sdd discover $ARGUMENTS` quando houver foco suficiente para preparar o artefato local. Use `sdd discover --json --dry-run` quando precisar de inventário estruturado sem gravar artefato. Depois use o subagent `project-discovery` para analisar o projeto atual antes de rodar a pipeline SDD.

Foco opcional:

$ARGUMENTS

Saída obrigatória:

- Project Discovery no formato de `.sdd/templates/project-discovery.md`, com Markdown canônico e companion HTML visual.
- Inventário técnico detalhado e read-only de manifests, dependências, workspaces, entrypoints reais, componentes, camadas, CI, scripts, testes, docs, migrations, contratos, integrações, infra, env examples e arquivos de agente.
- Linguagem de domínio: `CONTEXT.md`, `CONTEXT-MAP.md` e ADRs quando existirem.
- Code intelligence: status de CodeGraph/Lexa, comandos sugeridos e fallback `rg`.
- Capability map por stage com Taste Skill, Superpowers, Matt Pocock Skills, CodeGraph e Lexa como fontes adaptadas e atribuídas.
- Visualizações para onboarding: Mermaid no Markdown e `00-project-discovery.html` com cards, gráficos de paths/comandos, pipeline SDD e tabelas de stack/capabilities.
- Pendências de `sdd.config.yaml`.
- Comandos verificados, não verificados e ausentes.
- Regras de risco, Refinement, Agent Teams e checkpoints.
- Recomendações de skills/rules por tecnologia via `sdd context recommend`, seções para `AGENTS.md` e deltas específicos para `CLAUDE.md`.
- Materialize Markdown e HTML sempre que não for dry-run: com orquestração nomeada use `docs/<slug-da-orquestracao>/00-project-discovery.md` e `.html`; sem nome explícito, use o fallback `docs/sdd-orchestration/00-project-discovery.md` e `docs/sdd-orchestration/00-project-discovery.html`.
- Para salvar Markdown externo em uma orquestração nomeada, use `sdd artifact save "<nome-da-orquestracao>" project-discovery --file <arquivo> --state recorded`.

Antes de persistir qualquer artefato, garanta que o artifact store exista com `sdd init "<nome-da-orquestracao>"` quando ainda não houver `docs/<slug-da-orquestracao>/traceability-map.yaml`.
