# ¿Puede un agente decirte dónde duele tu arquitectura?

Canonical URL: https://bestskillsforclaude.com/es/skills/improve-codebase-architecture
Language: es
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 y publicar
Last reviewed: 2026-08-05

Puede producir candidatos. Elegir cuáles importan sigue siendo tuyo.

## Short answer
La skill improve-codebase-architecture analiza una base de código buscando oportunidades de simplificar y profundizar módulos, presenta los hallazgos como informe y solo entonces explora los candidatos que elijas. Ese orden es el punto: diagnostica y se niega a reescribir antes de que decidas.

Best for: Bases de código que crecieron rápido y ahora filtran detalles entre módulos.
Skip it if: El proyecto es lo bastante pequeño como para que ya sepas dónde están los problemas.

## What to remember
- Primero informe, después cambios. Ese orden es lo que la hace segura.
- Acótala a un subsistema, porque el informe de un repositorio entero es inabordable.
- Los hallazgos son candidatos, no veredictos. Algunos estarán mal por razones que solo conoce tu equipo.
- Se combina con grill-me cuando quieres poner a prueba el razonamiento antes de comprometerte.

## Qué cambia en la práctica
El trabajo de arquitectura suele fallar por razones sociales más que técnicas: nadie se pone de acuerdo en por dónde empezar, así que no se empieza. Una lista concreta de candidatos con razones convierte esa discusión en una decisión.
Presentar hallazgos como informe también evita lo más peligroso que puede hacer un agente, que es refactorizar varios módulos a la vez mientras miras.

## Dónde decepciona
Ve el código, no la historia. Algunos límites incómodos existen por una restricción que no está escrita en ningún sitio, y la skill propondrá quitarlos con toda seguridad.
Los informes largos invitan además a ampliar el alcance. La disciplina de elegir un candidato es enteramente tuya.

## Install and first run
1. Instálala con el CLI de skills desde mattpocock/skills, con licencia MIT.
2. Ejecútala sobre un área y no sobre todo el repositorio, para que el informe sea revisable.
3. Elige uno o dos candidatos. Una lista de treinta hallazgos es una forma de no elegir nada.

## Questions
### ¿Cambia el código automáticamente?
Primero informa y luego explora los candidatos que elijas, en vez de refactorizar al vuelo.

### ¿Qué tamaño de código aguanta?
Acótala a un subsistema. Los informes de repositorio completo suelen ser inabordables.

### ¿Quién la mantiene?
Matt Pocock, en su repositorio público de skills con licencia MIT.

## Sources
- mattpocock/skills en GitHub: https://github.com/mattpocock/skills
- Directorio de agent skills: https://skills.sh

## Other languages
- English: https://bestskillsforclaude.com/en/skills/improve-codebase-architecture
- Brazilian Portuguese: https://bestskillsforclaude.com/pt-br/skills/improve-codebase-architecture
- Japanese: https://bestskillsforclaude.com/ja/skills/improve-codebase-architecture