reversa-docs-storyteller

Generate interactive onboarding documentation by converting system specifications into a searchable glossary, navigable slide deck, and per-feature HTML pages. This approach transforms engineering specs into navigable docs that help new contributors understand the system quickly.

Create a searchable glossary from project specifications by extracting core concepts and rendering them into an HTML page with interactive client-side search. This makes terminology discoverable without requiring any server requests.

Build an onboarding slide deck by processing system specifications to produce a structured navigable overview of 6 to 10 slides. The deck adapts its structure based on available pages and existing documentation depth.

This documentation generation workflow requires reading .reversa/state.json and .reversa/documentation/.config.json. It uses these configuration files to generate data assets and applies safe fallbacks when inputs are missing.

Generate per-feature HTML pages by selecting specifications and rendering one page per feature. Each page explains the feature's intent and structure in a consistent format for onboarding and discovery.

When input specs are missing, feature storytelling outputs use safe fallbacks provided by templates. The process still writes outputs under the documentation directory, ensuring onboarding assets render without failing.