brooks-debt
Ajuda seu agente a identificar problemas de manutenção no código. Ele classifica e prioriza esses problemas para criar um plano de melhoria.
O que ela faz
Esta ferramenta ajuda a encontrar e organizar problemas de manutenção no seu código de programação. Ela prioriza o que consertar primeiro, usando lições de livros de engenharia, para que você possa planejar melhorias.
Quando usar
- ✓Quando você quer saber quais partes do seu código precisam de conserto.
- ✓Ao planejar quais melhorias fazer no código primeiro.
- ✓Se você precisa de um guia para organizar a limpeza do seu código.
Exemplo do que pedir para a IA
“Analise meu código e me diga o que consertar primeiro para melhorar a manutenção.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta analisa seu código em busca de problemas comuns de manutenção, classifica esses problemas e os organiza por importância. Ela usa um método baseado em livros de engenharia para te ajudar a decidir o que arrumar.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill brooks-debtOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/brooks-debt/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Brooks-Lint — Avaliação de Débito Técnico
Quando Usar
Use esta habilidade quando precisar de uma avaliação de débito técnico que identifique, classifique e priorize problemas de manutenibilidade — ajudando as equipes a construir um roteiro de refatoração — baseada em doze livros clássicos de engenharia. Dispara quando: o usuário pergunta sobre débito técnico, prioridades de refatoração, o que limpar primeiro, ou pergunta "por que...
Configuração
- Leia
../_shared/common.mdpara as regras da Lei de Ferro, Configuração do Projeto, Modelo de Relatório e Pontuação de Saúde - Leia
../_shared/source-coverage.mdpara cobertura em nível de livro, exceções e compensações - Leia
../_shared/decay-risks.mdpara definições de sintomas e atribuições de origem - Leia
debt-guide.mdneste diretório para a estrutura de classificação de débito
Processo
Se o usuário não descreveu o codebase ou apontou para áreas específicas: aplique a Detecção de Escopo Automática de ../_shared/common.md para determinar o escopo da avaliação antes de prosseguir.
- Procure por todos os seis riscos de decaimento (Passo 1 do guia); liste todas as descobertas antes de pontuar
- Aplique a fórmula de prioridade Dor × Disseminação e classifique a intenção do débito (Passos 2–3 do guia)
- Agrupe as descobertas por risco de decaimento (Passo 4 do guia)
- Saída usando o Modelo de Relatório de common.md, mais a Tabela Resumo de Débito
Linha de modo no relatório: Tech Debt Assessment
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente à sua fonte original e ao contexto do projeto local.
- Verifique comandos, código gerado, dependências, credenciais e comportamento de serviços externos antes de aplicar alterações.
- Não trate exemplos como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.
Perguntas frequentes
O que é 'tech debt'?
'Tech debt' (dívida técnica) é como um atalho que você pega na programação, que pode te dar problemas no futuro se não for resolvido. É algo que precisa ser arrumado para o código funcionar melhor e ser mais fácil de manter.
O que significa 'refactoring roadmap'?
Um 'refactoring roadmap' é um plano que mostra quais partes do código você vai arrumar e em que ordem. Ajuda a organizar o trabalho de melhoria do código.
De onde vêm as regras para priorizar os problemas?
As regras vêm de doze livros clássicos de engenharia, que ensinam as melhores práticas para construir e manter software de qualidade.
Detalhes
Descrição original do autor
Tech debt assessment that identifies, classifies, and prioritizes maintainability problems — helping teams build a refactoring roadmap — drawing on twelve classic engineering books.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2445
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
benchmark-optimization-loop
Faz seu agente melhorar a velocidade de algo de forma medida. Ele testa várias versões e escolhe a mais rápida que ainda funciona corretamente.
affaan-m/ECC
change-impact
Ajuda seu agente a analisar o impacto de mudanças no código antes de fazê-las. Ele compara o planejado com o real depois, cobrindo caminhos, dados, testes e documentação. É útil para mudanças arriscadas ou que afetam várias partes do sistema.
affaan-m/ECC
click-path-audit
Faz seu agente rastrear todos os botões e interações do usuário para achar bugs. Ele encontra problemas onde funções parecem funcionar sozinhas, mas falham juntas. Útil quando bugs persistem mesmo após depuração.
affaan-m/ECC