performance-audit
Un Claude Code skill (et une Cursor règle correspondante) qui audite statiquement une base de code NestJS + Next.js + Prisma + PostgreSQL pour détecter les anti-patterns de performance et produit un rapport classé par sévérité.
Aucun serveur n'a besoin d'être en cours d'exécution — il fonctionne en analysant le code source, pas en profilant une application en direct.
Ce qu'il trouve
35 règles réparties sur 5 couches :
| Couche | Couvre |
|---|---|
| D — Prisma / accès aux données | Requêtes N+1, findMany sans limite, sur-récupération, SQL brut sans limite, travail lent dans les transactions, E/S parallèles sans limite |
| A — API NestJS | Appels synchrones bloquants dans le chemin de requête, points d'accès de liste sans pagination, appels externes séquentiels, caches en mémoire sans limite |
| F — Next.js / React | Bundles clients lourds non fractionnés, 'use client' inutile, récupération de données initiale côté client, absence de debounce sur les champs de recherche |
| S — Schéma PostgreSQL | Index manquants sur les clés étrangères / champs de requête chauds, recherche ILIKE non ancrée, colonnes vectorielles non indexables |
| G — Complexité algorithmique | Patterns O(n²) : recherches linéaires répétées dans des boucles, comparaisons par paires imbriquées, tris dans des boucles, copies par accumulateur-étalement, clones JSON.parse(JSON.stringify()) |
Chaque règle correspond à un motif grep, mais chaque occurrence est vérifiée en contexte avant d'être signalée — les faux positifs connus (requêtes limitées, collections de taille fixe, attentes séquentielles avec une vraie dépendance de données, etc.) sont filtrés. Il ne modifie jamais le code — il produit uniquement un rapport.
Installation
Copiez ce dossier dans votre projet :
# Claude Code
cp -r performance-audit /chemin/vers/votre-projet/.claude/skills/
# Cursor
cp performance-audit.mdc /chemin/vers/votre-projet/.cursor/rules/
C'est tout — aucune dépendance, aucune étape de build.
Utilisation
Il suffit de demander, dans l'un ou l'autre outil :
vérifie les performances trouve les requêtes lentes pourquoi l'application est lente audite les performances du module candidat
Vous pouvez limiter la portée ("vérifie les performances dans packages/api uniquement") ou demander un passage rapide ("vérification rapide des performances" exécute seulement les règles de sévérité Haute).
Prérequis
- Détecte automatiquement votre stack et ignore les couches qui ne s'appliquent pas (ex : pas de fichiers
*.prisma→ les couches D et S sont ignorées). La couche G (complexité algorithmique) s'exécute toujours car elle utilise du TS/JS pur, non spécifique à un framework. - Construit et réglé sur un monorepo NestJS + Next.js + Prisma + PostgreSQL, mais les couches D/A/F/S se dégradent gracieusement sur des piles partielles (ex : NestJS sans Next.js), et G fonctionne sur tout projet TS/JS.
Sortie
Un rapport markdown classé Haute → Moyenne → Basse, chaque résultat avec fichier:ligne, pourquoi c'est lent, et un correctif concret :
# Audit de performance — 2026-07-09
Couches analysées : D, A, F, S, G (ignorées : aucune)
## Haute
1. `src/foo.service.ts:123` — [D1] N+1 : une requête par candidat dans `.map(async)`
Pourquoi c'est lent : N candidats → N+1 allers-retours ; croît linéairement avec les données.
Correctif : un seul `findMany` avec `where: { id: { in: ids } }`, ou `include` la relation.
Les rapports de plus de 20 résultats sont également sauvegardés dans performance-audit-report.md à la racine du dépôt.
Licence
MIT — utilisez-le, forkez-le, adaptez les règles à votre propre stack.