narrate

What problem does it solve? Allium specifications describe system behaviour precisely but in spec vocabulary that owners, builders, and users of a system struggle to read. This Skill turns a .allium spec into a plain-language narrative document that explains what the system does, why it exists, and how people move through it end to end. ## Core Features & Use Cases - Narrative walkthrough generation: Produces a self-contained static HTML page with a behaviour summary, actor introductions, rationale grounded in the project's own ADRs and decision records, an end-to-end journey, and a closing list of open questions. - Strictly grounded mockups and diagrams: Every mockup field, diagram lifeline, and flow branch is derived only from the spec's declared exposes/provides or the project's real UI and documentation, never invented plausible content. - Consistent visual system: Ships a baseline stylesheet (references/base.css) with typography, mockup frames, sequence/flowchart/timeline diagram scaffolding, actor colour-coding, and click-to-enlarge lightbox, reusable across specs in the same repo. - Use Case: A team with a .allium spec for a workout app needs an onboarding document for a new stakeholder. Run narrate to produce docs/narrate/<spec-name>/index.html telling the system's story with grounded mockups and diagrams. ## Quick Start Use the narrate skill to generate a narrative walkthrough document from the .allium spec in this repository.