Living Specs

Design documents describing how features in this application work. Each spec is a permanent reference — updated as behaviour evolves.

Spec	Description
Home Page	Entry point with a hero section and a preview of up to six examples linking to the examples and source browser sections.
Examples System	File-based Ruby code examples with metadata, tag filtering, and source display.
Examples Runner	Interactive scenario execution: dropdown inputs, server-side Ruby execution, inline Turbo Frame result display.
Rich Example Content	Markdown-driven detail page layout with placeholder tags for embedding source code and scenario forms.
Source Browser	File tree that lets visitors browse the application's own source code with syntax highlighting.
Source Browser — Claude Workflow Files	Exposes living specs, slash-command definitions, and CLAUDE.md in the source browser so visitors can see how the project is developed with AI assistance.
Source Browser — Markdown Links	Relative links in Markdown files are rewritten to their Source Browser URL so navigation works correctly.
Markdown Code Block Syntax Highlighting	Rouge syntax highlighting for fenced code blocks inside rendered Markdown content.
Styling and CSS	Pico CSS v2 base with custom SCSS partials, dark mode toggle persisted to localStorage, and Rouge syntax highlighting themes.
Light/Dark Theme Switching	Theme toggle button persists light/dark preference to localStorage; applied on load via Stimulus controller before first paint.

---

Adding a new spec: use the template and the /spec slash command.