---
description: Prepara e conduz a etapa Tech Spec da pipeline SDD.
argument-hint: "<PRD ou referência>"
allowed-tools: [Bash, Read, Glob, Grep, Write]
---
# SDD Tech Spec
Antes do rascunho, use `grill-with-docs` para Context Harvest e grill técnico ancorado no codebase, PRD, ADRs e Context Pack. Feche somente decisões técnicas novas; faça uma pergunta de alto impacto por vez, com recomendação. Um bypass explícito, incluindo `--unattended`, registra suposições, riscos, fontes ausentes e perguntas abertas.
Rode:
```bash
sdd techspec "$ARGUMENTS"
```
Depois use o subagent `techspec`, ancorando arquitetura, contratos, dados, segurança, performance, observabilidade e testes no codebase real.
Inclua `## Diagramas` na Tech Spec. Use Mermaid para arquitetura, sequence de chamada crítica, state machine, data flow, dependências ou contratos com nomes reais confirmados no codebase. Se houver impacto de design/experiência, acione `information-architecture`, `design-tokens` e `artifact-diagrams`. A Tech Spec deve mapear IA, componentes, estados, tokens, acessibilidade e contratos. Use Excalidraw em `docs/<slug-da-orquestracao>/assets/` quando o planejamento do fluxo, arquitetura ou estados precisar de canvas editável. Use `diagram-design` para companion HTML/SVG em `docs/<slug-da-orquestracao>/assets/diagrams/` somente quando pedido ou configurado; anexe com `sdd diagram attach`.
Pare no checkpoint humano antes de Tasks. Salve com `sdd artifact save "<nome>" techspec --file <arquivo> --state approved`.