session-runner

What problem does it solve?

Running a full D&D playtest with fidelity, repeatability, and voice-consistency is labor-intensive. This skill automates the end-to-end session lifecycle by acting as a deterministic DM and all PCs, orchestrating PREP → PLAY → LOG and producing canonical session artifacts for auditing and iteration.

Core Features & Use Cases

• Orchestrates a 7-stage session pipeline (PREP, PLAY, LOG and downstream stages) to streamline playtest design, execution, and logging.
• Supports both Option A (solo-DM) and Option C (per-PC agent-spawn at meaningful decision points) to preserve character voice and dramatic tension.
• Ensures deterministic dice resolution via a built-in dice engine and logs every mechanical outcome for reproducibility.
• Generates canonical artifacts such as sessions/S{N}-prep.md and sessions/S{N}-log.md, and updates the party shared log for ongoing memory.
• Logs detailed state changes, warnings, and manifest events (state_updates/events) for cross-session playtesting analysis.

Quick Start

Create an adventure module (module.md) and a party directory (personas/parties/...), then run the session-runner to generate the first session log at sessions/S1-log.md.