How workersio/breakscale works
Breakscale is a system-design simulator: users assemble architectures, apply traffic and faults, then inspect measured behavior and failure explanations. Its browser UI is the main product surface; the same simulation capabilities are also exposed through a VS Code panel and an MCP server. The graph includes documented learning, challenges, incidents, correctness checks, and sharing. Evidence is limited to the README and the supplied excerpts and source index; unsampled implementation details are not assumed.
Main entry points: App.tsx Browser App · server.ts MCP Server · breakit.ts Failure Search · engine.ts Discrete-Event Engine
Components 23
Design Interface
- Browser App
src/App.tsx - Architecture Canvas
src/components/Canvas.tsx - Metrics and Trace
src/components/Metrics.tsx
Simulation Engine
- Design Examples
src/sim/presets.ts - Discrete-Event Engine
src/sim/engine.ts - Component Behavior
src/sim/behaviour.ts - Fault Injection
src/sim/faults.ts - Diagram Annotations
src/sim/annotations.ts
Learning and Analysis
- Failure Search
src/sim/breakit.ts - Challenge Goals
src/sim/challenge.ts - Goal Evaluation
src/sim/judge.ts - Correctness Checks
src/sim/verify.ts - Guided Learning
src/learn/exampleTask.ts - Outage Scenarios
src/sim/incidents.ts
Design Exchange
- Encrypted Sharing
src/share.ts - Shared Link Store
src/share/store.ts
Product Integrations
- VS Code Extension
extension/src/extension.ts - Panel Persistence
src/webview/storage.ts - MCP Server
mcp/src/server.ts - Design Builder
mcp/src/design.ts - MCP Simulation
mcp/src/run.ts
Other components
- Engineer
- AI Assistant
Connections 26
- Engineer → Browser App: designs systems
- Browser App → Architecture Canvas: edits topology
src/App.tsx - Browser App → Design Examples: loads examples
src/App.tsx - Browser App → Discrete-Event Engine: runs simulation
src/App.tsx - Discrete-Event Engine → Component Behavior: resolves behavior
src/sim/engine.ts - Browser App → Metrics and Trace: shows results
src/App.tsx - Browser App → Fault Injection: applies faults
- Architecture Canvas → Diagram Annotations: stores notes
src/sim/annotations.ts - Browser App → Failure Search: starts search
src/App.tsx - Failure Search → Challenge Goals: checks goals
src/sim/breakit.ts - Failure Search → Discrete-Event Engine: simulates trials
src/sim/breakit.ts - Browser App → Goal Evaluation: evaluates goals
src/App.tsx - Browser App → Correctness Checks: checks correctness
- Browser App → Guided Learning: guides learning
- Browser App → Outage Scenarios: loads incidents
src/App.tsx - Browser App → Encrypted Sharing: creates share links
- Encrypted Sharing → Shared Link Store: stores shared designs
mcp/src/server.ts - Engineer → VS Code Extension: opens panel
- VS Code Extension → Browser App: hosts simulator
- VS Code Extension → Panel Persistence: persists designs
- AI Assistant → MCP Server: requests design
- MCP Server → Design Builder: builds topology
mcp/src/server.ts - MCP Server → MCP Simulation: runs topology
mcp/src/server.ts - MCP Server → Failure Search: searches failures
mcp/src/server.ts - MCP Server → Encrypted Sharing: creates share links
mcp/src/server.ts - MCP Simulation → Discrete-Event Engine: simulates topology
mcp/src/run.ts