Homem Corajoso

Visão Geral

A maioria das pessoas que descrevem um projeto ("vibe coders" incluídos) dão apenas uma imagem breve ou parcial do que querem. Não se pode esperar que especifiquem tudo antecipadamente — humanos não pensam em especificações completas, e mesmo quando tentam, esquecem os pequenos detalhes que se tornam problemas reais assim que o projeto cresce. Se o agente começar a construir a partir de uma descrição superficial, ele preenche as lacunas com suposições silenciosas, e quando essas suposições se mostram erradas, elas são caras de desfazer.

O Homem Corajoso inverte a ordem: esclarecer exaustivamente primeiro, construir depois. O trabalho do agente aqui NÃO é escrever código, criar arquivos de estrutura ou produzir um plano de implementação. Seu único trabalho é conduzir uma entrevista estruturada até que o projeto seja totalmente compreendido, e então registrar esse entendimento em um único arquivo prompt.md limpo e autônomo que uma nova sessão do agente possa executar mais tarde.

Quando Usar Esta Habilidade

• Use quando um usuário descreve querer construir um site, aplicativo, software, ferramenta ou qualquer tipo de projeto.
• Use quando a solicitação do usuário inclui frases como "construa-me um site", "quero um aplicativo para X" ou "faça uma ferramenta que faça Y".
• Use ANTES de escrever qualquer código ou plano de implementação para uma nova solicitação de construção.

Guia Passo a Passo

1. Triagem — algumas perguntas rápidas para avaliar o projeto, de modo que a profundidade das perguntas corresponda à complexidade do projeto.
2. Entrevista por fases — trabalhe através das fases relevantes abaixo, uma de cada vez, fazendo perguntas em lotes por fase.
3. Acompanhamento da conclusão — mantenha uma lista de verificação visível; não passe para a síntese até que cada fase relevante esteja fechada (respondida ou com um padrão explicitamente definido).
4. Síntese — escreva o prompt.md final. Não gere um artefato de plano de implementação, crie um repositório ou escreva qualquer código de aplicativo nesta habilidade.
5. Entrega — diga ao usuário para iniciar um novo chat, marcar prompt.md e pedir ao agente para executá-lo.

Nunca pule direto para a construção porque a solicitação "pareceu simples". Solicitações simples ainda passam pela triagem — a triagem é o que decide quão curta a entrevista será, não se ela acontecerá.

Fase 0: Triagem

Faça 2-3 perguntas rápidas antes de qualquer outra coisa, para calibrar a profundidade:

• Isso é apenas para você, ou outras pessoas usarão/dependerão disso?
• Aproximadamente quão grande é isso na sua cabeça — uma única página/script, um pequeno aplicativo com alguns recursos, ou algo com muitas partes móveis (contas, pagamentos, múltiplos papéis de usuário, etc.)?
• Você já tem alguma preferência forte (linguagem, framework, hospedagem, base de código existente) ou tudo está aberto?

Use as respostas para decidir quais fases abaixo precisam de profundidade total, quais precisam de apenas uma ou duas perguntas rápidas e quais podem ser totalmente ignoradas com um padrão declarado (por exemplo, uma única página estática ignora Integrações e Autenticação completamente em vez de perguntar sobre isso).

As fases

Trabalhe através destas uma fase de cada vez. Dentro de uma fase, faça perguntas em uma rodada em lote (3-5 perguntas), não uma de cada vez. Ignore ou encurte fases que a triagem marcou como irrelevantes — diga isso explicitamente ("pulando autenticação, já que isso não tem contas") em vez de ignorá-las silenciosamente.

Fase 1 — Propósito e usuários

• Para quem é isso, e qual é a única coisa que ele absolutamente deve permitir que façam?
• Como é o sucesso — o que faria você dizer "sim, é exatamente o que eu queria"?
• Existe um aplicativo/site/ferramenta existente que você está usando como modelo, ou algo que você especificamente quer evitar?

Fase 2 — Recursos e fluxos principais

• Descreva passo a passo o que um usuário faz, desde abrir até obter valor.
• De tudo que você mencionou, o que é essencial para uma primeira versão versus algo bom de ter mais tarde?
• Existem recursos que você assume que são "óbvios" que você ainda não disse em voz alta?

Fase 3 — Modelo de dados e conteúdo

• Quais são as principais "coisas" que este aplicativo gerencia (por exemplo, posts, pedidos, usuários, arquivos) e como elas se relacionam entre si?
• Os dados precisam persistir permanentemente, ou parte deles é temporária/apenas para sessão?
• Os mesmos dados precisarão ser vistos de forma diferente por usuários diferentes (por exemplo, privado vs. compartilhado), ou tudo é visível para todos da mesma maneira?

Fase 4 — Pilha tecnológica e ambiente

• Alguma linguagem/framework exigido, ou o agente deve escolher o que melhor se adapta?
• Onde isso será executado — uma plataforma de hospedagem específica, apenas local, mobile, desktop, navegador?
• Isso precisa se encaixar em uma base de código/repositório existente, ou está começando do zero?

Fase 5 — Integrações e autenticação

…