pki.sgit.ai / documents / the-scenario-engine

The Scenario Engine: JSON-Driven Worlds, The Soft Mandate, And The Platform Library

TypeDev brief Versionv0.33.68 Date29 August 2026 AuthorDinis Cruz (project lead) and collaborators LicenceCC BY 4.0 Sourceraw markdown · view on GitHub

Summary

The third memo, processed: everything JSON-driven, nothing hardcoded, because the destination is tonnes of scenarios and a game engine that becomes a product. One engine (admin/build/gen_scenario.py) renders any world from a scenario.json that references a measured twin — the engine holds no capabilities of its own, and the deck gate forces cards == twin nodes exactly. Two worlds prove the claim by existing: PUSH TO GITHUB, the memo's worked example — this session's own grant chain, user → GitHub App → scoped token → container → Claude Code → Claude → repo — with the soft mandate shown as a place: the thing that keeps this world off the wrong branch is prose in the agent's context, an expectation-tier constraint living exactly where the memo says mistakes occur, beside the hook it could be and the platform boundary it is not. THE DEPLOY, the counter-world: the CI runner with no agent, no hook, unrestricted egress — and the estate's only boundary-tier grant. Plus the confidence rung computed from evidence (hypothesis 0 → independent 3), eight capability micro-animations, and the platform library rules for future fact-based variation entries — where the rung is the libel guard.

Key concepts

Key ideas

On this site

Adds the engine, two scenario worlds, the shared scenario.css with eight micro-animations, and six gates; amends the experiments convention to allow a shared engine driven by per-world scenario.json.

Read the document

📄 Original document · v0.33.68 · 29 August 2026 · rendered from the raw markdown (the source of truth)