---
id: spec-gather-requirements
agent: pm
title: Elicitar e documentar requisitos (spec pipeline — fase 1)
inputs: [pedido informal do stakeholder]
outputs: ['docs/specs/{slug}/requirements.md com FR-*/NFR-*/CON-* rastreáveis']
elicit: true
modes: [interactive]
---

# Elicitar e documentar requisitos (spec pipeline — fase 1)

**Objetivo:** transformar um pedido informal em requisitos estruturados e rastreáveis (FR-*, NFR-*,
CON-*) — a fundação da spec pipeline, antes de qualquer spec formal.

**Pré-condições:**
- Existe um pedido/intenção do stakeholder, ainda que informal. Sem isso, não há o que elicitar.
- O stakeholder está disponível para responder. A elicitação exige interação real — não se pula.

## Passos

1. **Leia o pedido informal e identifique as lacunas.** O que está implícito? O que falta para virar
   requisito testável?
2. **[ELICITAÇÃO] Conduza a entrevista de requisitos.** Pergunte sobre: usuário e dor, comportamento
   esperado, critérios de sucesso, restrições (técnicas, de negócio, de prazo) e o que está **fora** do
   escopo. Pare e espere as respostas reais — não preencha lacuna com suposição.
3. **Estruture cada item com ID rastreável:** `FR-*` (requisitos funcionais), `NFR-*` (não-funcionais:
   performance, segurança, acessibilidade), `CON-*` (restrições). Cada um com enunciado verificável e a
   fonte (quem pediu / por quê).
4. **Marque ambiguidades e premissas em aberto** explicitamente — elas viram pergunta na próxima rodada,
   não viram requisito inventado (No invention, Art. IV).
5. **Salve em `docs/specs/{slug}/requirements.md`.** Este artefato alimenta `spec-write-spec` (fase
   seguinte) e a avaliação de complexidade do @architect.

## Critério de pronto (DoD)

- [ ] Todo requisito tem ID (`FR-*`/`NFR-*`/`CON-*`), enunciado verificável e fonte rastreável
- [ ] Escopo e não-escopo explícitos
- [ ] Ambiguidades/premissas registradas como abertas, não inventadas
- [ ] Elicitação real conduzida com o stakeholder (não presumida)
- [ ] Salvo em `docs/specs/{slug}/requirements.md`

## Falha / recuperação

- **Stakeholder indisponível para a elicitação** → seguro a task; requirements.md com lacunas inventadas
  é pior que adiar. Registro o que falta e aguardo.
- **Pedido exige pesquisa de mercado/viabilidade** → delego ao @analyst antes de fechar os requisitos.
- **Requisito sem fonte clara** → não vira FR; vira pergunta aberta na lista de ambiguidades.