unspaghettit

Use when turning an EXISTING codebase into an Unspaghettit behavior model (code → spec). Reads the source, models what the code actually does, traces every element to the exact code span it came from (attach_source_file kind:"code" + record_element_span), then seeds .unspa.json implementation coverage from those spans (seed_index_from_analysis). Triggers on "adopt this codebase", "model the existing code", "reverse engineer into unspa", "extract the spec from the code", "code to spec", "unspa adopt".

Use when the user asks "what's implemented", "what's missing", or wants to verify code coverage of an Unspaghettit feature. Reconciles the model in `unspa/*.feature.json` with the implementation map in `.unspa.json`, then queries the Unspaghettit MCP for gap reports. Triggers on "audit", "coverage", "missing", "implemented", "what's left", or whenever spec-vs-code drift is in question.

Use when editing an Unspaghettit behavior model - adding, changing, or removing features, surfaces, actions, states, rules, invariants, transitions, effects, parameters, scenarios, personas, resources, entities, events, or projects. Always goes through the Unspaghettit MCP server. Triggers on "unspaghettit", "feature", "surface", "action", "rule", "scenario", "behavior model", or any task touching `unspa/*.feature.json`.

Use when writing application code that implements an item from an Unspaghettit model (action, rule, invariant, transition, state, event, surface_rule, surface_invariant, entity). Records the implementation location in the `.unspa.json` behavioral index and syncs coverage to the MCP. Triggers when implementing a Feature the user described in Unspaghettit terms.

Use when modeling a fictional or interactive world in Unspaghettit — a text-adventure setting, a roleplay environment, a chat-explorable place, a game world, a narrative location. Maps locations to surfaces, world state to shared state, NPC schedules to time-driven rules, and "what the player can do here" to actions with preconditions. Pair with unspa-worldplay for actually walking the player through the built world. Triggers on "build a world", "create a setting", "text adventure", "interactive fiction", "chat-explorable world", "narrative environment", "fantasy village", "sci-fi station", "model a place".

Use to actually walk a player through a world built with Unspaghettit — chat-explorable text-adventure style. Keeps the runtime state in a save file at `.unspa-world/<featureId>.save.json` so the model never relies on its own eroding context for the player's purse, inventory, time of day, or location. Each turn re-reads the save, maps the user's intent to a modeled Action, asks the MCP's simulator to resolve it, applies the resulting diff back to the file, and narrates. Triggers on "walk in", "enter the world", "let me play", "drop me into", "begin the adventure", "start the world", "let's chat-explore", "run the world", "play <world name>".