O briefing de quatro frases antes de pedir um aplicativo

Uma tela bonita pode esconder o problema mais caro de um projeto: o aplicativo ficou pronto, mas não resolve uma necessidade real. Isso costuma começar no primeiro pedido, quando a ideia chega ao Claude Code como “faça um app para organizar minha vida”.

Este guia transforma essa ideia solta em quatro frases verificáveis: problema, pessoa, primeira tela e resultado esperado. Elas dão ao agente uma direção concreta sem exigir que você escreva um documento técnico.

Ao terminar, você terá um briefing curto para colar no Claude Code, um jeito de revisar o plano antes das alterações e critérios simples para perceber quando a ideia ainda está vaga.

O modelo copiável

Preencha os quatro campos sem explicar tecnologia, banco de dados ou aparência:

Problema: [o que hoje dá trabalho, demora ou causa erro]
Pessoa: [quem sente esse problema em uma situação concreta]
Primeira tela: [a primeira decisão ou ação que essa pessoa precisa realizar]
Resultado esperado: [o que precisa estar resolvido ao terminar o primeiro uso]

Antes de editar qualquer arquivo:
1. leia o projeto;
2. diga o que ainda está ambíguo;
3. proponha o menor plano que entrega esse resultado;
4. espere minha aprovação.

Um exemplo preenchido:

Problema: pequenos prestadores esquecem quais clientes ainda não pagaram.
Pessoa: eletricista autônomo que atende pelo WhatsApp e anota serviços no celular.
Primeira tela: lista dos serviços, com cliente, valor, vencimento e situação do pagamento.
Resultado esperado: em menos de um minuto, a pessoa identifica quem precisa receber uma cobrança.

Antes de editar qualquer arquivo:
1. leia o projeto;
2. diga o que ainda está ambíguo;
3. proponha o menor plano que entrega esse resultado;
4. espere minha aprovação.

Tutorial: da ideia solta ao primeiro plano

1. Escreva o problema como uma situação observável. Evite “quero melhorar minhas finanças”, porque isso não diz o que está quebrado. Escreva o trabalho que hoje demora, se repete ou termina em erro. No exemplo, o problema não é “controle financeiro”; é esquecer quem ainda não pagou.

   O que você deve ver: uma frase que outra pessoa reconheceria como algo que realmente acontece, sem depender do nome do aplicativo.

2. Escolha uma pessoa em um momento específico. “Empreendedores” inclui gente demais. “Eletricista autônomo que registra serviços pelo celular” permite decidir tamanho de texto, quantidade de campos e ordem das ações sem inventar um público abstrato.

   O que você deve ver: uma pessoa, um contexto de uso e, quando importar, o aparelho onde ela fará a tarefa.

3. Defina somente a primeira tela. Não liste cadastro, painel, relatórios, configurações e integrações de uma vez. A primeira tela deve permitir a ação central do primeiro uso. Se ela não ajuda a resolver o problema declarado, o projeto já começou pelo lugar errado.

   O que você deve ver: uma tela que pode ser descrita por uma ação principal. No exemplo, abrir e identificar cobranças pendentes.

4. Troque “ficar pronto” por um resultado que possa ser conferido. “Aplicativo funcionando” mede o software, não a vida da pessoa. “Identificar em menos de um minuto quem precisa receber cobrança” permite comparar o que foi construído com a promessa inicial.

   O que você deve ver: um resultado com começo e fim claros. Um número só entra quando for uma decisão sua, não uma precisão inventada pela IA.

5. Peça um plano antes das alterações. No Claude Code, você pode iniciar uma sessão em modo de planejamento pelo PowerShell, Terminal do macOS ou Linux:

   claude --permission-mode plan
   

   Cole o briefing depois que a sessão abrir. Nesse modo, o Claude lê o projeto e propõe o caminho sem editar arquivos até você aprovar.

   O que você deve ver: uma proposta de etapas e arquivos afetados, sem mudanças gravadas no projeto.

6. Revise o plano usando as mesmas quatro frases. Para cada etapa, pergunte qual problema ela resolve, para qual pessoa, em qual tela e como aproxima o resultado esperado. Corte banco de dados, login, painel administrativo ou integração que não seja necessária para testar o primeiro uso.

   O que você deve ver: um primeiro ciclo pequeno, que pode ser construído e avaliado sem depender de todas as ideias futuras.

Como saber se o briefing ainda está vago

Leia cada frase e tente imaginar duas soluções completamente diferentes que ainda obedeceriam ao texto. Se isso for fácil, falta uma decisão. “Organizar tarefas” pode virar calendário, quadro ou lista; “mostrar as três cobranças vencidas na abertura” reduz essa ambiguidade.

Não use o briefing para escolher toda a arquitetura. A função dele é dar direção ao primeiro resultado. Decisões técnicas devem aparecer no plano depois que o agente conhecer os arquivos e as restrições do projeto.

Se der erro

O plano volta com “criar dashboard completo”, autenticação e várias integrações. O resultado esperado ainda está grande ou mistura o primeiro uso com o produto inteiro. Reescreva-o para uma única tarefa que possa ser conferida e peça o menor plano que a entregue.

O Claude começa a editar antes de apresentar o plano. Confirme que a sessão foi aberta com claude --permission-mode plan ou alterne para o modo de planejamento com Shift+Tab. Depois repita a última parte do modelo: “proponha o plano e espere minha aprovação”.

A primeira tela tem muitos cartões, menus e gráficos, mas nenhuma ação principal. Volte à frase “Primeira tela” e escreva um verbo único: identificar, registrar, comparar ou enviar. Elementos que não ajudam esse verbo ficam para uma etapa posterior.

Você não consegue dizer se o resultado foi alcançado. Troque palavras como “melhor”, “fácil” e “completo” por uma evidência visível: um item criado, uma pendência identificada ou uma informação encontrada.

Fontes primárias conferidas em 5 de setembro de 2026: fluxos comuns do Claude Code, modos de permissão e boas práticas.