Skip to main content

Architecture documentation migration inventory

This inventory records the consolidation of the Agentstration DAT under docs/architecture/. Former published paths remain as replacement pointers; canonical content is maintained only at the destinations below.

Former flat architecture pages​

Compatibility pathCanonical destinationReconciliation status
docs/architecture/system-context.mdarchitecture/c4/system-context.mdMigrated; the shared LikeC4 model owns C4 structure
docs/architecture/containers.mdarchitecture/c4/containers.mdMigrated after executable, store, and AEP reconciliation
docs/architecture/components.mdarchitecture/c4/server-components.mdMigrated with responsibility-to-project mapping
docs/architecture/dynamic-views.mdarchitecture/runtime/dynamic-views.mdMigrated with consolidated Mermaid scenarios
docs/architecture/runtime-execution.mdarchitecture/runtime/agent-execution.mdMigrated; scenarios remain in the dynamic-view catalog
docs/architecture/flow-execution.mdarchitecture/runtime/flow-execution.mdMigrated; scenarios remain in the dynamic-view catalog
docs/architecture/project-structure.mdarchitecture/implementation/project-structure.mdMigrated without treating projects as C4 components
docs/architecture/dependency-rules.mdarchitecture/implementation/dependency-rules.mdMigrated; rules remain narrative and test-backed
docs/architecture/resource-model.mdarchitecture/data/resource-model.mdMigrated; competing structural flowchart removed
docs/architecture/persistence.mdarchitecture/data/persistence.mdMigrated and reconciled against the executable storage composition in #611
docs/architecture/standalone-mode.mdarchitecture/deployment/standalone.mdMigrated with direct, Aspire, and Compose distinctions
docs/architecture/multi-tenancy.mdarchitecture/cross-cutting/tenancy-and-isolation.mdMigrated and reconciled against current authorization surfaces in #611

docs/architecture/overview.md, conventions.md, interactive.mdx, and this inventory remain canonical entry-point pages.

Former root-level architecture pages​

Compatibility pathCanonical destinationReconciliation status
docs/architecture.mdarchitecture/implementation/current-state.md plus focused DAT pagesDetailed inventory moved intact; focused pages link to it rather than copying it
docs/management-plane.mdC4 server components, data model, and current-state inventoryStable ownership retained; route inventory is implementation/reference evidence
docs/runtime-plane.mdAgent execution and runtime reconciliationReconstructibility and provider boundaries retained
docs/work-plane.mdWork executionStable ownership and lifecycle retained; obsolete local limitations removed
docs/resource-model.mdData resource model and Resource referenceEnvelope and immutability invariants consolidated once
docs/domain-model.mdData model, runtime pages, and ConceptsDurable resource/runtime separation retained without duplicating product concepts
docs/flow.mdFlow execution, dynamic views, and Flow conceptsArchitecture separated from API and authoring guidance
docs/standalone.mdStandalone deploymentSuperseded seed-data and storage claims removed
docs/reconciliation.mdRuntime reconciliationCurrent reconciliation responsibility retained

Sources with separate ownership​

SourceOwnership after DAT migration
docs/decisions/ADR history and decision source; DAT pages link to decisions rather than copying them
docs/concepts/User- and contributor-facing conceptual documentation
docs/reference/Precise product, API, configuration, and resource reference
docs/getting-started/Task-oriented onboarding and launch guidance
docs/contributing/Contributor workflow and governance documentation

Removal gate​

A compatibility page may be removed only when:

  1. every still-valid section has a canonical destination;
  2. obsolete statements have been checked against implementation and ADR evidence;
  3. structural diagrams defer to the published LikeC4 view;
  4. dynamic diagrams have been migrated or deliberately retained as Mermaid;
  5. inbound links and Docusaurus navigation have been updated; and
  6. the complete documentation build succeeds.