Simulacra

Simulacra

Your code reviewed by ghost personas before it ships.

Before/After • Install • The Ghosts • Skill Scorer • How It Works • Benchmarks

---

Before / After

Without Simulacra — you ship this:

function applyDiscount(cart) {
  if (cart.total >= 500) {
    cart.items.forEach(item => item.price *= 0.8);
  }
  return cart;
}

"Looks fine. Ship it." ✅

With Simulacra — three ghosts find three bugs:

👤 Reckless Rick (The Adversary): "Your forEach mutates prices in place. I hit Back twice — 630 TL cart drops to 322 TL. Your company eats the 308 TL difference."

🔥 IDEMPOTENCY — 🔴 Critical

👤 Corporate Claire (Enterprise Edge): "I'm paying in EUR. cart.total = 200 fails the >= 500 check. My 7000 TRY order gets no discount. I'm switching vendors."

🔥 BUSINESS-LOGIC — 🟠 High

👤 OOM Reaper (Chaos Monkey): "Memory spike at item 7 of 14. Half the cart is discounted, half isn't. No rollback. The corruption persists to your database."

🔥 PARTIAL-FAILURE — 🔴 Critical

Three bugs. Zero lines of test code. Before the PR even opens.

---

Install

Claude Code (official plugin)

/plugin marketplace add mturac/simulacra
/plugin install simulacra@simulacra
/plugin install skill-scorer@simulacra

Codex CLI

cp -r skills/simulacra ~/.codex/skills/
cp -r skills/skill-scorer ~/.codex/skills/

Cursor / Windsurf / Roo

Copy skills/simulacra/SKILL.md to your project's .cursor/skills/ (or equivalent) directory.

Gemini CLI / OpenCode / GitHub Copilot CLI

cp -r skills/simulacra ~/.config/gemini/skills/   # gemini
cp -r skills/simulacra ~/.opencode/skills/         # opencode

Vercel skills.sh

npx skills add mturac/simulacra

Manual (any agent)

Copy the skills/ folder to your agent's skill directory. The skills are pure markdown — no dependencies, no build step, no runtime.

---

The Ghosts

Every code review spawns 3 ghost personas by default (up to 7 on request):

Ghost	Perspective	Hunts For
👤 The Adversary	User who breaks things	Race conditions, double-submit, replay attacks, back-button abuse
🏢 Enterprise Edge	Complex business customer	Multi-currency, tax exemptions, B2B rules, locale, permissions
🐵 Chaos Monkey	Infrastructure bad day	Timeouts, partial failures, OOM, connection drops, network partitions
🧑‍💻 Junior Dev (+request)	Future maintainer	Readability, magic numbers, implicit knowledge, missing docs
📈 The Scaler (+request)	1000x traffic	N+1 queries, unbounded loops, missing pagination, memory growth
🔒 The Auditor (+request)	Security & compliance	Injection, auth bypass, data exposure, sensitive logging
⏰ Time Traveler (+request)	6 months from now	Dependency rot, API deprecation, schema drift, tech debt

Each ghost produces:

• Chaos Timeline — step-by-step simulation with realistic timestamps
• Structured Testimony — what they did, what broke, evidence from your code
• Bug Report — category, severity, affected line, fix suggestion
• JSON Output — machine-readable for CI pipelines and issue trackers

---

Skill Scorer

Bonus skill included. Rate any SKILL.md on a 0-100 scale.

> Score this skill: [paste any SKILL.md]