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.
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 enpublic/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/simy 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:
| Regla | Qué significa en la práctica |
|---|---|
| Huecos de servicio finitos | Cada 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 variable | Media 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 gastando | Si 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 instante | Una 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 medidos | p50, 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.
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:
git clone --depth 1 https://github.com/workersio/breakscale.git
cd breakscale
bun install
bun devAbre 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):
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));
}bun barrido.tsPrueba 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.
Con el script anterior barrimos la carga durante 120 segundos simulados con la semilla 42:
| Carga ofrecida | Goodput (peticiones útiles/s) | Peticiones fallidas | Ocupación de la base de datos |
|---|---|---|---|
| 40/s | 36,7 | 0 % | 35 % |
| 60/s | 53,3 | 0 % | 55 % |
| 80/s | 68,9 | 0 % | 68 % |
| 85/s | **0** | **93,1 %** | 99,9 % |
| 90/s | 0 | 79,7 % | 99,9 % |
| 100/s | 0 | 97,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:
| Cambio | Goodput | Fallos | p99 |
|---|---|---|---|
| Original (timeout 250 ms, 2 reintentos) | 0 | 93,1 % | — |
| Sin reintentos (timeout 250 ms) | 81,1/s | 1,5 % | 156 ms |
| Timeout de 1 s (2 reintentos) | 81,1/s | 0 % | 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ó.
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:
| Herramienta | Qué 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):
claude mcp add --transport http --scope user breakscale https://mcp.breakscale.tech/mcpO en tu máquina, con Node 20 o superior, para que la simulación corra en local:
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ón | Costo | Cuándo elegirla |
|---|---|---|
| Web breakscale.tech | 0 USD, sin cuenta | Aprender, probar ideas y compartir diseños |
| Extensión de VS Code | 0 USD, funciona sin conexión | Trabajar junto al código sin depender de la web |
| Servidor MCP alojado | 0 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 CPU | Cuando no quieres que tus diseños salgan de tu máquina |
| Desplegar tu propia copia | El 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 demcp/. El simulador funciona igual; si te molesta, ejecutabun installdentro demcp/. - 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
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.
- Compártelo con alguien a quien le sirvaWhatsAppLinkedInXFacebook
- Conoce a nuestro patrocinadorSafe Build Labs
Más sobre Herramientas open source

- Alternativas gratis a apps de pago
- Diseño, imagen y vídeo

- Alternativas gratis a apps de pago
- Instálalo en tu servidor

- Claude Code
- Alternativas gratis a apps de pago