---
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

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`.
