Something went wrong. Try again.
Content schemas and validation for agent-assisted browser games. Separates UI text, narrative structure and game rules.
Something went wrong. Try again.
Files
- JavaScript 100%
README.md
# PBBG Content Schema
Version 0.5.0 • Experimental Architecture Release
A standalone content architecture package for separating interface language, narrative structure, and game definitions in browser games developed with agents. It provides JSON Schemas, scoped writing policies, a neutral fictional example, reference projection tooling, and a local linter CLI.
---
## Background & Origin
This package was extracted from work on *Coalition* (`quarterback/escape-game`), Ron Bronson's turn-based browser game set in the Nelosphere world. The architecture was prepared on October 30, 2026, using commit `26aab93` from the source game as an extraction reference.
Working with agents during game development exposed a fundamental content architecture problem:
1. **Domain conflation:** Unconstrained agents frequently blur diegetic narrative (world descriptions, dialogue) with non-diegetic system copy (buttons, navigation, error logs). This results in bloated, "AI-sounding" interface copy or overly mechanical narrative prose.
2. **Context reconstruction:** When an agent adds a scene or edits an option, it has to infer state transitions, action costs, and prerequisites from scattered code and prose. Without an explicit schema, agents fill knowledge gaps with plausible-sounding hallucinations.
3. **Safety & coupling:** Changing character dialogue or scene flavor should never accidentally mutate dice rolls, state transitions, or action costs.
Rather than waiting for a second playable game, the architecture was sanitized and published as a standalone v0.5.0 package under the Eclipse Public License to establish a reusable Agent Experience (AX) primitive. The package is intentionally independent of game fiction, particular mechanics, and external editorial systems.
---
## Package Structure
| Part | Purpose |
| :--- | :--- |
| `schemas/bundle.schema.json` | Content entries, scenes, events, choices, facts, actions, effects, and outcomes |
| `schemas/policy.schema.json` | Scoped editorial guidance and deterministic writing …