Canonical Scope
sharedScope and migration map from legacy markdown docs to the docs app.
This page defines which documentation is canonical in the Fumadocs app and how
legacy docs/ files map to this surface during migration.
Canonical policy
- Canonical architecture and development-flow docs live in
apps/docs/content/docs. docs/roadmap.mdremains the execution tracker source of truth.docs/decisions/*.mdremain ADR source of truth.- Legacy markdown stays available during migration, but canonical content should not drift from this docs app.
Migration map
| Legacy source | Canonical page | Status | Notes |
|---|---|---|---|
docs/architecture/00-overview.md | /docs/architecture | migrated | High-level architecture summary and boundaries |
docs/architecture/25-frontend-patterns.md | /docs/frontend-patterns + /docs/development-flow | migrated | Canonical frontend architecture plus feature implementation flow |
docs/guides/module-composition.md | /docs/module-profiles + /docs/hard-remove-workflow | migrated | Profile model, composition workflow, and permanent removal conventions |
docs/architecture/32-api-architecture.md | /docs/api-interfaces | migrated | Contract-first/oRPC + OpenAPI interface strategy |
docs/architecture/33-role-based-projections.md | /docs/audience-projections | migrated | Audience policy (public/client/admin) and projection rules |
docs/architecture/40-modular-composition.md | /docs/modular-composition + /docs/module-profiles | migrated | Strategy page + profile-specific workflow |
docs/architecture/23-backend-patterns.md | /docs/backend-patterns | migrated | Backend architecture and reliability baseline |
docs/architecture/41-documentation-platform-strategy.md | /docs/canonical-scope | migrated | Docs platform ownership and migration rules |
docs/roadmap.md (C* commerce sprint plan) | /docs/commerce-sprint-plan | migrated | Commerce sequencing and constraints on profile system |
docs/roadmap.md (D* foundation sprint closeout) | /docs/foundation-closeout | migrated | Foundation migration notes and handoff checklist |
docs/guides/getting-started.md | /docs/getting-started | migrated | Quickstart flow now canonical in Fumadocs |
docs/guides/creating-a-module.md | /docs/backend-module-workflow | migrated | Backend module workflow condensed for canonical docs |
docs/guides/creating-a-feature.md | /docs/feature-scaffolding | migrated | Frontend/vertical-slice scaffold flow now canonical |
docs/guides/module-composition.md | /docs/module-composition-guide | migrated | Composition mode and hard-remove sequence canonicalized |
Update rule
When a migrated topic changes:
- Update the canonical page in
apps/docs/content/docs. - Update or trim the linked legacy markdown file if needed.
- Update
docs/roadmap.mdin the same PR.