Produto AI-first
Transformar discovery em uma especificação que a engenharia consegue rastrear
SpecFlow explora como usar IA para reduzir a distância entre anotações de discovery e decisões de produto prontas para execução, preservando contexto, limites e evidências.
Contexto
O problema não era escrever mais uma documentação.
Conversas de discovery reúnem sintomas, hipóteses, restrições e frases que dão sentido ao problema. Quando esse material é resumido sem rastreabilidade, a especificação pode parecer clara e ainda assim perder justamente o contexto que ajudaria a equipe a decidir.
- Preservar as evidências da conversa
- Separar hipótese de requisito
- Deixar explícito o limite do MVP
Pergunta de produto
Como acelerar a síntese sem transformar ambiguidade em requisito?
A direção foi tratar a geração como uma etapa de estruturação assistida. O usuário recebe problema, hipótese, fronteiras, histórias rastreáveis, backlog e riscos em um mesmo artefato que pode ser revisado antes de chegar à execução.
- Gerar uma primeira estrutura útil
- Permitir revisão humana antes do uso
- Manter citações literais recuperáveis
Decisão de arquitetura
A saída da IA precisa ser um contrato, não um bloco de texto.
O produto combina provedores generativos, um contrato JSON validado com Zod, fallback entre integrações e um carregamento por etapas que torna o processo legível. Isso dá à interface uma unidade de trabalho mais próxima de um documento de engenharia do que de uma resposta solta.
- Schema estrito para a especificação
- Fallback entre Gemini e OpenRouter
- Leitor e exportação em Markdown
Avaliação
Grounding é o primeiro teste de utilidade.
O harness verifica se as citações geradas realmente existem no material de entrada, mede completude de escopo e penaliza ambiguidades. Na primeira rodada de validação do formato, o fluxo atingiu 91% de grounding e reduziu em 32% o tempo de revisão da especificação. A avaliação não substitui a decisão de produto, mas evita que uma resposta bem escrita esconda uma conexão fraca com o discovery.
- 91% de grounding nas citações avaliadas
- 32% menos tempo na primeira revisão
- 86% de completude de escopo
Arquitetura conceitual
Da conversa ao contrato executável, com rastreabilidade em cada etapa.
O fluxo transforma sinais de discovery em uma especificação validada, alterna provedores e verifica grounding antes da entrega.
Discovery
Notas brutas, transcrições e contexto de negócio.
Estrutura
Problema, hipótese, escopo e histórias rastreáveis.
Provedores
Modelos alternáveis com fallback operacional.
Contrato
Saída JSON validada antes de chegar à interface.
Evals
Grounding, completude e sinais de ambiguidade.
Aprendizado em destaque