spec - docs.rq

Idea	File	Status	Summary	Katz
docs_image_generation	reqlan rq/docs/docs.rq	done	Images of HTML components for docs, READMEs, and slide packs are generated at build time from production UI. Prefer live HTML imported from production code when embedding is practical; otherwise capture PNGs from the same bundles. Deck asset keys are owned by ["../marketing_and_media/tutorials.rq".presentation_assets]. Pipeline: [docs_webview_build] → [docs_playwright_capture] → [site_reqs.sync_presentations].	0.040
docs_playwright_capture	reqlan rq/docs/docs.rq	done	Playwright loads each built webview via a harness page with a mocked `acquireVsCodeApi` host, posts demo index / context payloads, and writes PNGs into ["../../presentations/assets/"]. Generated assets replace the former coloured SVG stubs ( activity-bar, montage-ide, chat-search, file-link ). Wait for document load, then the shot ready selector. The Ideas Summary montage shot waits longer because the bundle is large. On a ready-selector timeout, print page errors and `#app` HTML. Runs as a step in ["../../site/scripts/build-static.mts"] before presentation sync. CI installs Chromium via `pnpm exec playwright install --with-deps chromium`.	0.045
docs_reqs	reqlan rq/docs/docs.rq		Project requirements should all be documented in the the reqlan rq folder of this repo.	0.040
docs_webview_build	reqlan rq/docs/docs.rq	done	The site static build builds the extension webviews needed for docs captures before Playwright runs. Builds only the webviews listed by the capture catalog ( activity-bar, ideas-summary, onboarding ) — not a full extension VSIX. Uses the same Vite configs as [build_reqs.webview_build].	0.045
export_docs_tag	reqlan rq/docs/docs.rq		The " @ docs " tag should be used to mark files as included in the docs.	0.040

Cluster graph

Initialising graph…