Prompt Engineering para Coding: 15 Templates

Crie uma funcao em [LINGUAGEM] chamada [NOME_DA_FUNCAO].

Entrada: [descreva os parametros com tipos]
Saida: [descreva o retorno com tipo]
Comportamento: [o que a funcao deve fazer, passo a passo]
Erros: [o que deve acontecer se X falhar — lancar excecao, retornar null, etc.]
Restricoes: [sem dependencias externas / use apenas stdlib / async obrigatorio]

Nao adicione comentarios obvios. Use nomes de variaveis descritivos.

Crie um endpoint [METODO HTTP] em [FRAMEWORK] (ex: Express, Fastify, Hono).

Rota: [/api/recurso]
Autenticacao: [JWT middleware / nenhuma / API key no header]
Body esperado: [esquema dos campos com tipos]
Resposta de sucesso: [estrutura do JSON de retorno, codigo HTTP]
Resposta de erro: [4xx para validacao, 5xx para falha de banco, etc.]
Validacao: [use Zod / use Joi / valide manualmente]

Padrao de erro: { error: string, code: string }

Crie um componente React em TypeScript chamado [NOME_COMPONENTE].

Props: [lista as props com tipos]
Estado interno: [descreva o state necessario, se houver]
Comportamento: [o que o componente faz, incluindo interacoes do usuario]
Estilos: [Tailwind CSS / CSS Modules / styled-components]
Acessibilidade: [inclua aria-labels e role quando relevante]

Nao use defaultProps. Use tipos estritos, sem 'any'.

Crie um custom hook React em TypeScript chamado use[NOME].

Proposito: [o que o hook encapsula]
Parametros: [tipos dos parametros de entrada]
Retorno: [o que o hook expoe — estado, funcoes, flags]
Efeitos colaterais: [chamadas de API, subscriptions, timers]
Limpeza: [o que deve acontecer no cleanup do useEffect]

Trate loading, error e data separadamente.

O codigo abaixo esta com comportamento inesperado.

O que deveria acontecer: [descreva o comportamento esperado]
O que esta acontecendo: [descreva o comportamento atual, com mensagem de erro se houver]
Entrada que causa o problema: [exemplo concreto]

[COLE O CODIGO AQUI]

Encontre a causa raiz e proponha uma correcao minima. Nao reescreva o que nao e necessario.

Refatore o codigo abaixo sem alterar o comportamento externo.

Objectivo do refactor: [remover duplicacao / melhorar legibilidade / extrair funcoes]
Restricoes: [nao mude a assinatura das funcoes publicas / mantenha compatibilidade]
Prioridade: [clareza > performance / performance > clareza]

[COLE O CODIGO AQUI]

Apresente a versao refatorada e uma lista das mudancas feitas.

Adicione tipos TypeScript ao codigo JavaScript abaixo.

Nao altere a logica. Apenas adicione tipos.
Se um tipo nao puder ser inferido com certeza, use 'unknown' em vez de 'any' e adicione um comentario explicando.
Crie interfaces ou types para objetos complexos.

[COLE O CODIGO JS AQUI]

Faca um code review do codigo abaixo.

Analise:
1. Bugs potenciais ou comportamento inesperado
2. Problemas de performance
3. Problemas de seguranca (injecao, exposicao de dados sensiveis)
4. Violacoes de principios SOLID ou boas praticas
5. Oportunidades de simplificacao

Para cada problema encontrado, indique: nivel de severidade (critico / importante / sugestao) e como corrigir.

[COLE O CODIGO AQUI]

Crie testes unitarios para a funcao abaixo usando [Jest / Vitest / pytest].

Teste o comportamento, nao a implementacao.
Cubra: casos normais, casos extremos (null, vazio, limite), casos de erro.
Nao mocke o que nao precisa ser mockado.
Nome dos testes no formato: 'deve [comportamento] quando [condicao]'.

[COLE A FUNCAO AQUI]

Crie testes de integracao para o endpoint abaixo usando [Supertest / httpx / requests].

Simule um banco de dados real em memoria (ou use um banco de teste isolado).
Teste: resposta de sucesso com body correto, validacao de campos obrigatorios, autenticacao invalida, erro de banco simulado.
Verifique status HTTP e estrutura do response body em cada cenario.

[COLE O ENDPOINT AQUI]

Crie testes para o componente React abaixo usando Testing Library e [Jest / Vitest].

Teste comportamento do usuario, nao detalhes de implementacao.
Simule interacoes reais: cliques, digitacao, submissao de formulario.
Mocke apenas chamadas de API externas.
Verifique o que o usuario ve, nao o estado interno do componente.

[COLE O COMPONENTE AQUI]

Projete um schema de banco de dados para o seguinte dominio de negocio:

[DESCRICAO DO DOMINIO]

Requisistos:
- [lista de funcionalidades que o schema precisa suportar]

Entregue:
1. Diagrama das entidades e relacionamentos (formato textual)
2. DDL SQL para as tabelas principais
3. Indices recomendados com justificativa
4. Apontamentos de normalizacao ou trade-offs de performance

Gere documentacao JSDoc / docstring para a funcao abaixo.

Incluir: descricao de uma linha do proposito, parametros com tipo e descricao, retorno com tipo e descricao, excecoes lancadas se houver, um exemplo de uso.
Nao repita informacao que ja esta clara pelo nome da funcao ou pelos tipos.

[COLE A FUNCAO AQUI]

Gere uma migracao de banco de dados para [Prisma / Drizzle / Knex / SQL puro].

Estado atual da tabela: [descreva as colunas existentes]
Mudanca necessaria: [adicionar coluna / renomear / alterar tipo / adicionar indice]
Requisistos: a migracao deve ser reversivel (inclua down migration).

Gere tambem uma query para verificar se a migracao foi aplicada com sucesso.

Analise o codigo abaixo focando exclusivamente em seguranca.

Verifique: SQL injection / NoSQL injection, XSS, CSRF, exposicao de dados sensiveis em logs ou respostas, autenticacao e autorizacao, dependencias com vulnerabilidades conhecidas.

Para cada problema: classifique como [critico / alto / medio / baixo] e descreva o vetor de ataque e a correcao recomendada.

[COLE O CODIGO AQUI]

Contexto do projeto:
- Stack: Next.js 16, TypeScript, Drizzle ORM, Postgres
- Padrao de erros: Result<T, E> (nunca lancar excecao)
- Estilo: funcional, sem classes, arrow functions
- Autenticacao: Better Auth com middleware no layout

[TEMPLATE AQUI]