Claude Code
com o Claudinho
O Claude no terminal: o que o Vagner usa nos vídeos.
Improve Codebase Architecture skill
Um relatório visual com os pontos do código que valem refatorar primeiro, e uma conversa pra decidir como mexer no que você escolher.
- instalações
- 1,2 milhão
- estrelas no GitHub
- 303,3 mil
- No skills.sh desde
- março de 2026
- Licença
- MIT
Atualizada no GitHub em 22 de outubro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.
O que ela faz
Se você não apontar uma área, olha o histórico de commits pra achar as partes do projeto que mais mudam. Depois manda um subagente percorrer o código atrás de atrito: conceito espalhado em muitos arquivos pequenos, módulo raso que só repassa chamada, partes que vazam umas nas outras e trechos difíceis de testar.
Monta um HTML na pasta temporária, fora do repositório, e abre no navegador. Cada candidato vem num cartão com os arquivos envolvidos, o problema, a solução, o ganho nos testes, um diagrama de antes e depois e uma nota: forte, vale explorar ou especulativo. No fim, diz qual atacar primeiro.
Você escolhe um candidato e ela entra numa rodada de perguntas sobre restrições, dependências e quais testes sobrevivem. Termos novos vão pro GLOSSARY.md e, se você recusar a ideia por um motivo que importa, oferece registrar a decisão num ADR em docs/adr pra não voltar a sugerir.
Nas palavras de quem fez
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
Quando usar
- O projeto cresceu e qualquer mudança pequena obriga a mexer em vários arquivos
- O Claude se perde no código porque a lógica está espalhada
- Antes de uma refatoração grande, pra saber por onde começar
- Partes importantes do sistema não têm teste e ninguém sabe como testar
Depois de instalar, é só pedir assim
- /improve-codebase-architecture olha a parte de pagamentos, que é onde mais dá bug
- /improve-codebase-architecture e me diz qual refatoração faz mais diferença primeiro
- /improve-codebase-architecture foca no que mudou nos últimos meses
Segurança
Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.
- Gen Agent Trust HubAlerta
- SocketPassou
- SnykAlerta
Perguntas
Como instalar a Improve Codebase Architecture no Claude Code?
Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Improve Codebase Architecture, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.
Ela começa sozinha quando eu falo de arquitetura?
Não. Vem marcada pra rodar só quando chamada pelo nome, com /improve-codebase-architecture. E ela chama outras três skills do mesmo repositório (codebase-design, grilling e domain-modeling), então vale instalar o pacote do Matt Pocock inteiro, não só ela.
Ela já sai refatorando o código?
Não. Primeiro entrega o relatório e pergunta qual candidato você quer explorar. A mudança só é decidida depois da rodada de perguntas com você. Não precisa de chave de API nem de conta paga, mas o relatório puxa o Tailwind e o Mermaid pela internet pra montar os diagramas.
Roda no Codex e no Antigravity?
O repositório traz instalação própria pro Codex, e o npx skills add instala também no Antigravity. Pro relatório, o agente precisa conseguir criar arquivo e abrir no navegador.
Levar essa skill
1x improve-codebase-architectureR$ 0,00
TotalR$ 0,00
Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/mattpocock/skills
Aprenda a usar
- O que é o Claude Code (Claude CLI) e como começar
O que é o Claude Code (Claude CLI), pra que serve pra quem não programa, o que ele pede pra rodar e como se compara ao Codex, ao Antigravity e ao Cursor.
Na mesma prateleira
Ver as 5.600 skills do corredorMatt Pocock
grill-
Você sai da conversa com o plano afiado, os termos do projeto definidos num GLOSSARY.md e as decisões difíceis registradas em docs/adr.Auditada1,2 milhão de instalações, grátiswith- docs setup-
Numa conversa, o projeto fica pronto pras outras skills do Matt Pocock saberem onde abrir tarefa, que etiqueta usar e onde está o glossário.Auditada1,1 milhão de instalações, grátismatt- pocock- skills tdd
O agente combina com você onde testar, escreve um teste por vez e só o código que faz ele passar, com testes que aguentam mudança no código.Auditada1,1 milhão de instalações, grátistriage
Sua fila de issues sai organizada: cada uma com tipo, situação e, quando estiver pronta, um briefing que um agente executa sozinho.995,5 mil instalações, grátisprototype
Antes de construir de verdade, você clica, vê e decide se a regra funciona ou qual tela fica melhor. No código principal, fica só a decisão.Auditada993 mil instalações, grátisdomain-
Você e o Claude passam a chamar cada coisa pelo mesmo nome, e as decisões difíceis ficam escritas com o porquê.Auditada883,6 mil instalações, grátismodeling codebase-
O Claude organiza o código em partes que escondem a complexidade, ficam fáceis de testar e se consertam num lugar só.Auditada857,1 mil instalações, grátisdesign diagnosing-
O Claude para de chutar a causa: primeiro faz o erro aparecer num comando, depois testa hipóteses, corrige e deixa um teste pra ele não voltar.Auditada841,6 mil instalações, grátisbugs
Mais da loja Matt Pocock
Ver a loja Matt Pocockgrill-
Você chega com um plano na cabeça e sai com cada decisão tomada, sem nada que ficou subentendido no meio do caminho.Auditada1,4 milhão de instalações, grátisme handoff
Quando a conversa fica longa demais, você abre uma sessão nova, entrega o documento e o agente já sabe o que foi feito, o que falta e quais skills usar.Auditada1 milhão de instalações, grátisgrilling
Antes de gastar tempo e dinheiro, cada buraco do plano aparece numa pergunta numerada, e você sai com todas as decisões tomadas.Auditada988 mil instalações, grátisteach
Você aprende qualquer assunto em várias sessões, com aulas curtas ligadas ao seu objetivo e exercícios que corrigem na hora.Auditada867,7 mil instalações, grátiscode-
Antes de juntar uma mudança, você sabe se ela segue as regras do projeto e se entrega o que foi pedido, em dois relatórios separados.796,1 mil instalações, grátisreview implement
Você passa o ticket ou a especificação e o Claude constrói, roda os testes, revisa o próprio trabalho e faz o commit na branch atual.Auditada779,8 mil instalações, grátisask-
Você conta a situação e o Claude diz qual skill, ou qual sequência de skills do Matt Pocock, usar e em que ordem.Auditada772,2 mil instalações, grátismatt wayfinder
Uma ideia grande e ainda nebulosa vira um mapa de decisões no GitHub ou em arquivos locais, e cada sessão do Claude resolve uma até o caminho ficar claro.723,8 mil instalações, grátisto-
Depois de discutir uma ideia com o agente, um comando junta tudo num documento com problema, solução, histórias de usuário e decisões, já na lista de tarefas.Auditada720,9 mil instalações, grátisspec to-
O Claude transforma o plano em tickets que cabem numa sessão cada, diz qual depende de qual e publica no GitHub, no Linear ou em arquivos.716,8 mil instalações, grátistickets research
Você continua trabalhando enquanto um agente lê a documentação oficial e devolve um arquivo com cada informação ligada à fonte de onde saiu.Auditada716,2 mil instalações, grátiswizard
Em vez de explicar de novo pra IA onde pegar cada chave, você roda um roteiro que abre o site certo, diz o que copiar e guarda o valor no lugar.Auditada558,5 mil instalações, grátis