Documentation migration map
The rework replaced a flat list of research notes, build-pass records, and feature patches with a curated product documentation structure.
No source information was discarded. Exact former pages are retained under docs/internal-notes/legacy-source, excluded from DocFX, and mapped below to the maintained page that now owns their durable content.
| Former public page | Maintained destination | Preservation |
|---|---|---|
AI_HOST_CONTROL_PLANE_ARCHITECTURE.md |
architecture/ai-host.md |
Original retained in internal-notes/legacy-source/top-level/AI_HOST_CONTROL_PLANE_ARCHITECTURE.md |
AI_HOST_DOTNET_BLAZOR_REBUILD_GUIDE.md |
architecture/ai-host.md |
Original retained in internal-notes/legacy-source/top-level/AI_HOST_DOTNET_BLAZOR_REBUILD_GUIDE.md |
AI_HOST_DOTNET_EXPERIMENT.md |
architecture/ai-host.md |
Original retained in internal-notes/legacy-source/top-level/AI_HOST_DOTNET_EXPERIMENT.md |
ARCHITECTURE.md |
architecture/system-overview.md |
Original retained in internal-notes/legacy-source/top-level/ARCHITECTURE.md |
ARCHITECTURE_FOR_AI.md |
architecture/system-overview.md |
Original retained in internal-notes/legacy-source/top-level/ARCHITECTURE_FOR_AI.md |
ASCII_RUNTIME_GAME_PRESETS.md |
guide/embedded-and-games.md |
Original retained in internal-notes/legacy-source/top-level/ASCII_RUNTIME_GAME_PRESETS.md |
BLAZOR_BOOTSTRAP_DEVEXPRESS_DESIGN.md |
architecture/frontend-and-themes.md |
Original retained in internal-notes/legacy-source/top-level/BLAZOR_BOOTSTRAP_DEVEXPRESS_DESIGN.md |
BLAZOR_DEVEXPRESS_AI_GENERATION.md |
architecture/frontend-and-themes.md |
Original retained in internal-notes/legacy-source/top-level/BLAZOR_DEVEXPRESS_AI_GENERATION.md |
CAPABILITY_GAP_CONTRACT.md |
reference/capability-map.md |
Original retained in internal-notes/legacy-source/top-level/CAPABILITY_GAP_CONTRACT.md |
CHAT_PROTOCOLS_AND_SESSION_CONTEXT.md |
architecture/council-runtime.md |
Original retained in internal-notes/legacy-source/top-level/CHAT_PROTOCOLS_AND_SESSION_CONTEXT.md |
COMPILER_VALIDATION_AND_GENERATION_RULES.md |
engineering/build-validation.md |
Original retained in internal-notes/legacy-source/top-level/COMPILER_VALIDATION_AND_GENERATION_RULES.md |
COMPONENT_SAFETY_AND_SHORT_TERM_MEMORY.md |
architecture/system-overview.md |
Original retained in internal-notes/legacy-source/top-level/COMPONENT_SAFETY_AND_SHORT_TERM_MEMORY.md |
DATABASE_FIRST_PROJECT_ARCHITECTURE.md |
architecture/project-data.md |
Original retained in internal-notes/legacy-source/top-level/DATABASE_FIRST_PROJECT_ARCHITECTURE.md |
DATABASE_MIGRATION_BOOTSTRAP.md |
architecture/project-data.md |
Original retained in internal-notes/legacy-source/top-level/DATABASE_MIGRATION_BOOTSTRAP.md |
DEVEXPRESS_ASSETS.md |
architecture/frontend-and-themes.md |
Original retained in internal-notes/legacy-source/top-level/DEVEXPRESS_ASSETS.md |
DOTNET_AI_HOST_ARCHITECTURE_PATTERNS.md |
architecture/ai-host.md |
Original retained in internal-notes/legacy-source/top-level/DOTNET_AI_HOST_ARCHITECTURE_PATTERNS.md |
DXAI_FUNCTIONS_AND_CHANGE_REVIEWS.md |
architecture/council-runtime.md |
Original retained in internal-notes/legacy-source/top-level/DXAI_FUNCTIONS_AND_CHANGE_REVIEWS.md |
EF_DEVEXPRESS_BUSINESS_OBJECTS.md |
architecture/project-data.md |
Original retained in internal-notes/legacy-source/top-level/EF_DEVEXPRESS_BUSINESS_OBJECTS.md |
EF_MIGRATION_SNAPSHOT_ARCHITECTURE.md |
architecture/project-data.md |
Original retained in internal-notes/legacy-source/top-level/EF_MIGRATION_SNAPSHOT_ARCHITECTURE.md |
FRONTEND_DESIGN_PATTERN_LIBRARY.md |
architecture/frontend-and-themes.md |
Original retained in internal-notes/legacy-source/top-level/FRONTEND_DESIGN_PATTERN_LIBRARY.md |
FRONTEND_TEST_AUTOMATION.md |
engineering/build-validation.md |
Original retained in internal-notes/legacy-source/top-level/FRONTEND_TEST_AUTOMATION.md |
GENERATION_ARCHETYPE_CONTRACTS.md |
architecture/system-overview.md |
Original retained in internal-notes/legacy-source/top-level/GENERATION_ARCHETYPE_CONTRACTS.md |
HUMAN_AI_COLLABORATION.md |
architecture/council-runtime.md |
Original retained in internal-notes/legacy-source/top-level/HUMAN_AI_COLLABORATION.md |
JAVASCRIPT_RUNTIME_DIAGNOSTICS.md |
engineering/build-validation.md |
Original retained in internal-notes/legacy-source/top-level/JAVASCRIPT_RUNTIME_DIAGNOSTICS.md |
LOCALGPT_CAPABILITY_SNAPSHOT.md |
reference/capability-map.md |
Original retained in internal-notes/legacy-source/top-level/LOCALGPT_CAPABILITY_SNAPSHOT.md |
LOCALGPT_DEVELOPER_DIARY.md |
reference/design-evolution.md |
Original retained in internal-notes/legacy-source/top-level/LOCALGPT_DEVELOPER_DIARY.md |
LOCALGPT_WORKFLOW_MEMORY.md |
reference/design-evolution.md |
Original retained in internal-notes/legacy-source/top-level/LOCALGPT_WORKFLOW_MEMORY.md |
LOGGING_INTEGRITY.md |
engineering/build-validation.md |
Original retained in internal-notes/legacy-source/top-level/LOGGING_INTEGRITY.md |
MICROSOFT_DOTNET_SAMPLE_CURRICULUM.md |
architecture/frontend-and-themes.md |
Original retained in internal-notes/legacy-source/top-level/MICROSOFT_DOTNET_SAMPLE_CURRICULUM.md |
MINECRAFT_MOD_AI_BUILDER.md |
guide/embedded-and-games.md |
Original retained in internal-notes/legacy-source/top-level/MINECRAFT_MOD_AI_BUILDER.md |
MINECRAFT_SOURCE_KNOWLEDGE.md |
guide/embedded-and-games.md |
Original retained in internal-notes/legacy-source/top-level/MINECRAFT_SOURCE_KNOWLEDGE.md |
ONEWIRE_RUNTIME_SECURITY_HTTP_JSON.md |
architecture/onewire-security.md |
Original retained in internal-notes/legacy-source/top-level/ONEWIRE_RUNTIME_SECURITY_HTTP_JSON.md |
OPEN_TASKS.md |
engineering/maintenance-status.md |
Original retained in internal-notes/legacy-source/top-level/OPEN_TASKS.md |
OPEN_WIRINGS_2.0.3.md |
reference/design-evolution.md |
Original retained in internal-notes/legacy-source/top-level/OPEN_WIRINGS_2.0.3.md |
ORGANIC-AI-COUNCIL-BLUEPRINT-v1.6.md |
architecture/onewire-security.md |
Original retained in internal-notes/legacy-source/top-level/ORGANIC-AI-COUNCIL-BLUEPRINT-v1.6.md |
ORGANIC_AI_COUNCIL_BLUEPRINT_2_1.md |
architecture/onewire-security.md |
Original retained in internal-notes/legacy-source/top-level/ORGANIC_AI_COUNCIL_BLUEPRINT_2_1.md |
PROJECT-MAINTENANCE-WORKSPACES-TOOLCHAINS.md |
architecture/project-data.md |
Original retained in internal-notes/legacy-source/top-level/PROJECT-MAINTENANCE-WORKSPACES-TOOLCHAINS.md |
PROJECT_COLLABORATION.md |
architecture/project-data.md |
Original retained in internal-notes/legacy-source/top-level/PROJECT_COLLABORATION.md |
PROJECT_IDENTITY.md |
reference/design-evolution.md |
Original retained in internal-notes/legacy-source/top-level/PROJECT_IDENTITY.md |
PROJECT_STANCE.md |
reference/design-evolution.md |
Original retained in internal-notes/legacy-source/top-level/PROJECT_STANCE.md |
README_IMAGE_PLAN.md |
internal-notes/legacy-source/top-level/README_IMAGE_PLAN.md |
Original retained in internal-notes/legacy-source/top-level/README_IMAGE_PLAN.md |
RELEASE_PROCESS.md |
engineering/release-and-docs.md |
Original retained in internal-notes/legacy-source/top-level/RELEASE_PROCESS.md |
SAFE_REWORK_MANIFEST.md |
reference/documentation-migration.md |
Original retained in internal-notes/legacy-source/top-level/SAFE_REWORK_MANIFEST.md |
SAFE_STATIC_RUNTIME_AND_DIAGNOSTICS_POLICY.md |
engineering/build-validation.md |
Original retained in internal-notes/legacy-source/top-level/SAFE_STATIC_RUNTIME_AND_DIAGNOSTICS_POLICY.md |
THEME_RUNTIME_ARCHITECTURE.md |
architecture/frontend-and-themes.md |
Original retained in internal-notes/legacy-source/top-level/THEME_RUNTIME_ARCHITECTURE.md |
index.md (former generated landing source) |
index.md (curated landing page) |
Original retained in internal-notes/legacy-source/top-level/index.md |
Public release articles
The former release-specific articles under docs/articles are preserved under internal-notes/legacy-source/articles. Stable feature behavior was folded into the user guide and architecture pages; patch-version narration is no longer mixed into the timeless documentation.
| Former article | Maintained destination | Preservation |
|---|---|---|
articles/chat-and-council.md |
guide/chat-and-council.md and architecture/council-runtime.md |
Original retained in internal-notes/legacy-source/articles/chat-and-council.md |
articles/embedded-firmware.md |
guide/embedded-and-games.md |
Original retained in internal-notes/legacy-source/articles/embedded-firmware.md |
articles/workspaces.md |
guide/projects-and-workspaces.md and architecture/project-data.md |
Original retained in internal-notes/legacy-source/articles/workspaces.md |
articles/security.md |
architecture/onewire-security.md and architecture/system-overview.md |
Original retained in internal-notes/legacy-source/articles/security.md |
articles/game-director.md |
guide/embedded-and-games.md and architecture/council-runtime.md |
Original retained in internal-notes/legacy-source/articles/game-director.md |
articles/documentation.md |
guide/documentation.md and engineering/release-and-docs.md |
Original retained in internal-notes/legacy-source/articles/documentation.md |
articles/provider-qualified-council-benchmarking.md |
guide/chat-and-council.md and reference/capability-map.md |
Original retained in internal-notes/legacy-source/articles/provider-qualified-council-benchmarking.md |
articles/build-policy-council-recovery.md |
engineering/build-validation.md and architecture/council-runtime.md |
Original retained in internal-notes/legacy-source/articles/build-policy-council-recovery.md |
articles/removable-chat-ascii-console.md |
guide/embedded-and-games.md |
Original retained in internal-notes/legacy-source/articles/removable-chat-ascii-console.md |
Why this structure is safer
- Readers see current behavior first.
- Architecture is grouped by boundary rather than by the order it was learned.
- Important AI Host and Council material remains prominent.
- Local archive paths and source-acquisition notes are not presented as product design.
- Repository archaeology remains possible when a maintainer needs the original context.