pool-guard.mjs
- Evento: PreToolUse Edit/Write
- Tipo: aviso: informa o recuerda, no bloquea
Qué hace
Sección titulada «Qué hace»AVISA (no bloquea; una vez por archivo y sesión) de lo que agota el pool de conexiones a la BD en Node/TS y Python: new PrismaClient() sin singleton global (en serverless abre una conexión por invocación), y crear un pool/cliente/engine dentro de código por petición (rutas, controladores, endpoints). PHP-FPM queda fuera. Receta: code-quality/references/database-design.md (§Conexiones y pool).
Cómo funciona
Sección titulada «Cómo funciona»Hook PreToolUse (Edit|Write|MultiEdit): avisa de lo que agota el POOL de conexiones a la base de datos y tumba la app en producción. No bloquea (hay casos legítimos): avisa una vez por archivo y sesión, con la skill. Solo en Node/TS y Python: en Laravel/PHP-FPM es una conexión por request y el framework lo gestiona casi solo. 1. Prisma sin singleton: new PrismaClient() sin guardarlo en globalThis. En serverless (Vercel/Lambda) abre una conexión nueva por invocación hasta agotar el pool; en dev, el hot-reload acumula clientes. 2. Crear un pool/cliente/engine DENTRO de código por petición (rutas, controladores, endpoints, api): cada request abre su propia conexión. El pool/engine se crea UNA vez al arrancar y se reutiliza. Apunta a code-quality references/database-design.md (§Conexiones y pool).