interview
interview escopa uma feature ou problema perguntando — uma pergunta por vez —
até você e o agente de fato compartilharem o mesmo quadro. É o intake greenfield:
sem plano existente, sem docs assumidos, só uma conversa que percorre a árvore de
decisão até a intenção ficar concreta o bastante pra construir em cima.
O que resolve
A maior parte do trabalho mal-especificado não é mal-especificado de propósito —
as lacunas são simplesmente invisíveis até alguém perguntar. Um muro de perguntas
de uma vez é lido por cima e respondido pela metade; um “construa X” vago vira o
agente chutando os requisitos e você descobrindo o chute errado no review.
interview tira o chute tornando os desconhecidos explícitos, uma decisão por
vez, antes de qualquer código ou spec.
Como resolve
- Uma pergunta por vez — cada resposta estreita a próxima pergunta, então a conversa percorre a árvore de decisão em vez de despejar um checklist.
- Sem dependência de documento — não precisa de
CONTEXT.mdou ADRs; funciona do zero, o que o torna a ferramenta greenfield. - Resumo confirmado — termina com um resumo que você aprova, que vira entrada
limpa pro próximo passo:
doc-prdpra publicar,doc-alignpra testar contra docs existentes, ouimplementpra construir.
Fica ao lado de dois irmãos: doc-align é a contraparte pra um plano existente
(validado contra os docs do projeto), e doc-research explora uma área inteira
e produz vários itens de backlog, onde interview escopa um só.
Quando usar
No início de uma feature ou problema que ainda não está concreto — antes de
escrever spec, PRD ou código. Quando o plano já existe e precisa ser checado
contra as decisões do projeto, use doc-align.