story-state
Installation
SKILL.md
Story State
Use after a chapter or screenplay scene settles, or when a revision changes chronology or state.
Workflow
- Read the core contract,
NARRATIVE_STATE.md, canon, and the changed chapter or scene. - Read only the ledger entries and adjacent scenes affected by the change.
- Update
01_story/story_state.jsonwith changed character, relationship, prop, question, promise, scene-order, and event state. Use the object relationship form fromNARRATIVE_STATE.mdfor new relationship changes. - Keep canonical speech, movement, stillness, physical identity, and baseline ensemble behavior in canon. Current trust, hostility, allegiance, knowledge, injury, possession, location, and other chronology-sensitive conditions belong here.
- Keep possibilities out of the ledger until the upstream story or screenplay adopts them.
- Use
mentionsfor non-active appearances such as memories, recordings, references, or posthumous material when that distinction matters. - Run
validate_story_project.pyafter chronology, setup/payoff, death, or selection state changes.
Done
The ledger matches the approved narrative scope, every changed state has a traceable scene, and deterministic ordering checks pass.