performance-audit
Un skill para Claude Code (y una regla compatible con Cursor) que audita estáticamente una base de código NestJS + Next.js + Prisma + PostgreSQL en busca de anti-patrones de rendimiento y genera un informe clasificado por gravedad.
No es necesario tener el servidor en ejecución: funciona escaneando el código fuente, no perfilando una aplicación en vivo.
Qué detecta
35 reglas distribuidas en 5 capas:
| Capa | Cubre |
|---|---|
| D — Prisma / acceso a datos | Consultas N+1, findMany sin límite, sobrecarga de datos, SQL sin límites, trabajo lento dentro de transacciones, E/S paralela sin límite |
| A — API NestJS | Llamadas síncronas bloqueantes en la ruta de la solicitud, endpoints sin paginación, llamadas externas secuenciales, cachés en memoria sin límite |
| F — Next.js / React | Bundles pesados del cliente no divididos, 'use client' innecesario, obtención inicial de datos desde el cliente, falta de debounce en campos de búsqueda |
| S — Esquema PostgreSQL | Índices faltantes en claves foráneas / campos de consulta activos, búsqueda ILIKE sin anclaje, columnas vectoriales no indexables |
| G — Complejidad algorítmica | Patrones O(n²): búsquedas lineales repetidas en bucles, comparaciones pareadas anidadas, ordenamientos dentro de bucles, copias con acumulador mediante spread, clonaciones con JSON.parse(JSON.stringify()) |
Cada regla se asigna a un patrón de grep, pero cada coincidencia se verifica en contexto antes de ser reportada; los falsos positivos conocidos (consultas acotadas, colecciones pequeñas de tamaño fijo, await secuenciales con dependencia real de datos, etc.) se filtran. Nunca modifica el código — solo genera un informe.
Instalación
Copia esta carpeta dentro de tu proyecto:
# Claude Code
cp -r performance-audit /ruta/a/tu-proyecto/.claude/skills/
# Cursor
cp performance-audit.mdc /ruta/a/tu-proyecto/.cursor/rules/
Eso es todo — sin dependencias, sin paso de compilación.
Uso
Simplemente pregunta, en cualquiera de las herramientas:
revisa el rendimiento encuentra consultas lentas por qué la aplicación va lenta audita el rendimiento del módulo candidato
Puedes acotarlo ("revisa el rendimiento solo en packages/api") o pedir un pase rápido ("revisión rápida de rendimiento" ejecuta solo las reglas de gravedad Alta).
Requisitos
- Detecta tu pila automáticamente y omite las capas que no aplican (ej. sin archivos
*.prisma→ las capas D y S se saltan). La capa G (complejidad algorítmica) siempre se ejecuta, ya que es TS/JS puro, no específico de un framework. - Construido y ajustado para un monorepo NestJS + Next.js + Prisma + PostgreSQL, pero las capas D/A/F/S se adaptan correctamente a pilas parciales (ej. NestJS sin Next.js), y G funciona en cualquier proyecto TS/JS.
Resultado
Un informe en markdown clasificado como Alta → Media → Baja, cada hallazgo con archivo:línea, por qué es lento y una solución concreta:
# Auditoría de Rendimiento — 2026-07-09
Capas escaneadas: D, A, F, S, G (omitidas: ninguna)
## Alta
1. `src/foo.service.ts:123` — [D1] N+1: una consulta por candidato en `.map(async)`
Por qué es lento: N candidatos → N+1 viajes redondos; crece linealmente con los datos.
Solución: un solo `findMany` con `where: { id: { in: ids } }`, o `include` la relación.
Los informes con más de 20 hallazgos también se guardan en performance-audit-report.md en la raíz del repositorio.
Licencia
MIT — úsalo, haz fork, adapta las reglas a tu propia pila.