Docs Web Information Architecture

This document maps canonical repository docs to the public Docusaurus routes for docs.mayadev.cloud.

Route Principles

• Routes are semantic and stable; they do not expose planning-only paths.
• .docs remains the authored source. apps/docs/.generated/docs is a build output.
• Raw evidence, protocol captures, and Linear planning records are omitted unless explicitly reclassified.
• Storybook is linked as an external executable component-state surface at storybook.mayadev.cloud.
• API reference is a placeholder until a generator is implemented.

Public Route Map

Source	Route	Treatment
.docs/README.md	/	Generated docs index
.docs/guides/workspace-composition-10-minute-developer-happy-path.md	/guides/workspace-composition-10-minute-developer-happy-path	Developer path
.docs/packages/assistant-composition.md	/packages/assistant-composition	Package guide
.docs/packages/assistant-ui.md	/packages/assistant-ui	Package guide
.docs/packages/assistant-protocol.md	/packages/assistant-protocol	Package guide
.docs/packages/claude-workspace.md	/packages/claude-workspace	Package guide
.docs/packages/data-lab-module.md	/packages/data-lab-module	Package guide
generated package index	/packages/	Short landing page
.docs/architecture/workspace-composition.md	/architecture/workspace-composition	Architecture
.docs/architecture/workspace-composition-decisions.md	/architecture/workspace-composition-decisions	Composition decisions
.docs/architecture/docs-web-decisions.md	/architecture/docs-web-decisions	Docs web decisions
.docs/architecture/docs-web-source-policy.md	/architecture/docs-web-source-policy	Docs source policy
.docs/architecture/docs-web-api-reference-runway.md	/architecture/docs-web-api-reference-runway	API runway
.docs/architecture/workspace-composition-v0-roadmap.md	/architecture/workspace-composition-v0-roadmap	Platform roadmap
generated architecture index	/architecture/	Short landing page
.docs/verification.md	/operations/verification	Verification
.docs/release-governance.md	/operations/release-governance	Release governance
.docs/ops/cloudflare-pages-docs.md	/ops/cloudflare-pages-docs	Docs deploy runbook
.docs/ops/cloudflare-pages-storybook.md	/ops/cloudflare-pages-storybook	Storybook deploy runbook
.docs/ops/release-deploy-runbook.md	/ops/release-deploy-runbook	Release/deploy runbook
.docs/ops/secrets-and-environments.md	/ops/secrets-and-environments	Secrets policy
.docs/ops/smoke-checks.md	/ops/smoke-checks	Post-deploy smoke checks
generated operations index	/operations/	Short landing page
.docs/security/supply-chain.md	/security/supply-chain	Supply-chain policy
.docs/agent-native/capability-map.md	/agent-native/capability-map	Agent-native map
generated component states index	/reference/component-states	Storybook component-state preview entry
generated API placeholder	/reference/api	Planned future generated reference entry

Omitted Inputs

Source	Reason
.docs/architecture/workspace-composition-linear-backlog.md	Linear planning source, not public product documentation
projects/claude-protocol/protocol-captures/**	Raw evidence and capture notes stay out of public navigation
projects/*/dist/**/*.d.ts	Future API reference generator input
root .env* files	Ignored local secrets
.sessions/**	Evidence workspace, not docs content

Sidebar Model

The Docusaurus sidebar is explicit:

• Start: overview and developer happy path
• Packages: package guides plus package landing page
• Workspace Composition: architecture and contribution model
• Docs Web: website IA, decisions, source policy, and API runway
• Operations: verification, release, deploy, secrets, smoke checks, and supply chain
• Reference: API placeholder, component states entry, agent-native map, and external Storybook link

Reclassification Rule

A document may move from omit to publish only when:

• the content is safe for public navigation
• it has a stable route
• it does not duplicate another canonical source
• docs-web-source-policy.md and apps/docs/scripts/prepare-content.mjs are updated in the same change