Modulo 3.1 — Rodando a skill audit-ablacao

🔍 Saiba o que a skill faz e o que ela nunca faz

audit-ablacao e uma skill — um arquivo de procedimento que voce guarda numa pasta e que o Claude Code carrega quando voce chama pelo nome ou quando a descricao dela casa com o seu pedido. O que essa skill faz: le o seu CLAUDE.md (o do projeto e o global, em ~/.claude/CLAUDE.md), as suas outras skills, os hooks (comandos que o Claude Code dispara automaticamente em certos momentos, antes ou depois de uma ferramenta rodar) e o settings.json (o arquivo de configuracao do proprio Claude Code: permissoes, variaveis de ambiente, hooks). Depois classifica cada instrucao, decide o que fazer com ela e entrega um relatorio de 10 secoes.

O que ela nunca faz: editar, mover, apagar, sobrescrever config ou commitar. Isso e de proposito, nao e limitacao. Auditoria que ja sai mexendo e auditoria em que voce nao confia — voce perde a chance de discordar antes do estrago, e perde a linha de base pra medir se o corte foi bom. Aqui, aplicar e um pedido separado, seu, noutra sessao.

🆕 Quatro palavras antes de seguir

Skill: arquivo SKILL.md com um procedimento nomeado, carregado sob demanda pelo agente.
Hook: comando que o Claude Code executa sozinho num evento (antes/depois de uma ferramenta, ao encerrar a sessao).
settings.json: config do harness — permissoes, variaveis de ambiente e registro de hooks.
Gatilho (trigger): as frases da descricao da skill que fazem o agente decidir carrega-la sem voce chamar pelo nome.

✓ O que a skill faz

✓Le CLAUDE.md do projeto e o global
✓Le as skills, os hooks e o settings.json
✓Classifica cada instrucao (contexto, guardrail, criterio, verificacao, microgerenciamento, redundancia, legado…)
✓Decide KEEP · SIMPLIFY · MOVE · MERGE · TEST · REMOVE
✓Audita skill por skill, uma a uma
✓Entrega o relatorio de 10 secoes

✗ O que ela nunca faz

✗Editar qualquer arquivo de config
✗Mover ou renomear skills
✗Apagar linhas do seu CLAUDE.md
✗Sobrescrever settings.json ou hooks
✗Rodar git, commitar ou empurrar nada
✗Opinar sobre arquivo que ela nao conseguiu ler

O que olhar: as setas cheias vao ate o relatorio — esse e o caminho que a skill percorre. A ultima seta e tracejada e esta cortada por um X: aplicar nao faz parte do trabalho dela. Repare tambem que a coluna da esquerda diz "configuracao (inalterada)": os arquivos entram e saem exatamente iguais.

Vizinhanca: nao confunda as duas

memory-audit

Cuida da memoria guardada da sessao: o que foi anotado, o que e ruido, o que devia ser esquecido.

audit-ablacao

Cuida da configuracao do agente: CLAUDE.md, skills, hooks, settings.json.

📦 Instale a skill

Instalar uma skill e copiar um arquivo pra uma pasta. Nada alem disso. Dois caminhos: global (vale em todos os seus projetos, fica em ~/.claude/skills/) ou por projeto (vale so ali, fica em .claude/skills/ dentro do repositorio). Escolha um dos dois blocos abaixo e rode no terminal.

Caminho A — instalacao global

Disponivel em qualquer projeto que voce abrir com o Claude Code.

git clone https://github.com/inematds/audit-ablacaocc.git
mkdir -p ~/.claude/skills/audit-ablacao
cp audit-ablacaocc/SKILL.md ~/.claude/skills/audit-ablacao/SKILL.md

Caminho B — instalacao por projeto

Rode dentro da pasta do projeto. Troque <caminho> pelo lugar onde voce clonou o repositorio.

mkdir -p .claude/skills/audit-ablacao
cp <caminho>/audit-ablacaocc/SKILL.md .claude/skills/audit-ablacao/SKILL.md

Verifique que instalou

Duas checagens: o arquivo existe no disco, e o agente enxerga a skill.

# 1. o arquivo esta no lugar?
ls ~/.claude/skills/audit-ablacao/
# esperado: SKILL.md

# 2. o cabecalho da skill esta legivel?
head -4 ~/.claude/skills/audit-ablacao/SKILL.md
# esperado: uma linha "name: audit-ablacao"

Passo 3: reinicie a sessao do Claude Code. Skills sao lidas na inicializacao — enquanto voce nao reiniciar, a skill existe no disco mas nao existe pro agente. Depois de reiniciar, audit-ablacao deve aparecer na lista de skills disponiveis.

💡 Global ou por projeto? A diferenca pratica

A skill do projeto versiona junto com o codigo: ela anda com o repositorio, entra no pull request, e um colega revisa o procedimento como revisa qualquer outro arquivo. E ela nao vaza pros seus outros projetos — nao vira mais uma linha competindo por atencao onde nao faz sentido.

A global e conveniente pra ferramenta que voce usa em todo lugar. Regra simples: procedimento do time vai pro projeto, ferramenta pessoal vai pro global.

🎯 Escolha o escopo certo

Escopo e o conjunto de arquivos que voce manda a skill auditar. Se voce nao disser, ela pergunta — e a resposta muda a qualidade do relatorio mais do que qualquer outra escolha deste modulo. Tres escopos que valem a pena, cada um com o seu momento:

Escopo	Onde vive	Quando rodar
Global	`~/.claude/`	A cada ~6 meses, e principalmente em lancamento grande de modelo
Um projeto	`./CLAUDE.md` + `./.claude/`	Quando o `CLAUDE.md` dele passa de ~150 linhas
Um conjunto de skills	Algumas pastas de `skills/`	Quando 3+ skills brigam pelo mesmo gatilho

Por que nao auditar tudo de uma vez? Porque o custo aparece no relatorio, nao no seu tempo. Escopo largo significa muita instrucao lida com pouca atencao por instrucao: as tabelas ficam rasas, a coluna "Como testar" vira generica, e o Top 10 mistura coisas de contextos que nao se comparam. Escopo estreito da o oposto — cada recomendacao com trecho citado, risco nomeado e um teste que voce consegue rodar hoje.

✓ Escopo bem escolhido

✓"Audita so o CLAUDE.md global" — um arquivo, analise linha a linha
✓"Audita as 4 skills de video deste projeto" — recorte com fronteira clara
✓Um escopo por sessao, um relatorio por escopo

✗ Escopo que estraga o relatorio

✗"Audita tudo" — global + 12 projetos + 40 skills na mesma passada
✗Escopo vago ("minha config") que obriga a skill a adivinhar o que ler
✗Misturar dois projetos: as redundancias apontadas nao existem de verdade

📑 Leia o relatorio de 10 secoes

O relatorio tem ordem fixa, e a ordem e um argumento: comeca no diagnostico, passa pela evidencia, chega na proposta e termina no plano de prova. Ler na ordem e ler o raciocinio. Cada secao cobra alguma coisa de voce — abaixo, o que e.

O que olhar: os degraus sobem em quatro faixas. As duas primeiras faixas (secoes 1 a 5) olham pro que existe; as duas ultimas (6 a 10) propoem e provam. O brilho fica no degrau 10 porque e dele que sai a sua lista de trabalho — mas ele so tem valor se os degraus de baixo estiverem cheios de trecho citado.

Resumo executivo — os 5 maiores problemas

Cobra de voce: decidir se esses 5 sao mesmo os seus problemas. Se nenhum soar familiar, o escopo estava errado.

Metricas — instrucoes analisadas, contagem por decisao, % de reducao estimada

Cobra: conferir se o numero de instrucoes analisadas bate com o tamanho real do que voce mandou ler. Numero baixo demais = leitura parcial.

Problemas por arquivo — Arquivo | Problema | Severidade | Recomendacao | Justificativa

Cobra: checar se a justificativa e um argumento, nao um adjetivo. "Verboso" nao e justificativa; "duplica a regra X do arquivo Y" e.

Candidatas a remocao — Trecho | Arquivo | Motivo | Risco | Como testar

A secao mais importante. Cobra: abrir o arquivo e conferir o trecho. Sem a coluna "Como testar", o relatorio esta incompleto — remocao sem teste e aposta.

Redundancias e conflitos

Cobra: decidir qual copia fica. Conflito nao resolvido continua fazendo o modelo escolher sozinho — e voce sem saber qual.

Skills — Skill | Funcao atual | Diagnostico | Recomendacao | Reducao estimada

Cobra: reconhecer a funcao descrita. Se a "funcao atual" nao e o que voce usa a skill pra fazer, a descricao dela esta mentindo — e o gatilho tambem.

`CLAUDE.md` proposto — versao minima completa

Cobra: ler como rascunho, nao como ordem. Vem em bloco de codigo, e proposta — nada foi aplicado no seu arquivo.

Skills propostas — versoes reduzidas das que ficam

Cobra: verificar se o procedimento continua executavel depois do corte. Skill enxuta que perdeu um passo essencial nao e ganho.

Plano de ablacao — A (atual) / B (simplificada) / C (minima)

Cobra: reconhecer as 5 a 10 tarefas propostas como tarefas reais do seu projeto. Tarefa hipotetica nao prova nada. E o assunto do Modulo 4.1.

Top 10 mudancas — por impacto esperado ÷ risco

Cobra: e a sua fila de trabalho. Se um item aparece aqui sem estar em nenhuma secao anterior, ele nasceu do nada — desconfie.

⚠️ A skill nao aplica nada — nao peca pra ela editar

Terminou de ler o relatorio e bateu vontade de dizer "agora aplica o Top 10 pra mim"? Nao peca. Aplicar dentro da mesma sessao da auditoria mistura diagnostico com execucao: voce perde a versao A (a config original intacta) que o plano de ablacao precisa como linha de base, e perde a chance de discordar item por item. Corte noutra sessao, com o relatorio salvo aberto do lado.

🧩 Audite skill por skill

Instrucao solta tem 6 decisoes possiveis (KEEP · SIMPLIFY · MOVE · MERGE · TEST · REMOVE). Skill tem 7, porque uma skill e uma unidade com fronteira: da pra dividir, fundir, ou mudar o momento em que ela e carregada. Essa ultima possibilidade — load-on-demand, carregar so quando a tarefa pede em vez de ficar sempre no contexto — e a que mais devolve espaco sem perder nada.

Decisao	Significa	Sinal tipico
KEEP	Fica como esta	Resolve um problema recorrente e nao tem gordura
SIMPLIFY	Fica, mas menor	Bons criterios enterrados em passo a passo e exemplos demais
MERGE	Funde com outra	Duas skills competindo pelo mesmo gatilho e dizendo quase a mesma coisa
SPLIT	Vira duas	Um arquivo com dois procedimentos que nunca sao usados juntos
LOAD-ON-DEMAND	So carrega quando pedida	Util, porem rara — nao precisa custar contexto nas outras 90% das tarefas
CONVERT-TO-CONTEXT	Vira duas linhas no `CLAUDE.md`	Nao ha procedimento ali, so um fato que precisa estar sempre disponivel
DELETE-CANDIDATE	Candidata a sumir	Ensina raciocinio generico que o modelo ja faz sozinho

As decisoes acima nao saem do nada. Elas caem de sete perguntas que a skill faz pra cada arquivo — e que voce pode fazer sozinho, lendo qualquer skill sua:

As perguntas que decidem

1.Ela precisa existir?
2.Que problema recorrente ela resolve? (uma vez so nao e recorrente)
3.O que nela e contexto, o que e procedimento, e o que e microgerenciamento?
4.Caberia numa instrucao curta?
5.Deveria carregar so sob demanda?
6.Da pra dividir, ou pra fundir com outra?
7.Contem coisas que o modelo ja faz sozinho?

💡 Dica pratica

A pergunta 3 e a que mais rende. Pegue uma skill sua e marque cada paragrafo com uma das tres letras: C (contexto — fato que o modelo nao infere), P (procedimento — passo repetivel de verdade) ou M (microgerenciamento — voce dirigindo como ele pensa). Todo M e candidato imediato a virar criterio de saida. A skill faz exatamente isso, so que no arquivo inteiro.

🧪 Rode e confira 3 remocoes

Hora de rodar. Chamada direta pelo nome, ou por gatilho em linguagem natural — a diferenca e que a chamada direta elimina a loteria: voce nao depende da descricao da skill casar com a sua frase. Peca a saida num arquivo .md novo; relatorio de 10 secoes no chat rola pra fora da tela antes de voce terminar de conferir.

Como chamar

# chamada direta (recomendada)
/audit-ablacao

# por gatilho, em linguagem natural
faz uma auditoria de ablacao do meu CLAUDE.md global
audita as skills deste projeto, meu prompt ta inchado
o que da pra remover da minha config sem quebrar nada?

# pedindo a saida em arquivo (faca isso)
/audit-ablacao — escopo: ~/.claude/CLAUDE.md e ~/.claude/skills/.
Salve o relatorio completo, com as 10 secoes, num arquivo .md NOVO
no diretorio de trabalho. Nao edite nenhum arquivo de config.

✓ Relatorio que voce aceita

✓Toda recomendacao cita arquivo e trecho
✓Cada remocao relevante vem com o risco explicado
✓A coluna "Como testar" esta preenchida com um teste que voce consegue rodar
✓Onde falta evidencia, a decisao e TEST, nao KEEP nem REMOVE

✗ Relatorio que voce devolve

✗Diagnostico por suposicao sobre arquivo que ela nao leu
✗"Muito verboso, cortar" sem apontar o trecho
✗Corte de guardrail de seguranca tratado como ganho de concisao
✗Reducao de 70% celebrada sem nenhum plano de teste

💡 Curto nao e sempre melhor

A meta nao e a maior reducao percentual. E qualidade + autonomia + verificabilidade ÷ complexidade. Contexto que o modelo nao consegue inferir sozinho — identidade do projeto, caminhos de arquivo, fontes de verdade, branding, seguranca, compliance, contratos de interface — nao entra na fila de corte por ser longo. Se o relatorio propuser remover algo desse grupo, a resposta certa e "nao", e nao "que otimo, mais 8%".

🎯 Exercicio: audite o auditor

Objetivo: sair da leitura passiva. Voce vai pegar 3 recomendacoes de REMOVE do seu proprio relatorio e conferir uma por uma, no arquivo, com o trecho aberto na frente.

1. Rode a skill no escopo escolhido, salvando em relatorio-ablacao.md
2. Abra a secao 4 (Candidatas a remocao) e escolha 3 linhas
3. Para cada uma:
   - abra o arquivo citado no trecho
   - confirme que o trecho existe MESMO, e no lugar indicado
   - anote arquivo:linha
   - de o veredito: CONCORDO / DISCORDO / MUDA PARA TEST
   - escreva uma frase dizendo por que

Formato da anotacao:
  ~/.claude/CLAUDE.md:42 — MUDA PARA TEST
  "o risco descrito e real, mas nao existe teste proposto;
   quero ver o modelo falhar sem isso antes de apagar"

Criterio de saida: um arquivo .md salvo com o relatorio completo nas 10 secoes, mais 3 vereditos escritos, cada um apontando arquivo:linha. Se voce nao conseguiu localizar o trecho de alguma das 3, isso ja e um achado: a skill opinou sobre algo que nao leu direito — e essa linha vira DISCORDO na hora.

Checagem rapida (nao bloqueia nada): o relatorio traz uma linha na secao 4 recomendando REMOVE de um paragrafo do seu CLAUDE.md, com motivo e risco preenchidos — mas a coluna "Como testar" esta vazia. O que fazer?

📌 Resumo do Modulo

✓

A skill le, classifica e relata — e para ali — nunca edita, move, apaga, sobrescreve ou commita. E de proposito.

✓

Instalar e copiar um arquivo — global em ~/.claude/skills/, ou por projeto em .claude/skills/; depois reinicie a sessao.

✓

Escopo estreito da relatorio melhor — global a cada ~6 meses, projeto acima de ~150 linhas, skills quando 3+ brigam pelo gatilho.

✓

10 secoes, cada uma cobrando algo de voce — e a secao 4 sem "Como testar" e relatorio incompleto.

✓

Skill tem 7 decisoes — KEEP, SIMPLIFY, MERGE, SPLIT, LOAD-ON-DEMAND, CONVERT-TO-CONTEXT, DELETE-CANDIDATE.

✓

Cobre a skill — trecho citado, risco explicado, nada de suposicao sobre arquivo nao lido; na duvida, TEST.

Proximo Modulo:

3.2 — Do relatorio aos cortes: transformar o Top 10 numa sequencia de mudancas aplicaveis, sem perder a linha de base.

← Voltar para Trilha Proximo Modulo →