triage-issues

triage-issues roda uma issue que chega por uma máquina de estados disciplinada, pra que um relato de bug ou pedido de feature saia ou pronto pra trabalhar ou claramente parqueado — nunca preso no limbo do “a gente olha depois”.

O que resolve

Backlogs de issues apodrecem do mesmo jeito em todo lugar: relatos chegam mal descritos, ninguém reproduz o bug antes de debatê-lo, as mesmas perguntas são feitas duas vezes porque a primeira rodada de grilling nunca foi anotada, e ideias rejeitadas somem sem registro do porquê — então são re-propostas em seis meses. Triagem no feeling produz um backlog inconsistente em que ninguém confia. Uma máquina de estados faz toda issue percorrer o mesmo caminho bem definido.

Como resolve

• Categorizar — bug ou enhancement, primeiro.
• Estados definidos — cada issue passa por needs-triage → needs-info → ready-for-agent / ready-for-human / wontfix, então o status é sempre explícito.
• Reproduzir antes do grilling — um bug deve ser reproduzido antes de debatido, pra que a conversa seja sobre uma falha real, não um chute.
• Preservar o trabalho — o grilling que termina em needs-info é salvo nas notas da issue, pra que a próxima rodada não comece do zero; enhancements rejeitados são registrados em .out-of-scope/ com o raciocínio.
• Atribuição honesta — todo comentário gerado por IA carrega um disclaimer obrigatório, pra que um leitor humano sempre saiba o que um agente escreveu.

Quando usar

Abrindo ou triando bugs e pedidos de feature que chegam, ou preparando issues pra um agente pegar. Fica no bundle docs ao lado de plan-backlog.