~/codigoagente

Breakscale: simulador de diseño de sistemas gratis para ver dónde se rompe tu arquitectura

Breakscale es un simulador de diseño de sistemas open source: colocas balanceadores, cachés, bases de datos y colas en un lienzo, los conectas, subes el tráfico y miras en tiempo real dónde y por qué se rompe tu arquitectura. Las latencias p50, p95 y p99, las colas y los errores no son dibujos: salen de una simulación de eventos discretos donde cada petición es un objeto que recorre el sistema.

Es gratis, tiene licencia MIT y se usa de tres formas: en el navegador, como extensión de VS Code y como servidor MCP para que Claude Code, Codex o Cursor conviertan la arquitectura de tu repositorio en un diseño y te digan qué falla primero. Clonamos el repositorio workersio/breakscale (commit 283ddfe del 11 de noviembre de 2026; extensión y servidor MCP en la versión 0.1.1), lo ejecutamos en local y medimos con su propio motor el ejemplo más didáctico: la tormenta de reintentos.

El ejemplo Retry storm a 100 peticiones por segundo: la base de datos trabaja al 99,9 % y el sistema no completa ninguna petición · codigoagente

Qué es Breakscale

  • Repositorio: github.com/workersio/breakscale, unas 2.200 estrellas a mediados de noviembre de 2026.
  • Licencia: MIT para la aplicación, la extensión de VS Code (extension/LICENSE) y el servidor MCP (mcp/LICENSE). La única excepción es la fuente manuscrita Caveat incluida en public/fonts/Caveat/, que va con su propia licencia SIL Open Font License 1.1. Puedes usarlo, modificarlo y desplegarlo en proyectos comerciales conservando el aviso de copyright.
  • Stack: React 19, TypeScript y Vite; el lienzo es SVG hecho a mano y las gráficas se dibujan sin librería de gráficos. El motor vive en src/sim y no depende de React ni del DOM.
  • Contenido: 33 componentes y 23 ejemplos: 16 escenarios que aíslan un fallo concreto y 7 reconstrucciones de arquitecturas públicas (Netflix, Spotify, Discord, Uber, Twitter/X, Stripe y WhatsApp), que el propio proyecto presenta como diagramas didácticos, no como información interna.
  • Privacidad: no hay cuenta. Los diseños se quedan en tu navegador salvo que los compartas, y un enlace compartido se cifra antes de salir, con la clave en el fragmento # de la URL que el navegador nunca envía al servidor. La web cuenta visitas con la analítica sin cookies de Vercel; la extensión y el servidor MCP no llevan analítica.

Si te interesa la teoría, la guía visual System Design 101 explica los conceptos en diagramas. Breakscale es la otra mitad: en vez de leer que «una caché ayuda», bajas la tasa de aciertos y ves a la base de datos derretirse.

Qué simula y por qué sus números son creíbles

Muchas herramientas de diagramas pintan una flecha roja cuando algo «parece» saturado. Breakscale ejecuta la simulación. Según el README y el código de src/sim, el motor se apoya en cinco reglas:

ReglaQué significa en la práctica
Huecos de servicio finitosCada componente atiende `capacity` peticiones a la vez por cada una de sus `instances`. Lo que sobra espera en una cola FIFO real y lo que no cabe en la cola se descarta.
Tiempo de servicio variableMedia más coeficiente de variación, muestreado de una distribución gamma. Esa varianza es la que separa el p99 de la media.
El trabajo abandonado sigue gastandoSi el cliente se cansa de esperar, el servidor de abajo sigue procesando una petición que ya nadie quiere. De ahí salen las tormentas de reintentos.
Las colas confirman al instanteUna petición que entra en una cola cuenta como éxito y el mensaje queda en el búfer de los workers, así que el atraso es real y lo ves crecer y vaciarse.
Percentiles medidosp50, p95 y p99 salen de un búfer circular de latencias reales, nunca de multiplicar la media por una constante.

Las ejecuciones son deterministas: con la misma semilla y la misma topología el resultado se repite exactamente. Los tests comprueban que no se pierden peticiones, que el desglose de fallos suma el total y que ningún valor es NaN o infinito. Además hay controles de caos (tirar un nodo, ralentizarlo, forzar una tasa de errores o cortar un enlace) y una explicación en lenguaje llano de cada métrica al pasar el ratón.

Menú › Examples: cada ejemplo aísla un fallo. Los botones Incidents y Learning path llevan a más escenarios · codigoagente

Cómo usarlo en el navegador o en VS Code

La forma más rápida es la web oficial, breakscale.tech: eliges un ejemplo y arrastras el control Offered load (peticiones por segundo, en escala logarítmica de 1 a 5.000) hasta que algo se pone rojo. No pide registro.

Si prefieres no salir del editor, instala Breakscale desde el Marketplace de VS Code y ejecuta Open Breakscale en la paleta de comandos. Abre el mismo simulador en un panel junto a tu código, con el mismo motor y los mismos ejemplos, y funciona sin conexión. Los diseños se guardan en el almacenamiento de VS Code y viajan entre la web y el editor con un enlace compartido o un archivo .breakscale.

Ejecutarlo en tu máquina

Necesitas Bun. Así lo levantamos nosotros:

terminalsh
git clone --depth 1 https://github.com/workersio/breakscale.git
cd breakscale
bun install
bun dev

Abre http://localhost:5173. bun install instaló 110 paquetes en unos 3 segundos. Al arrancar, Vite mostró un error de escaneo de dependencias porque no encuentra @modelcontextprotocol/ext-apps, que importa el widget de mcp/widget/ y no se instala desde la raíz. No afecta al simulador: la aplicación cargó y funcionó con normalidad. Si quieres que desaparezca, instala también las dependencias de esa carpeta con bun install dentro de mcp/.

El motor no depende de la interfaz, así que puedes manejarlo desde un script. Este es el que usamos para medir el ejemplo de la siguiente sección (Bun ejecuta TypeScript directamente):

barrido.tstypescript
import { Engine } from './src/sim/engine';
import { PRESETS } from './src/sim/presets';

const preset = PRESETS.find((p) => p.id === 'retry-storm')!;

for (const rps of [40, 60, 80, 85, 90, 100]) {
  const topology = structuredClone(preset.topology);
  topology.nodes.find((n) => n.id === 'client')!.config.rps = rps;
  const engine = new Engine(topology, 42); // semilla fija: resultado reproducible
  for (let i = 0; i < 60 * 120; i += 1) engine.advance(1000 / 60); // 120 s simulados
  const s = engine.snapshot().system;
  console.log(rps, s.goodputRps.toFixed(1), ((s.totalFailed / s.totalRequests) * 100).toFixed(1));
}
terminalsh
bun barrido.ts

Prueba real: la tormenta de reintentos

El ejemplo Retry storm tiene tres piezas: un cliente, una API con timeout de 250 ms y 2 reintentos y una base de datos pequeña: 4 peticiones a la vez, 40 ms de media cada una, es decir, un techo teórico de 100 peticiones por segundo. A 45 peticiones por segundo todo va bien: la base de datos está al 58 % y el p99 del sistema ronda los 100 ms.

A 45 peticiones por segundo el sistema está sano: 0 % de errores y base de datos al 58 % · codigoagente

Con el script anterior barrimos la carga durante 120 segundos simulados con la semilla 42:

Carga ofrecidaGoodput (peticiones útiles/s)Peticiones fallidasOcupación de la base de datos
40/s36,70 %35 %
60/s53,30 %55 %
80/s68,90 %68 %
85/s**0****93,1 %**99,9 %
90/s079,7 %99,9 %
100/s097,7 %99,9 %

El salto de 80 a 85 peticiones por segundo es el punto clave. La base de datos aún no ha llegado a su techo de 100, pero las colas empiezan a pasar de 250 ms, la API corta por timeout y reintenta dos veces, así que cada petición se convierte en hasta tres. En la captura de arriba se ve el resultado: el cliente envía 97 peticiones por segundo y la API empuja 283 por segundo contra una base de datos que ya estaba llena. La base de datos trabaja al 99,9 % y el goodput es cero, porque todo lo que termina ya lo había abandonado quien lo pidió. Es justo la regla de «el trabajo abandonado sigue gastando».

Cómo se arregla sin añadir servidores

Probamos dos cambios en la API, con 85 peticiones por segundo:

CambioGoodputFallosp99
Original (timeout 250 ms, 2 reintentos)093,1 %—
Sin reintentos (timeout 250 ms)81,1/s1,5 %156 ms
Timeout de 1 s (2 reintentos)81,1/s0 %156 ms

Con un timeout de 1 s el sistema aguanta incluso a 100 peticiones por segundo, en el límite físico de la base de datos: 0 % de errores en la interfaz y un p99 que sube a unos 900 ms, porque ahora las peticiones esperan en vez de multiplicarse. En nuestro barrido de 120 s a esa carga el fallo fue del 7,4 %, el precio de trabajar justo en el techo. La lección es la que se suele leer sin llegar a entenderla: un timeout corto con reintentos amplifica la sobrecarga que lo provocó.

Mismo sistema y misma carga, con el timeout de la API subido a 1 s desde el inspector: 0 % de errores · codigoagente

Para cambiarlo en la interfaz: haz clic en API Server, y en el inspector de la derecha, en When things go wrong, mueve Timeout o cambia Retries. El panel What just happened va anotando cada cambio y cada consecuencia con su segundo exacto.

Breakscale con Claude Code y otros agentes (MCP)

Breakscale también es un servidor MCP con cinco herramientas:

HerramientaQué hace
`read_me`Explica el formato de diseño, cada componente y cómo mapear código real a componentes
`create_view`Valida un diseño, simula 30 s y lo muestra en el lienzo
`export_design`Devuelve el diseño como archivo `.breakscale`
`open_design`Lee un enlace compartido de breakscale.tech para pedir cambios sobre él
`break_it`Lanza fallos contra el diseño hasta que incumple un objetivo que tú fijas y enlaza a la repetición

Para Claude Code, con el servidor alojado (no instala nada):

terminalsh
claude mcp add --transport http --scope user breakscale https://mcp.breakscale.tech/mcp

O en tu máquina, con Node 20 o superior, para que la simulación corra en local:

terminalsh
claude mcp add --scope user breakscale -- npx -y breakscale-mcp --stdio

--scope user lo deja disponible en todos tus proyectos. Compruébalo con /mcp dentro de Claude Code. En claude.ai se añade en Customize › Connectors › Add custom connector con la URL https://mcp.breakscale.tech/mcp y sin OAuth. Ten en cuenta que Claude Code, Codex y Gemini CLI solo reciben números y un enlace: el lienzo interactivo dentro del chat aparece en clientes con soporte de MCP Apps, como claude.ai, Claude Desktop, VS Code con Copilot o Cursor. Si te interesa construir un servidor así, tenemos una guía de mcp-builder.

Prompts útiles una vez conectado (los proponen los autores):

  • «Lee este repositorio y convierte su arquitectura en un diseño de Breakscale. Dime qué números has supuesto.»
  • «Diseña un acortador de URLs para 2.000 peticiones por segundo y enséñame dónde se rompe.»
  • «Duplica el tráfico. ¿Qué falla primero y cómo lo arreglarías sin añadir servidores?»

El primero es el más valioso para un equipo pequeño: el agente lee tu código, deduce los componentes y te devuelve dónde está el cuello de botella antes de que lo descubra un pico real de tráfico. Pídele siempre que diga qué números ha supuesto, porque la capacidad de tu base de datos o el tiempo de servicio de tu API no salen del código.

Cuánto cuesta

OpciónCostoCuándo elegirla
Web breakscale.tech0 USD, sin cuentaAprender, probar ideas y compartir diseños
Extensión de VS Code0 USD, funciona sin conexiónTrabajar junto al código sin depender de la web
Servidor MCP alojado0 USD por Breakscale; solo pagas los tokens de tu asistente (o tu suscripción de Claude)Que el agente modele tu arquitectura sin instalar nada
Servidor MCP local (`npx`)0 USD; la simulación usa tu CPUCuando no quieres que tus diseños salgan de tu máquina
Desplegar tu propia copiaEl hosting estático que ya uses; los enlaces cortos usan un Cloudflare Worker opcional (`worker/`)Formación interna o una versión adaptada para tu equipo

Frente a cursos de diseño de sistemas de pago o herramientas de diagramas con suscripción, la opción más barata para casi cualquier caso es la web o la extensión: cero dólares y el mismo motor. El servidor MCP es lo único con un costo indirecto, el de los tokens que gaste tu asistente al leer el repositorio y generar el diseño.

Errores frecuentes

  • «Failed to resolve @modelcontextprotocol/ext-apps» al hacer bun dev. Es el escaneo de dependencias del widget de mcp/. El simulador funciona igual; si te molesta, ejecuta bun install dentro de mcp/.
  • El sistema «aguanta» a 85 peticiones por segundo y en otra prueba se cae. El inicio del colapso es estocástico: depende de cuándo llega el primer lote lento. Usa la misma semilla para comparar cambios; el propio test del proyecto (retryStorm.test.ts) documenta fallos de entre el 40 % y el 95 % según la semilla justo en el punto de quiebre.
  • No veo el lienzo en Claude Code. Es lo esperado: Claude Code recibe métricas y un enlace a breakscale.tech. Ábrelo en el navegador o usa un cliente con MCP Apps.
  • Los números de mi arquitectura no cuadran con producción. El simulador es tan bueno como los parámetros que le das. Mide antes el tiempo de servicio y la concurrencia reales de tu base de datos y API, y pásaselos al diseño.

Preguntas frecuentes

¿Breakscale es gratis para uso comercial? Sí. El código es MIT, así que puedes usarlo en tu empresa, modificarlo y desplegarlo. Conserva el aviso de copyright, y recuerda que la fuente Caveat incluida va con licencia OFL 1.1.

¿Necesito saber diseño de sistemas para usarlo? No. Los ejemplos están pensados para aprender: cada uno trae una nota en el lienzo que dice qué tocar y qué debería pasar, y cada métrica tiene su definición al pasar el ratón.

¿Mis diseños se suben a algún servidor? No, salvo que los compartas. Entonces se cifran en tu navegador antes de enviarse. Con el servidor MCP alojado tu asistente sí envía el diseño a mcp.breakscale.tech para simularlo; si no lo quieres, usa npx -y breakscale-mcp --stdio.

¿Sirve para preparar entrevistas de system design? Para entender el porqué de las respuestas, sí: ver cómo se dispara el p99 cuando la ocupación pasa del 80 % o cómo un reintento tumba un sistema se recuerda mejor que una regla memorizada.

Conclusión

Breakscale convierte las reglas de diseño de sistemas («pon una caché», «cuidado con los reintentos») en experimentos que puedes repetir y medir. Empieza por el ejemplo Retry storm en breakscale.tech, sube la carga de 80 a 85 y luego cambia el timeout de la API. Cuando lo entiendas, conecta el servidor MCP a Claude Code y pídele que modele la arquitectura de tu propio proyecto: es la forma más barata de encontrar el cuello de botella antes que tus usuarios.

// código fuente

Repositorio del artículo
El código del que habla este artículo es público: revísalo, dale una estrella o clónalo desde aquí.

Nos ayuda a crecer

codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

ArtCraft, app open source para crear imágenes y vídeos con IA montando antes la escena en 2D y 3D. Qué hace, cuánto cuesta y cómo usarla con tu clave de fal.
  • Alternativas gratis a apps de pago
  • Diseño, imagen y vídeo
leer artículo
PeakCut recorta vídeos largos y directos de YouTube, Twitch o Kick en clips 9:16 con subtítulos palabra a palabra. Instalación, coste real y prueba en español.
  • Alternativas gratis a apps de pago
  • Instálalo en tu servidor
leer artículo
Slopus es una app de escritorio GPL-3.0 que planifica, genera y edita imágenes, vídeo y música en tu GPU. Agente, generadores locales y timeline sin FFmpeg.
  • Claude Code
  • Alternativas gratis a apps de pago
leer artículo