auditor-a-de-proyecto

name: Auditoría de Proyecto description: Genera una auditoría completa (código, dependencias, calidad) usando análisis estático y manual.

Auditoría de Proyecto Avanzada

Esta habilidad realiza un análisis profundo del código, combinando automatización (para métricas y grafos) con inspección manual (para lógica y coherencia).

Objetivos

1. Automatizar la recolección de datos: Archivos, tamaños, TODOs, dependencias.
2. Visualizar la arquitectura: Generar gráficos de relaciones.
3. Detectar problemas específicos del Stack: TypeScript, Tailwind, Astro, React, etc.
4. Plan de Acción: Generar un plan de reparación concreto.

Flujo de Trabajo

Fase 1: Análisis Automático (Automation)

1. Ejecuta el script de análisis incluido en la habilidad:

   python3 .agent/skills/audit_project/scripts/analyze.py . > audit_raw.json
   

   (Ajusta la ruta . si el código fuente está en una subcarpeta como src o delivery).
2. Lee el archivo audit_raw.json generado para obtener una visión global rápida.

Fase 2: Inspección Dirigida (Manual & Context Aware)

Basándote en el JSON, identifica los "Puntos Calientes" (archivos grandes, complejos o con muchos TODOs). Usa view_file para inspeccionar esos archivos clave y verificar:

• TypeScript: ¿Uso excesivo de any? ¿Interfaces duplicadas?
• Tailwind/CSS: ¿Clases kilométricas? ¿Inconsistencia en paleta de colores? ¿CSS duplicado?
• Astro/React: ¿Hidratación innecesaria (client:load)? ¿Componentes "Dios" (demasiado grandes)?
• Seguridad: ¿Secrets hardcodeados? ¿Inputs sin sanitizar?

Fase 3: Generación del Reporte (Artefacto)

Crea o actualiza el archivo AUDITORIA.md con el siguiente formato enriquecido:

# Reporte de Auditoría Técnica - [Fecha]

## 1. Resumen Ejecutivo
*   **Estado de Salud**: [0-10]
*   **Archivos Analizados**: [X]
*   **Total Líneas de Código**: [Y]
*   **Deuda Técnica Detectada**: [Z] TODOs/FIXMEs

## 2. Visualización de Arquitectura (Mermaid)
(Usa los datos de `dependencies` del JSON para generar un gráfico Mermaid simplificado de los módulos principales)
\`\`\`mermaid
graph TD
    A[Main] --> B[ComponenteX]
    A --> C[ComponenteY]
    ...
\`\`\`

## 3. Hallazgos por Categoría

### 🔴 Críticos (Prioridad Alta)
*   [ ] Problema A en `archivo.ts` (Impacto de seguridad/rendimiento)
*   ...

### 🟡 Mejoras Necesarias (Mantenibilidad)
*   [ ] Refactorización de componente `Dios.tsx`
*   [ ] Unificación de estilos (Tailwind vs CSS Modules)

### 🟢 Sugerencias de Optimización
*   ...

## 4. Análisis Específico del Stack
*   **TypeScript**: ...
*   **Astro/Integraciones**: ...

## 5. Plan de Reparación Sugerido (Next Steps)
Copia esto a un artefacto `task.md` si es aprobado.
- [ ] Tarea 1: Corregir error crítico en...
- [ ] Tarea 2: Limpiar TODOs en módulo...

Fase 4: Limpieza

1. Elimina el archivo temporal audit_raw.json.
2. Notifica al usuario con el resumen y pregunta si quiere proceder con el Plan de Reparación.

Consejos para la IA

• Sé crítico pero constructivo. No solo señales el error, explica por qué es malo (ej. "esto causa re-renders innecesarios").
• Agrupa problemas. Si 10 archivos tienen el mismo error de estilo, repórtalo como un problema sistémico, no 10 individuales.
• Prioriza. Un bug de lógica > un estilo feo.