---
id: create-deep-research-prompt
agent: architect
title: Gerar prompt de pesquisa profunda sobre tecnologia/padrão
inputs: [tópico de pesquisa, contexto do projeto]
outputs: [prompt de pesquisa estruturado]
elicit: true
modes: [interactive]
---

# Gerar prompt de pesquisa profunda sobre tecnologia/padrão

**Objetivo:** transformar uma dúvida arquitetural (qual tecnologia, qual padrão, qual trade-off) num
prompt de pesquisa profunda bem delimitado — com perguntas, critérios de avaliação e restrições do
projeto — para que a pesquisa volte com decisão, não com um passeio genérico pela internet.

**Pré-condições:**
- Existe um tópico que rastreia a uma decisão de arquitetura real do projeto (uma escolha de stack,
  um padrão, uma comparação). Sem isso, **pare** e elicite — não pesquiso curiosidade, pesquiso
  decisão.
- Há contexto do projeto disponível (NFRs, restrições). Se faltar, elicito antes — pesquisa sem
  restrição produz resposta que não cabe no projeto.

## Passos

1. **Delimite a decisão por trás do tópico.** Que escolha arquitetural essa pesquisa precisa
   sustentar? "React vs Svelte" não é a pergunta; "qual framework de UI minimiza custo de
   manutenção para um time de 3 com esta escala-alvo" é. **Elicito** essa precisão com o usuário.
2. **Liste as restrições do projeto** que a pesquisa deve respeitar: NFRs (escala, latência,
   disponibilidade), orçamento, stack atual, capacidade do time, prazo. A resposta tem que caber
   nelas — tecnologia chata por padrão, empolgante só onde o problema exige.
3. **Formule as perguntas de pesquisa**, da mais decisiva para a periférica. Cada pergunta deve
   produzir um achado acionável: maturidade, custo de operação, curva de aprendizado, riscos de
   escala, comunidade/suporte, fit com o stack atual.
4. **Defina os critérios de avaliação** com que as opções serão comparadas — e o teste do 10× entre
   eles: o que quebra com cada opção quando o sistema escalar. Sem critério explícito, a pesquisa
   vira coleção de opiniões.
5. **Monte o prompt estruturado**: contexto + restrições + perguntas + critérios + formato de saída
   esperado (tabela comparativa, recomendação com rastro). Valido com o usuário antes de fechar —
   esse é o ponto de elicitação sagrado.
6. **Entregue o prompt ao executor de pesquisa** (@analyst, ou a ferramenta de pesquisa configurada
   via `nexus run`). O achado volta como insumo rastreável para `create-doc` / `spec-assess-complexity`
   — e cada decisão de arquitetura que ele sustentar passa a rastrear a esse achado (No Invention).

## Critério de pronto (DoD)

- [ ] A decisão arquitetural por trás do tópico está delimitada e validada com o usuário
- [ ] As restrições do projeto (NFRs, orçamento, stack, time) estão explícitas no prompt
- [ ] As perguntas estão ordenadas por poder de decisão e cada uma pede um achado acionável
- [ ] Os critérios de avaliação e o teste do 10× entre opções estão definidos
- [ ] O formato de saída esperado está especificado; o prompt foi validado antes de entregar

## Falha / recuperação

- **O tópico não rastreia a uma decisão real** → paro e elicito a decisão; não gero prompt para
  pesquisa sem dono nem propósito.
- **Faltam restrições do projeto** → elicito antes de montar o prompt; uma pesquisa sem restrição
  devolve uma recomendação que não cabe e gera retrabalho.
- **O ponto de elicitação seria pulado em modo não-interativo** → recuso: `elicit: true` exige a
  validação real do usuário sobre as perguntas e critérios.
- **A pesquisa volta sem sustentar a decisão** → reformulo as perguntas e re-disparo; não fecho uma
  decisão de arquitetura sobre um achado que não responde o que importava.