Pular para o conteúdo
Skillpedia
Código em geral48 mil · #2445

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

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/brooks-debt/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/brooks-debt/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-debt

Ou 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.md
Conteú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

  1. Leia ../_shared/common.md para as regras da Lei de Ferro, Configuração do Projeto, Modelo de Relatório e Pontuação de Saúde
  2. Leia ../_shared/source-coverage.md para cobertura em nível de livro, exceções e compensações
  3. Leia ../_shared/decay-risks.md para definições de sintomas e atribuições de origem
  4. Leia debt-guide.md neste 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.

  1. Procure por todos os seis riscos de decaimento (Passo 1 do guia); liste todas as descobertas antes de pontuar
  2. Aplique a fórmula de prioridade Dor × Disseminação e classifique a intenção do débito (Passos 2–3 do guia)
  3. Agrupe as descobertas por risco de decaimento (Passo 4 do guia)
  4. 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.

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#2445
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas