reversa-docs-storyteller

Generate interactive documentation by reading project specs to produce navigable HTML glossaries, slide decks, and feature pages. This onboarding documentation transforms raw technical concepts into human-friendly narrative artifacts for new contributors.

Creating a navigable slide deck from feature documentation involves parsing specs to generate a 6 to 10 slide onboarding deck. It guides users from purpose to architecture to feature highlights, scaling down gracefully when inputs are missing.

Generate an interactive HTML glossary from project concepts automatically to provide client-side search. This allows new users to learn key definitions quickly without digging through raw technical specs or manually coding web pages.

Create per-feature documentation pages by deriving feature specs into individual "How a Feature Works" pages. This process extracts requirements, context, and implementation details into a consistent format for multi-feature system onboarding.

Documentation generation works with partial or missing inputs by scaling outputs down gracefully. In greenfield scenarios with incomplete specs, it still produces navigable glossary and deck artifacts by deriving available information from existing configuration files.

Required configuration files include .reversa/state.json and .reversa/documentation/.config.json. These inputs are parsed to derive soul.json and features-index.json, which drive the generation of all documentation outputs strictly under the documentation directory.