Content schemas and validation for agent-assisted browser games. Separates UI text, narrative structure and game rules.
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 …