felvieira Prompt Engineer
O Prompt Engineer transforma boas praticas de prompting em patterns reutilizaveis para features de IA e para o proprio kit.
Governanca Global
Esta skill segue GLOBAL.md, policies/execution.md, policies/token-efficiency.md, policies/handoffs.md, policies/evals.md e policies/stack-flexibility.md.
Quando Usar
- desenhar prompt de texto, imagem ou video para feature do app
- padronizar templates de prompt
- melhorar aderencia, reprodutibilidade e custo do prompt
Quando Nao Usar
- para improvisar prompts longos sem caso de uso claro
- para substituir arquitetura de integracao da feature
Entradas Esperadas
- objetivo do prompt
- tipo de midia: texto, imagem ou video
- contexto do app e restricoes reais
Saidas Esperadas
- prompt claro e reproduzivel
- notas de contexto minimo, schema e fallback quando aplicavel
- handoff para
AI Integration Architect,Image Generatorou skill consumidora
Base Obrigatoria
Consultar patterns/ai-integration/prompt-patterns.md antes de propor o template final.
Layering — Construção Incremental de Prompts
Todo prompt de produção deve ser construído em 3 camadas progressivas. Não pular camadas.
Camada A — Core behavior (mínimo funcional)
Apenas: job em uma frase, campos de input, campos de output. Sem exemplos, sem lógica avançada, sem constraints complexas. Testar aqui antes de avançar.
Camada B — Estrutura
Adicionar:
- seções organizadas e context de domínio
- regras de formato de saída
- constraints básicas (não inventar dados, defaultar campos ambíguos)
Testar aqui antes de avançar.
Camada C — Lógica avançada
Adicionar:
- multi-shot examples (1–3 pares input→output)
- detecção de informação faltante + fallback rules
- recomendações e lógica de borda
Evidência de conclusão: prompt funciona em Camada A antes de receber B e C.
Checkpoint por camada: rodar 3-5 inputs reais contra o prompt da camada atual → se algum output sair errado, corrigir só naquela camada (não pular pra próxima achando que a camada seguinte "vai compensar") → rodar de novo. Só adicionar a próxima camada quando a atual acertar todos os inputs de teste — camada B empilhada sobre camada A instável só mascara o problema, não resolve.
Ver templates/agent-spec.md para o template completo com as 3 camadas.
Evidencia de Conclusao
- prompt final com objetivo claro
- contexto minimo suficiente
- estilo e formato de saida definidos quando necessario
Handoff
Seguir policies/handoffs.md e, quando util, templates/prompt-spec.md.