CommunityProgramación y desarrollogithub.com

scale-check

Auditoría de preparación para producción de 7 puntos sobre el código base: índices y consultas en bucles, caché de lectura compartida, ejecución como dos copias, trabajo lento dentro de solicitudes web, copias de seguridad y restauración, caché pública vs. privada, y límites de tasa en puntos finales públicos o de pago. Ejecútalo en modo plan con /scale-check, seguido opcionalmente de una carpeta o ruta para enfocar.

¿Qué es scale-check?

Scale Check es una habilidad de auditoría de preparación para producción de solo lectura que analiza un código base contra siete preguntas críticas de escalabilidad. Ayuda a los desarrolladores a identificar problemas potenciales como consultas N+1, falta de índices, estado en memoria que impide la escalabilidad horizontal, trabajo sincrónico lento en puntos finales web, configuración de copias de seguridad faltante, riesgos de fuga de caché y límites de tasa faltantes. La habilidad admite la ejecución en modo plan con Claude Code, escanea todo el repositorio o una ruta específica, y produce un informe detallado con hallazgos puntuales (incluyendo ubicaciones exactas de archivos) y un plan de remediación priorizado. Es útil para revisiones de arquitectura previas al lanzamiento, garantía de calidad de escalabilidad o sesiones de refactorización de rendimiento. La salida incluye una tarjeta de puntuación y enumera los pasos de acción comenzando por la supervivencia (copias de seguridad, límites de tasa).

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/eboywonder/missing-readme-skills/tree/main/scale-check

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Scale Check — Auditoría de Preparación para Producción de 7 Puntos

Estás ejecutando /scale-check en modo plan de solo lectura. Tu trabajo es inspeccionar el código base contra las 7 preguntas de escalabilidad a continuación y presentar en la pantalla del usuario un plan de verificación y corrección claro y priorizado.

Alcance objetivo: $ARGUMENTS (Si está vacío, audita todo el repositorio).


Reglas de Hierro (Leer Antes de Escanear)

  1. Mirar, no modificar: Estás estrictamente en modo de diagnóstico y planificación. NO crees, edites ni elimines ningún archivo. NO ejecutes migraciones de base de datos, comandos que cambien el estado, ni solicitudes de red.
  2. Los hallazgos son pistas para verificar, no hechos: El análisis estático del repositorio no puede ver paneles de control en la nube externos, reglas de CDN, políticas de WAF o configuraciones de bases de datos gestionadas. Enmarca cada problema que detectes como una pista para verificar, nunca como un error garantizado.
  3. Siempre cita ubicaciones exactas: Cada pista de código debe incluir ruta/al/archivo:línea y el símbolo o consulta específica involucrada. Si algo falta en el código base, informa explícitamente: "No encontrado en el repositorio — verifica en tu proveedor de hosting/nube."
  4. Arregla uno a la vez, comenzando por la supervivencia: Siempre ordena el plan de remediación final comenzando con Copias de seguridad (Pregunta 5) y Límites de tasa (Pregunta 7), luego cualquier dato privado que se filtre a través de una caché compartida (Pregunta 6), luego las preguntas restantes en el orden en que normalmente afectan a una aplicación en crecimiento: índices y bucles (P1), lecturas compartidas (P2), ejecución como dos copias (P3), trabajo lento en solicitudes (P4) y almacenamiento en caché de activos públicos (el resto de P6).

Flujo de Trabajo de Ejecución

Fase 1: Identificar la Pila (Pase Rápido)

Antes de verificar las 7 preguntas, identifica rápidamente la pila del proyecto para buscar en los lugares correctos:

  • Manifiestos y Frameworks: Revisa package.json, pyproject.toml, requirements.txt, go.mod, Cargo.toml o Gemfile.
  • Base de Datos y ORM: Localiza schema.prisma, archivos de esquema de Drizzle, modelos de TypeORM/Sequelize, archivos de SQLAlchemy/Alembic, models.py de Django o migraciones .sql sin procesar.
  • Puntos de Entrada y Rutas: Localiza rutas de API (app/api/, pages/api/, src/routes/, controllers/, routers/, main.py, cmd/).
  • Infraestructura y Configuración: Revisa Dockerfile, docker-compose.yml, vercel.json, next.config.*, fly.toml, render.yaml, nginx.conf, .github/workflows/ y README.md.

Fase 2: Investigar las 7 Preguntas

Ejecuta pases dirigidos de Glob, Grep y Read para cada una de las 7 preguntas a continuación. No omitas ninguna pregunta.


Las 7 Preguntas

Pregunta 1: Índices y Consultas Dentro de Bucles

  • Forma Corta de la Tarjeta: "Páginas que buscan o listan datos: ¿están las columnas indexadas y hay alguna consulta dentro de un bucle?"
  • Pregunta de Diagnóstico Completa: ¿Dónde la aplicación lista, filtra, ordena o busca registros? ¿Están las columnas de la base de datos subyacentes (WHERE, JOIN, ORDER BY, claves foráneas) respaldadas por índices en el esquema, y algún punto final ejecuta una consulta de base de datos o API dentro de un bucle (el problema N+1) o recupera filas ilimitadas sin paginación?
  • Dónde y Cómo Buscar:
    • Esquema vs. Consultas: Compara consultas de lista/búsqueda (findMany, select, filter, WHERE, ILIKE, ORDER BY) con definiciones de índice (@@index, index(), CREATE INDEX, db_index=True). Ten en cuenta que Prisma/SQLAlchemy a menudo no indexan automáticamente claves foráneas o columnas de ordenación a menos que se declaren explícitamente.
    • Bucles con E/S: Busca en los controladores de ruta y funciones de servicio for (, for await, .map(async, forEach(async o comprensiones de listas que llamen a db., prisma., supabase., session.execute o fetch( dentro del cuerpo de la iteración.
    • Lecturas Ilimitadas: Verifica si los puntos finales de lista imponen un límite take / limit o si una sola solicitud puede cargar una tabla completa en memoria.
  • Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
    • Los índices pueden haber sido creados manualmente en consolas de producción SQL sin ser confirmados en los archivos de migración.
    • Las tablas de búsqueda pequeñas (por ejemplo, <50 roles o categorías estáticas) no serán un cuello de botella por falta de índice, aunque los bucles N+1 sobre datos generados por el usuario sí lo serán.

Pregunta 2: Lecturas Compartidas Repetidas

  • Forma Corta de la Tarjeta: "Consultas de lectura que se ejecutan a menudo y devuelven el mismo resultado para todos."
  • Pregunta de Diagnóstico Completa: ¿Qué consultas de lectura de alto tráfico calculan o recuperan exactamente los mismos datos públicos para cada visitante en cada solicitud, como feeds de página de inicio, catálogos de productos, configuración global, tablas de clasificación o recuentos públicos, sin almacenar en caché el resultado en memoria, Redis/KV o la caché de datos del framework?
  • Dónde y Cómo Buscar:
    • Inspecciona rutas públicas, páginas de inicio, cargadores de diseño y middleware global que accedan a la base de datos primaria en cada carga de página sin parámetros específicos del usuario (userId, sessionId, orgId).
    • Busca agregaciones costosas (COUNT(*), SUM(), uniones de múltiples tablas) ejecutándose en vivo en puntos finales públicos.
    • Busca primitivas de caché existentes (unstable_cache, 'use cache', revalidate, Redis get/set, @lru_cache, Cache-Control: s-maxage) para ver si las lecturas compartidas ya están envueltas.
  • Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
    • Una CDN ascendente (Cloudflare, CloudFront, Fastly) podría ya estar almacenando en caché rutas públicas completas en el borde a través de reglas de página del panel de control.

Pregunta 3: Ejecutándose como Dos Copias (Ausencia de Estado y Almacenamiento Local)

  • Forma Corta de la Tarjeta: "¿Podría la aplicación ejecutarse como dos copias y qué vive en la memoria de un servidor o en su disco?"
  • Pregunta de Diagnóstico Completa: Si el tráfico aumenta y se inicia una segunda instancia de servidor detrás de un balanceador de carga (o se despliega en instancias serverless de autoescalado), ¿qué se rompe porque el estado se almacena en la RAM de un solo proceso o se escribe en el sistema de archivos local de un solo contenedor?
  • Dónde y Cómo Buscar:
    • Estado de Memoria en el Proceso: Busca new Map(), new Set() a nivel de módulo, arreglos/objetos mutables globales, almacenes de sesión en memoria (MemoryStore), contadores de límite de tasa locales o pub/sub en el proceso (EventEmitter, conjuntos Set de WebSocket no puenteados) que asumen que todos los usuarios alcanzan el mismo proceso Node/Python/Go.
    • Dependencia de Disco Local: Busca escrituras de archivos locales (fs.writeFile, fs.createWriteStream, open(..., 'w'), multer.diskStorage, almacenamiento /tmp o ./uploads) y bases de datos locales integradas (sqlite, better-sqlite3, archivos .db) utilizadas para datos de tiempo de ejecución mutables.
    • Trabajos Programados en el Proceso: Busca node-cron, setInterval o APScheduler iniciados dentro del punto de entrada principal del servidor web, lo que dispararía trabajos duplicados si dos instancias se ejecutan simultáneamente.
  • Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
    • Los Maps a nivel de módulo utilizados estrictamente como cachés de solo lectura con un TTL (o clientes SDK singleton perezosos como Prisma/Stripe) son seguros en múltiples instancias.
    • Las aplicaciones de un solo VPS que utilizan un volumen persistente montado y sesiones fijas pueden ejecutarse intencionalmente como un solo nodo: indica claramente la compensación en lugar de llamarlo roto.

Pregunta 4: Trabajo Sincrónico Lento Dentro de Solicitudes Web

  • Forma Corta de la Tarjeta: "En cualquier lugar donde una solicitud web haga algo lento, como una llamada de IA, un correo electrónico o un archivo."
  • Pregunta de Diagnóstico Completa: ¿Dónde una solicitud HTTP mantiene la conexión del usuario abierta mientras espera trabajo lento, impredecible o pesado, como una llamada de generación LLM/IA, envío de correos electrónicos transaccionales, generación de PDFs, redimensionamiento de imágenes/vídeos, análisis de archivos CSV grandes o encadenamiento de múltiples webhooks de terceros, antes de devolver una respuesta?
  • Dónde y Cómo Buscar:
    • Rastrea controladores POST/PUT, Server Actions y manejadores de webhook desde el inicio de la solicitud hasta la devolución de la respuesta.
    • Busca llamadas await bloqueantes a SDKs de IA (openai, @anthropic-ai, @google/genai, ai), proveedores de correo electrónico (resend, nodemailer, sendgrid, postmark), procesadores de medios/archivos (sharp, ffmpeg, puppeteer, pdfkit) o APIs externas dentro de la ruta de solicitud crítica.
    • Verifica si el proyecto tiene una cola de fondo o un sistema de trabajadores asíncrono (bullmq, inngest, trigger.dev, celery, sidekiq, waitUntil) y si las llamadas lentas realmente lo utilizan o lo evitan.
  • Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
    • Los puntos finales de IA en streaming (streamText, SSE, respuestas fragmentadas) están diseñados para permanecer abiertos mientras transmiten tokens al cliente; márcalos solo si realizan un pre/procesamiento sincrónico pesado o carecen de límites de tiempo de espera.

Pregunta 5: Copias de Seguridad, Réplicas y Ruta de Restauración

  • Forma Corta de la Tarjeta: "Qué copias de seguridad o réplicas existen, dónde, con qué frecuencia y cómo restaurar. Si no está en el repositorio, dilo."
  • Pregunta de Diagnóstico Completa: ¿Qué copias de seguridad o réplicas automatizadas de base de datos y almacenamiento existen, dónde se almacenan, con qué frecuencia se ejecutan y existe un procedimiento documentado y probado para restaurarlas? Si la configuración de copia de seguridad no es visible en el repositorio, indícalo explícitamente.
  • Dónde y Cómo Buscar:
    • Busca en archivos de infraestructura (docker-compose.yml, Terraform .tf, Pulumi, CloudFormation, fly.toml, .github/workflows/, scripts/, Makefile, crontab) pg_dump, mysqldump, sqlite3 .backup, wal-g, litestream, sincronizaciones de copia de seguridad S3 o configuraciones de réplica.
    • Busca en README.md, CONTRIBUTING.md, docs/ o runbooks/ cualquier mención de horarios de copia de seguridad, Recuperación a un Punto en el Tiempo (PITR) o comandos de restauración.
  • Regla Obligatoria para la Pregunta 5:
    • En la mayoría de las aplicaciones modernas que utilizan bases de datos gestionadas (Supabase, Neon, RDS, PlanetScale, Railway, MongoDB Atlas), la configuración de copia de seguridad vive en el panel de control de la nube, no en git.
    • Si no encuentras configuraciones de copia de seguridad e instrucciones de restauración en el repositorio, dilo claramente: "No se encontró configuración de copia de seguridad ni runbook de restauración en el repositorio. Verifica en el panel de control de tu proveedor de base de datos que las copias de seguridad automatizadas/PITR estén habilitadas, verifica la frecuencia de retención y realiza una restauración de prueba en una base de datos de staging."

Pregunta 6: Activos Públicos vs. Almacenamiento en Caché de Datos Privados

  • Forma Corta de la Tarjeta: "Qué archivos son iguales para cada usuario y qué nunca debe almacenarse en caché."
  • Pregunta de Diagnóstico Completa: ¿Están los archivos estáticos que son idénticos para cada usuario (paquetes, fuentes, imágenes públicas, páginas de marketing) configurados para almacenarse en caché de forma agresiva en el borde de CDN/navegador, y las respuestas autenticadas o específicas del usuario (datos de cuenta, paneles, facturación, tokens de autenticación) están estrictamente protegidas de ser almacenadas en una caché compartida?
  • Dónde y Cómo Buscar:
    • Fugas de Caché Peligrosas (riesgo P0): Verifica si alguna ruta que devuelve datos personalizados, estado de sesión o JSON privado establece Cache-Control: public o s-maxage sin private o no-store, o si el almacenamiento en caché de rutas del framework (export const revalidate = ..., force-static) está accidentalmente habilitado en una ruta que lee cookies/encabezados para un usuario específico.
    • Activos Estáticos Sin Caché: Revisa next.config.*, vercel.json, nginx.conf, static() de Express o ayudantes de carga S3/CDN para ver si los activos estáticos y los medios públicos subidos por el usuario establecen encabezados Cache-Control inmutables o de larga duración.
  • Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
    • Frameworks como Next.js, Remix y Vite automáticamente crean huellas digitales y almacenan en caché los activos de compilación bajo /_next/static o /assets en el momento del despliegue, incluso sin encabezados personalizados en el repositorio.

Pregunta 7: Puntos Finales Públicos y de Pago (Límites de Tasa y Protecciones de Costos)

  • Forma Corta de la Tarjeta: "Qué puntos finales son públicos o llaman a un servicio de pago, y algo limita la frecuencia con que un usuario puede llamarlos."
  • Pregunta de Diagnóstico Completa: ¿Qué rutas pueden ser llamadas sin autenticación (inicio de sesión, registro, enlaces mágicos, restablecimiento de contraseña, búsqueda pública, formularios de contacto, webhooks) o desencadenan un servicio medido/de pago (APIs de LLM, SMS/OTP, envío de correo electrónico, almacenamiento de archivos, APIs de datos de pago), y qué impone en el código límites de tasa por IP o por usuario, límites de tamaño del cuerpo de la solicitud y límites de gasto/token?
  • Dónde y Cómo Buscar:
    • Inventario de Puntos Finales de Alto Riesgo: Lista todas las rutas públicas de autenticación/formulario y cada punto final que llame a una API externa facturada o desencadene escrituras pesadas en la base de datos.
    • Verifica Limitadores de Tasa: Busca dependencias y middleware para bibliotecas de limitación de tasa (@upstash/ratelimit, express-rate-limit, rate-limiter-flexible, slowapi, django-ratelimit, rack-attack, golang.org/x/time/rate) y verifica si están realmente adjuntas a las rutas de riesgo.
    • Verifica Límites de Entrada y Gasto: En puntos finales de IA o carga de archivos, verifica si max_tokens / maxOutputTokens, la validación de longitud del prompt (por ejemplo, Zod .max()) y los límites de tamaño de archivo se aplican antes de llamar al proveedor.
  • Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
    • La limitación de tasa puede aplicarse aguas arriba a través de Cloudflare WAF, AWS API Gateway, Vercel Firewall o Nginx reverse proxy fuera del repositorio de la aplicación. Si no existe un limitador en el repositorio, márcalo como una pista de alta prioridad para verificar aguas arriba o agregarlo en el middleware.

Formato de Salida (Pon Este Plan en Pantalla)

Presenta tu informe utilizando las secciones exactas a continuación. Mantén un tono directo, tranquilo y práctico.

1. Instantánea de la Pila y el Alcance

  • Pila Detectada: [Framework, Lenguaje, BD/ORM, Pistas de Hosting/Infra]
  • Alcance Escaneado: [Repositorio completo o ruta específica]
  • Recordatorio: Estos hallazgos son pistas para verificar, no errores garantizados. La infraestructura configurada en paneles de control en la nube (copias de seguridad de BD gestionadas, reglas de CDN, límites de tasa de WAF) no aparecerá en git.

2. La Tarjeta de Puntuación de las 7 Preguntas

#PreguntaEstadoMáxima Pista / Observación
P1Índices de búsqueda/lista y consultas en bucles[PISTA A VERIFICAR] / [PARECE CUBIERTO]Resumen de 1 línea
P2Lecturas compartidas frecuentes que devuelven los mismos datos[PISTA A VERIFICAR] / [PARECE CUBIERTO]Resumen de 1 línea
P3Ejecución de dos copias (estado de memoria y disco)[PISTA A VERIFICAR] / [PARECE CUBIERTO]Resumen de 1 línea
P4Trabajo sincrónico lento dentro de solicitudes web[PISTA A VERIFICAR] / [PARECE CUBIERTO]Resumen de 1 línea
P5Copias de seguridad, réplicas y ruta de restauración[PISTA A VERIFICAR] / [PARECE CUBIERTO]Resumen de 1 línea
P6Almacenamiento en caché de activos públicos vs. datos privados[PISTA A VERIFICAR] / [PARECE CUBIERTO]Resumen de 1 línea
P7Puntos finales públicos/de pago, límites de tasa y protección de costos[PISTA A VERIFICAR] / [PARECE CUBIERTO]Resumen de 1 línea

3. Plan de Acción Priorizado

Comienza siempre con la Supervivencia (P5 → P7 → P6), luego el resto en orden.

🔴 Paso 1 — Supervivencia (Arreglar Primero)

  • [P5] Copias de seguridad y restauración: [Instrucción específica del repositorio o: "No se encontró configuración de copia de seguridad ni runbook de restauración en el repositorio — verifica en el panel de control del proveedor de BD."]
  • [P7] Límites de tasa en puntos finales públicos/de pago: [Lista de rutas de alto riesgo y si tienen limitación de tasa. Si no hay limitador en el repositorio: "No se encontró limitación de tasa en el repositorio; agrega middleware o verifica las reglas de WAF ascendentes."]
  • [P6] Fuga de caché de datos privados: [Cita cualquier ruta que establezca Cache-Control: public en datos privados. Si no se encuentra: "No se detectaron fugas de caché evidentes."]

🟡 Paso 2 — Escalado (Siguiente)

  • [P1] Índices de base de datos y consultas en bucles: [Cita columnas faltantes indexadas o bucles N+1. Si no se encuentra: "No se detectaron problemas de índice o N+1."]
  • [P2] Lecturas compartidas sin caché: [Cita datos públicos costosos servidos en vivo. Si no se encuentra: "No se detectaron cuellos de botella de lectura compartida evidentes."]
  • [P3] Estado que impide la ejecución de dos copias: [Cita estado en memoria o dependencias de disco local. Si no se encuentra: "La aplicación parece ser sin estado."]
  • [P4] Trabajo lento en la ruta de solicitud: [Cita llamadas bloqueantes a IA/correo electrónico/archivos que deberían ser asíncronas. Si no se encuentra: "No se detectó trabajo sincrónico lento."]

4. Notas Técnicas y Dependencias Externas

Lista cualquier configuración que deba verificarse fuera del repositorio (CDN, WAF, paneles de BD, etc.).

Skills relacionados