SwarmCraft

Deterministic Story Engine

Architectural Lineage:SwarmCraft is an architectural fork and deep rewrite of the multi-agent swarm engine created by Mojomast in mojomast/swarmussy. Its deterministic layering is derived from the meta-structure of the Abstract Wiki Architect.

SwarmCraft is a deterministic, data-driven story engine designed to transform explicit project state into prose using a strict control loop. Unlike chat-based swarms, it separates Brain (LLM personas), Logic (orchestration), and Memory (explicit state) to ensure long-form narrative coherence.

1. Core Architecture

The "Three-Layer Model"

Designed to prevent hallucinations and state drift:

Brain (Personas)Stateless services (Architect, Narrator, Editor) that never own canonical state.
Logic (Engine)The runtime that handles the SCAN → PLAN → EXECUTE loop.
Memory (State)All truth lives in the Matrix, Story Bible, and RAG DB.

The Deterministic Pipeline

SwarmCraft replaces emergent coordination with a strict cycle:

SCAN: Recompute reality from disk.
PLAN: Select the next atomic Part to draft or revise.
EXECUTE: Run one persona on that Part, then exit.

2. Documentation Modules

Technical documentation is currently being migrated to this new platform.

Core Logic

Architecture Overview: High-level diagram of separation.
Deterministic Pipeline: Breakdown of the control loop.
Prompt Hydration: Preventing prompt sprawl via slicing.
Provider Adapter (Grok): Model-agnostic normalization.

State & Schema

Central Matrix: Runtime state (matrix.json).
Story Bible: Creative intent & constraints.
Story Scaffold: The grid system.
Schema Templates: Thread sets and pacing.
Schema Outline: Chapters and beat contracts.

Operations

Dashboard TUI: "Mission Control" interface.
Multi-Project Mgmt: Isolated universes.
Outline Grid & CSV: Round-tripping via spreadsheets.
RAG Memory: Long-term retrieval.

3. Key Concepts

Parts, Not Chapters

The atomic unit of work is the Part. Chapters are simply rollups of 1–6 Parts. This allows for small, stable prompt slices and targeted regeneration.

Slice-by-Slice Hydration

The engine never dumps the whole Story Bible into the LLM. It hydrates prompts with only the active Part's beats, contract, and relevant RAG evidence.

Full Credits & Lineage

Based on the foundational work of Mojomast/swarmussy and the Abstract Wiki Architect.

Full Credits Page (Coming Soon)