Reason Tracker

Videos about hard decisions.

General-audience website homepage source: docs/index.md.

Documentation Map

• Shared/general-audience docs: docs/index.md, docs/vision.md, docs/goals.md, docs/roadmap.md, docs/decision-log.md, docs/glossary.md
• Developer specs and execution status: docs/developers/specs/index.md, docs/developers/now.md
• Agent policies and operational runbooks: docs/developers/agents/index.md
• Vite+ workflow and tooling reference: docs/developers/agents/context/vite-plus-workflow.md

General-Audience Website Docs

• General-audience docs/content are intended to be published through the website app in apps/website/.
• Keep source-of-truth docs in docs/, then expose selected content on the website.
• Production website: https://reasontracker.com

Website Publishing Flow

The website uses a website publish pipeline that emits static HTML routes.

Core files:

• apps/website/site/: hosted website root (HTML, CSS, icons, and other web-facing files).
• apps/website/scripts/publish-website.mjs: reads markdown from docs/**, rewrites internal links, and publishes full static HTML pages.
• apps/website/dist/: generated website publish output.
• apps/website/src/publish-config.ts: explicit public publish roots.
• apps/website/package.json (publish:website): one-step full website publish command.

Route mapping rules:

• docs/index.md -> /
• docs/**/index.md -> /**/
• docs/**/README.md -> /**/
• docs/**/*.md -> /**/filename/

Publishing scope is path-based and should remain explicit in apps/website/src/publish-config.ts.

Implementation notes: docs/developers/agents/context/website-overrides-sections.md