Prompt Forge — forja prompts por entrevista

Regras de ouro da entrevista

1. UMA pergunta por vez. Nunca despeje um questionário inteiro.
2. Dúvida = PERGUNTAR. Se algo ficou ambíguo (agente alvo, nível de autonomia, o que fazer com o resultado, idioma…), pare e abra uma caixa de texto com a pergunta. Nunca preencha com suposição silenciosa.
3. A/B quando der. Ofereça 2-3 opções objetivas, com uma recomendada.
4. Exemplo no domínio do usuário, nunca genérico ("uma empresa", "um sistema").
5. Não aceite "entendeu?". Peça aplicação: "me dá um exemplo de entrada e a saída que você espera".
6. Só entrega o prompt final quando as 3 seções estiverem preenchidas sem lacuna.

Modo headless / sem usuário (

-p

, script, subagente)

-p

• NÃO invente respostas em silêncio. Se uma resposta for obrigatória e não houver usuário, preencha com a opção padrão mais segura e declare a premissa explicitamente no prompt final (ex.: "PREMISSA: agente-alvo = CLI do usuário; autonomia = analisa+reporta; modelo = leve/forte conforme B11").
• O prompt final deve sempre listar as premissas assumidas em uma seção própria, para o usuário revisar depois. É a forma de "perguntar" quando não dá pra perguntar.
• Se o pedido for ambíguo a ponto de qualquer escolha segura poder estar errada, e não houver como perguntar, prefira não_entregar e reportar "faltou contexto" — nunca adivinhe sentido crítico.

Entrevista adaptativa (matriz por tipo de pedido)

/loop

seu CLI de código (com as flags de modelo/tempo do agente)

--allowedTools

/loop

Fluxo

1. Abertura (até 4 perguntas):
   • O que você vai pedir? (1 frase)
   • Para qual agente? (claude CLI / agy / codex / cursor / outro)
   • Qual modelo você prefere? — sugerir pelo TIPO de pedido (use o bloco

     skills/prompt-blocks/blocks/b11-roteamento-modelos.md

     ): análise/exploração → modelo "leve", execução/código → "forte", revisão → "mais forte". Sugira por CATEGORIA (leve/forte/médio), NUNCA por nome de modelo/provedor (não cite "Gemini", "Claude", "GPT"... — quem escolhe o nome é o usuário). Ofereça a categoria e pergunte qual ele prefere.
   • Nível de autonomia? (executa tudo / executa e reporta / só analisa)
2. A TAREFA — objetivo verificável, contexto mínimo, entregáveis, o que está FORA do escopo.
3. O MÉTODO — passos numerados, arquivos/ferramentas permitidos, formato de saída, idioma.
4. A META — critério de aceite objetivo (ex.: "build passa, git diff só toca os arquivos X"), regra de parada ("se Y, PARE e reporte"), o que NÃO fazer.
5. Entrega — prompt final em bloco de código, pronto para colar, com sugestão de comando (ex.:

   claude -p "$(cat prompt.txt)" --model sonnet

   ).

Seções extras (opcionais, só se fizerem sentido)

• "O QUE JÁ FOI VERIFICADO (não refaça)" — para agente rodando em cima de trabalho/diagnóstico existente.
• "LEIA PRIMEIRO" — lista de arquivos obrigatórios antes de agir.
• "Resumo objetivo no final" — formato do relatório de saída do agente.

Regras do prompt resultante (contrato com o agente)

• Autocontido: o agente não conhece a conversa — embuta os fatos do contexto. Não referencie caminhos fora do repo sem

  --add-dir

  .
• Componha seções com blocos da skill

  prompt-blocks

  quando houver bloco aplicável (PARE E REPORTE, karpathy, teste de decisão…).
• Prompt único gigante = NÃO. Se o pedido for multi-etapa ou multi-agente, sugira

  graph-engineering

  (task graph) e um prompt por ticket — juntar tudo num prompt buga a IA.

Skills relacionadas

• skill-router

  — porta de entrada: encaminha para esta skill quando o pedido é "montar prompt".

• prompt-blocks

  — blocos comprovados (com lição de incidente) para compor as seções.

• orchestrator

  — roteador do toolkit (quando usar esta skill).

• graph-engineering

  — se o pedido virar orquestração multi-agente (task graph).

Como usar os blocos do prompt-blocks (obrigatório)

skills/prompt-blocks/blocks/

skills/prompt-blocks/SKILL.md

Auto-atualização

self-learning