agent-specDo zero à operação

Especifique antes de codar — transforme ambiguidade em software confiável, com revisão automática em duas camadas e dívida técnica sob controle.

Trilha rápida (~1h)

Prefácio → Capítulo 0 → Parte II (passo a passo) → Apêndice D.
Você sai sabendo operar o básico.

Começar

Leia linear, do Prefácio aos Apêndices.
É o caminho desenhado para aprender de verdade.

Abrir o guia

Após o Capítulo 0, cada capítulo é autocontido.
Use a busca ou a área 🔧 Referência da sidebar.

Ir à referência

Problema	Como o framework resolve
Escolha de ferramenta errada	`/agent-spec-pre-refinement` aplica o Strategy Selector e recomenda TaskCard / miniSpec / SDD / Conversa direta
Contexto perdido entre sessões	Artefatos versionados (`prd.md`, `intent.md`, `taskcard.md`) em `docs/specs/features/`
Qualidade inconsistente	Gates QA + Tech Review rodam automaticamente em cada task; críticos/altos bloqueiam e disparam loop, médios/baixos viram débito anotado
Custo alto de IA	Sonnet por padrão; Opus só em área crítica; memória proativa; `.qa_context.md` pré-extraído

Spec antes de código

Quanto mais cedo a ambiguidade morre, mais barato sai.

Contexto mínimo por subagente

Cada agente recebe só o que precisa para sua etapa.

Modelo mínimo viável

Sonnet por padrão; Opus só onde o custo se paga.

Débito técnico controlado

Bloquear risco real (crítico/alto); anotar dívida de manutenibilidade (médio/baixo).

Prefácio — Como navegar esta documentação — para quem é, o que você vai saber fazer, as três trilhas.
Capítulo 0 — Framework em 5 minutos — o mapa antes do território.
Apêndice D — Quem chama quem — referência rápida.