| name | analista-arquitectura-codigo |
| description | Examina la arquitectura y los patrones de diseño de cualquier proyecto abierto. Genera diagramas Mermaid atractivos y legibles que explican la estructura del código. |
Analista de Arquitectura de Código
Esta habilidad te permite realizar un análisis profundo de la estructura de un proyecto y visualizarlo mediante diagramas claros y profesionales.
Capacidades
- Exploración Automatizada: Escaneo recursivo de directorios para mapear la jerarquía del proyecto.
- Reconocimiento de Patrones: Identificación de arquitecturas comunes (MVC, Clean Architecture, Hexagonal, Microservicios, etc.).
- Visualización: Generación de diagramas Mermaid (clases, componentes o flujo) integrados en la respuesta.
Flujo de Trabajo para el Agente
Cuando se active esta habilidad, sigue estos pasos:
1. Fase de Descubrimiento
- Utiliza
list_dir de forma recursiva para entender la jerarquía de carpetas.
- Revisa archivos clave de configuración (ej.
package.json, requirements.txt, pom.xml) para identificar dependencias y el stack tecnológico.
- Usa
view_file_outline en archivos representativos para entender las relaciones entre clases y módulos.
2. Análisis Técnico
- Determina el patrón de diseño principal (ej. "¿Hay una separación clara entre modelos y controladores?").
- Identifica los flujos de datos principales y los puntos de entrada del sistema.
3. Generación del Diagrama
Crea un bloque de código Mermaid que sea:
- Atractivo: Usa estilos y colores si Mermaid lo permite en la versión actual.
- Legible: No satures el diagrama. Agrupa componentes por módulos.
- Alta Resolución: Diseña el diagrama para que sea claro incluso en proyectos grandes.
4. Resumen Ejecutivo
Proporciona una breve explicación en español de:
- El patrón arquitectónico identificado.
- Las fortalezas de la estructura actual.
- Posibles áreas de mejora o cuellos de botella detectados.
Ejemplo de Salida Esperada
graph TD
subgraph "Capa de Presentación"
UI[Pantallas de Usuario]
end
subgraph "Capa de Dominio"
Logic[Lógica de Negocio]
end
subgraph "Capa de Datos"
DB[(Base de Datos)]
end
UI --> Logic
Logic --> DB
Instrucción Final: Siempre que el usuario pida un diagrama de arquitectura, activa esta lógica para asegurar un resultado profesional.
