# Um agente consegue dizer onde sua arquitetura realmente dói?

Canonical URL: https://bestskillsforclaude.com/pt-br/skills/improve-codebase-architecture
Language: pt-BR
Skill: improve-codebase-architecture
Publisher: Matt Pocock (https://github.com/mattpocock)
Source: https://github.com/mattpocock/skills
License as stated by the publisher: MIT
Runtime: Claude Code and agents that support the skills CLI
Category: Construir e publicar
Last reviewed: 2026-08-05

Ele produz candidatos. Escolher quais importam continua com você.

## Short answer
A skill improve-codebase-architecture varre a base de código procurando oportunidades de simplificar e aprofundar módulos, apresenta os achados como relatório e só então explora os candidatos que você escolher. Essa ordem é o ponto: ela diagnostica e se recusa a reescrever antes de você decidir.

Best for: Bases que cresceram rápido e agora vazam detalhes entre módulos.
Skip it if: O projeto é pequeno o bastante para você já saber onde estão os problemas.

## What to remember
- Primeiro relatório, depois mudança. Essa ordem é o que torna seguro rodar.
- Limite a um subsistema, porque relatório de repositório inteiro é grande demais para agir.
- Achados são candidatos, não veredictos. Alguns estarão errados por razões que só seu time conhece.
- Combina com grill-me quando você quer testar o raciocínio antes de se comprometer.

## O que muda na prática
Trabalho de arquitetura costuma falhar por razões sociais e não técnicas: ninguém concorda por onde começar, então nada começa. Uma lista concreta de candidatos com motivos transforma essa discussão em decisão.
Apresentar achados como relatório também evita a coisa mais perigosa que um agente pode fazer, que é refatorar vários módulos ao mesmo tempo enquanto você assiste.

## Onde decepciona
Ela vê o código, não a história. Algumas fronteiras estranhas existem por uma restrição que não está escrita em lugar nenhum, e a skill vai propor remover com toda a confiança.
Relatórios longos também convidam ao aumento de escopo. A disciplina de escolher um candidato é inteiramente sua.

## Install and first run
1. Instale com o CLI de skills a partir de mattpocock/skills, sob MIT.
2. Rode em uma área e não no repositório inteiro, para o relatório continuar revisável.
3. Escolha um ou dois candidatos. Uma lista de trinta achados é uma forma de não escolher nada.

## Questions
### Ela muda o código sozinha?
Ela relata primeiro e explora os candidatos que você escolher, em vez de refatorar de imediato.

### Que tamanho de base aguenta?
Limite a um subsistema. Relatórios de repositório inteiro costumam ser grandes demais.

### Quem mantém?
Matt Pocock, no repositório público de skills sob licença MIT.

## Sources
- mattpocock/skills no GitHub: https://github.com/mattpocock/skills
- Diretório de agent skills: https://skills.sh

## Other languages
- English: https://bestskillsforclaude.com/en/skills/improve-codebase-architecture
- Spanish: https://bestskillsforclaude.com/es/skills/improve-codebase-architecture
- Japanese: https://bestskillsforclaude.com/ja/skills/improve-codebase-architecture