game-systems-overview

Document Saltglass Steppe game architecture, system paths, and deterministic RNG usage.

Updated Dec 13, 2025
One-click install
npx skills add https://github.com/EliasVahlberg/saltglass-steppe --skill game-systems-overview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: game-systems-overview
Source: https://github.com/EliasVahlberg/saltglass-steppe/tree/main/.kiro_snapshot_2026-04-04_1209/skills/game-systems-overview
Command: npx skills add https://github.com/EliasVahlberg/saltglass-steppe --skill game-systems-overview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a concise, actionable reference for developers to understand Saltglass Steppe's architecture, locate authoritative files, and follow established patterns to safely add systems, content, and tests without breaking determinism or state invariants.

Core Features & Use Cases

  • System onboarding: Locate files and patterns needed to add a new game system, implement System traits, and integrate into the end_turn flow.
  • Data-driven content: Find where to add items, enemies, quests, dynamic events, and narrative fragments and how the DataLoader validates content.
  • DES testing and debugging: Create deterministic DES scenarios, run headless tests, and verify event-driven reactions and safe state transitions.

Quick Start

Ask the assistant to guide you step-by-step to add a new system in src/game/systems/, explain required GameEvent additions, where to update data files, and how to write a DES scenario for it.

Frequently Asked Questions about game-systems-overview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new game system to a deterministic game loop architecture?

To add a new game system to a deterministic game loop, you implement System traits, integrate the logic into the end_turn flow, and update necessary data files. This ensures safe state transitions without breaking determinism invariants.

What is deterministic RNG and why is it important for DES testing?

Deterministic RNG ensures that game logic produces identical outputs for identical inputs, which is crucial for DES testing. It allows developers to create predictable DES scenarios, run headless tests, and verify event-driven reactions reliably.

How do I create data-driven content for items and dynamic events?

You create data-driven content by adding items, enemies, quests, and narrative fragments to authoritative data file locations. The DataLoader validates these assets to ensure they integrate correctly with the existing game architecture.

How does an event bus handle system interactions in game architecture?

An event bus handles system interactions by using event-driven contracts to route messages between decoupled systems. This allows game systems to react to events and execute safe state transitions without direct dependencies.

Why does my game state break when adding new data-driven assets?

Your game state breaks when adding data-driven assets if the DataLoader validation fails or if the additions violate safe state transition requirements. Following established architectural patterns and adding required GameEvents prevents these invariant breaks.

Can I use this game architecture reference for debugging world generation?

Yes, you can use this game architecture reference for debugging world generation and system interactions. It documents deterministic RNG usage, system file paths, and event contracts to help identify and resolve game loop behavior issues safely.