Issue bem escrita
Escreve uma issue com reprodução, contexto e critério de pronto.
Serve pararelatar bug ou pedir funcionalidade sem ida e volta.
O que esperar do resultado
Uma issue que outra pessoa consegue pegar e resolver sem perguntar nada.
Prompt
Escreva uma ISSUE. Tipo: [BUG / FUNCIONALIDADE / MELHORIA] O que acontece ou o que falta: [DESCREVA] Contexto: [ONDE, QUANDO, COM QUEM] Impacto: [QUEM É AFETADO E QUANTO] O que eu já investiguei: [SE INVESTIGOU] Para BUG: - comportamento esperado × comportamento atual; - passos de reprodução, numerados; - ambiente (versão, navegador, sistema); - erro/log, se houver; - frequência. Para FUNCIONALIDADE: - o problema que ela resolve (não a solução que você imaginou); - quem precisa disso e com que frequência; - como se resolve hoje, na marra; - critério de PRONTO. Nos logs e exemplos, substitua dado real de pessoa por fictício. Issue sem passos de reprodução ou sem critério de pronto volta como pergunta e atrasa a mesma coisa duas vezes.
Como usar
- Descreva o problema, não a solução: quem implementa costuma ver um caminho melhor.
- Remova dado pessoal dos logs antes de colar — issue costuma ser pública.
Você também pode gostar
Revisão de código
Revisa um trecho de código por correção, clareza e risco.
Serve para: revisar antes de abrir PR, ou revisar o PR de outra pessoa.
Programação & AutomaçãoDiagnóstico de bug
Investiga a causa de um bug a partir do comportamento e do código.
Serve para: erro que você não consegue reproduzir ou entender.
Programação & AutomaçãoPlano de refatoração
Planeja uma refatoração em passos seguros e reversíveis.
Serve para: código que precisa mudar sem parar de funcionar.
Programação & AutomaçãoGeração de testes
Escreve testes para um código, começando pelo que pode quebrar.
Serve para: código sem teste que você precisa mexer.
Programação & AutomaçãoMais de Programação & Automação
Documentação de API
Documenta endpoints a partir do código, com exemplos e erros.
Serve para: API que só quem escreveu entende.
Programação & AutomaçãoConsulta SQL
Escreve e explica uma consulta SQL a partir do que você precisa saber.
Serve para: tirar um número do banco sem travar na sintaxe.
Programação & AutomaçãoConstrutor de regex
Monta uma expressão regular e explica cada parte dela.
Serve para: validar, extrair ou substituir texto por padrão.
Programação & AutomaçãoFluxo de automação
Desenha uma automação com gatilho, passos e tratamento de falha.
Serve para: tarefa repetitiva que dá para automatizar.
Programação & AutomaçãoChecklist de deploy
Monta o checklist de uma publicação, com plano de reversão.
Serve para: subir mudança em produção sem esquecer um passo.
Programação & AutomaçãoNovos comandos, exemplos e aplicações práticas: @olopeszz.ia