Enfrentei o problema de a equipe não ler documentos de análise e relatórios gerados por agentes de IA porque eles são longos demais e cheios de jargão técnico ("AI verbosity/slop"). Pelo visto, não era um problema só meu.
Enfrentei o problema de a equipe não ler documentos de análise e relatórios gerados por agentes de IA porque eles são longos demais e cheios de jargão técnico ("AI verbosity/slop"). Pelo visto, não era um problema só meu.
O gargalo não era a profundidade do conteúdo, mas a leitura, então organizei como uma skill de agente 10 regras que eu aplicava repetidamente:
- Colocar a conclusão (o ponto principal) na primeira frase
- Começar os conceitos-chave com analogias
- Explicar ou eliminar jargões técnicos, e transformar fórmulas em palavras
- Deixar evidências como
file:lineem notas de rodapé fora do corpo do texto - Dobrável (progressive disclosure): fechado mostra o resumo, aberto mostra os detalhes
- …total de 10 itens + checklist + limites de "não use nestes casos"
É para Claude Code, mas as próprias regras podem ser aplicadas independentemente de framework ou linguagem.
Como vocês lidam com esse problema? Fico curioso se vocês pedem isso no prompt toda vez ou se deixam fixado em um arquivo de skills/regras.
Ainda não há comentários.