Skip to content
smarchonePublic

About

run an engineering blog/story/incident as a simulation

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

88 Commits

Folders and files

Repository files navigation

sim-xp

Simulate a blog, an incident or a load test.

A new way for engineers to share and build experience. Agents turn any blog, incident or concept into a simulation that brings you closer to reality, and saves you the reading.

experience ──encode──▶ playbook.json ──run──▶ simulation

Start playing: https://smarchone.github.io/sim-xp/v2/ · About: https://smarchone.github.io/sim-xp/

The problem

  • There's a gap between reading about a system and experiencing it live.
  • Simulations close that gap. Not exact, but much closer.
  • Agents make it fast: one story in, one simulation out.

Load test until it breaks: the three walls of a Kafka cluster

How to create playbooks

The story-to-playbook skill turns a blog post, postmortem, concept or short prompt into a validated playbook.json. Install it once:

npx skills add smarchone/sim-xp --skill story-to-playbook -g

Then give it a story in Claude Code:

/story-to-playbook https://github.blog/news-insights/company-news/oct21-post-incident-analysis/
/story-to-playbook "Postgres as a job queue, load tested until it breaks"
/story-to-playbook "How a Kafka consumer rebalance storm starts and ends"

Open the file in the player (drop it on the page, or Open file… in the side panel) and press Space.

Share your playbook library

A library of playbooks can be hosted as a public Github repo.
eg: smarchone/simxp-playbooks

Import it in the player:
side panel → *Library* → type the repo name → Add

Can also run a playbook directly via URL eg:
https://smarchone.github.io/sim-xp/v2/#smarchone/simxp-playbooks:postgres-queue-load-test

Part of agentic experiences: accelerate learning with agents.

About

run an engineering blog/story/incident as a simulation

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages