code-auditor

code-auditor — Auditoría de Código del Proyecto

Skill híbrida que combina un script Python para detección mecánica de hallazgos con instrucciones para que el agente haga análisis semántico profundo.

Recursos

• resources/​checks-js.md — Criterios detallados para JavaScript
• resources/​checks-css.md — Criterios detallados para CSS
• resources/​checks-json.md — Criterios detallados para JSONs de escenas/​desafíos
• resources/​checks-pwa.md — Criterios para PWA y Service Worker
• resources/​checks-cross.md — Checks transversales (cross-cutting)
• resources/​informe-formato.md — Template del informe de auditoría
• scripts/​auditar.py — Script de detección automática (solo lectura)

---

Decision Tree

¿Qué necesitás auditar?
  │
  ├── Todo el proyecto                    →  MODO 1: AUDITORÍA COMPLETA
  │
  ├── Una categoría específica            →  MODO 2: AUDITORÍA POR ÁREA
  │   (js, css, json, pwa, cross)
  │
  └── Un archivo en particular            →  MODO 3: AUDITORÍA DE ARCHIVO

---

Modo 1 — AUDITORÍA COMPLETA

Objetivo: Escanear todo el proyecto en busca de defectos y mejoras.

Pasos

1. Ejecutar el script automático:

python .agents/​skills/​code-auditor/​scripts/​auditar.py

1. Leer el JSON de salida del script (hallazgos mecánicos).

2. Para cada categoría (js, css, json, pwa, cross), cargar el recurso correspondiente (resources/​checks-{cat}.md) y hacer análisis semántico:

   • Leer los archivos relevantes del proyecto
   • Aplicar los criterios de análisis semántico listados en el recurso
   • Anotar hallazgos que el script no puede detectar

3. Consolidar hallazgos (automáticos + semánticos) en informe usando resources/​informe-formato.md.

4. Presentar informe al usuario y preguntar qué corregir.

IMPORTANTE: Cargá los archivos de a uno para no saturar el contexto. Emití hallazgos parciales por categoría antes de pasar a la siguiente.

---

Modo 2 — AUDITORÍA POR ÁREA

Objetivo: Auditar en profundidad una categoría específica.

Categorías válidas

Pasos

1. Ejecutar script filtrado:

python .agents/​skills/​code-auditor/​scripts/​auditar.py --categoria js

1. Cargar resources/​checks-{categoria}.md completo.

2. Leer los archivos del proyecto relevantes a esa categoría.

3. Aplicar todos los criterios (mecánicos del script + semánticos del recurso).

4. Emitir informe usando resources/​informe-formato.md.

---

Modo 3 — AUDITORÍA DE ARCHIVO

Objetivo: Revisar un archivo específico a fondo.

Pasos

1. Ejecutar script con archivo:

python .agents/​skills/​code-auditor/​scripts/​auditar.py --archivo js/​GameEngine.js

1. Determinar la categoría del archivo por extensión/​ubicación:

   • .js → cargar resources/​checks-js.md
   • .css → cargar resources/​checks-css.md
   • .json (en datos/) → cargar resources/​checks-json.md
   • service-worker.js / manifest.json → cargar resources/​checks-pwa.md

2. Leer el archivo completo.

3. Aplicar todos los criterios de su categoría + checks cross-cutting relevantes.

4. Emitir informe usando resources/​informe-formato.md.

---

Ejemplo de Flujo

Usuario: "Auditá el código JavaScript del proyecto"

1. python .agents/​skills/​code-auditor/​scripts/​auditar.py --categoria js
2. Leer resources/​checks-js.md
3. Leer cada módulo en js/ → aplicar criterios semánticos
4. Consolidar hallazgos automáticos + semánticos
5. Presentar informe categorizado
6. "¿Querés que corrija alguno de estos hallazgos?"

---

Reglas de Oro

1. Informe primero, correcciones después — nunca corregir sin aprobación explícita
2. El script es de solo lectura — no modifica ningún archivo del proyecto
3. Análisis semántico obligatorio — el script cubre lo mecánico, el agente debe complementar leyendo el código real y aplicando los criterios de resources/
4. Carga progresiva — en auditoría completa, procesar una categoría a la vez
5. Contexto del proyecto — respetar las convenciones de AGENTS.md como fuente de verdad
6. Voseo rioplatense — el informe se escribe en español rioplatense
7. Usar --help — ante dudas sobre el script, ejecutar auditar.py --help
8. Prohibido commitear automáticamente — El agente NO debe realizar commits por su cuenta después de aplicar correcciones. El commit lo gestiona el usuario o debe pedirse como un paso EXPLÍCITO y separado. No asumas que "terminar el laburo" implica commitear.
9. Uso de artefactos para informes — Si el entorno soporta la creación de "artefactos" (archivos de respuesta estructurada), entregá los informes usándolos. Si no, presentalos normalmente en la conversación.