Knowledge Portal · engineering documentation

Skip to content

ZAIXOS Engineering Platform — Package Split Plan

Document type: Extraction Planning Specification
Version: 1.0 · Phase: 12-4
Status: Permanent execution authority


Purpose

Define the exact mapping from Dental Clinic ROS paths today to zaixos-engineering-platform paths tomorrow — the Package Transition Matrix.

Single Composer artifact: All mappings target paths inside zaixos/engineering-platform per TDR-001.


Package transition matrix (master)

Current location (Dental Clinic)Future location (platform package)Logical packageWave
core/constitution/PLATFORM_CONSTITUTION.mdcore/constitution/PLATFORM_CONSTITUTION.mdLP-01
core/constitution/PLATFORM_BOUNDARIES.mdcore/constitution/PLATFORM_BOUNDARIES.mdLP-01
core/constitution/PLATFORM_PUBLIC_API.mdcore/constitution/PLATFORM_PUBLIC_API.mdLP-01
core/constitution/PLATFORM_EXTENSION_MODEL.mdcore/constitution/PLATFORM_EXTENSION_MODEL.mdLP-01
core/constitution/PLATFORM_VERSIONING_POLICY.mdcore/constitution/PLATFORM_VERSIONING_POLICY.mdLP-01
core/index/PLATFORM_INDEX.mdcore/index/PLATFORM_INDEX.mdLP-01
docs/platform/adr/*docs/platform/adr/*LP-01
docs/platform/product/*docs/product/*LP-01
docs/platform/technical/*docs/technical/*LP-01
docs/platform/planning/*docs/planning/*LP-01
contracts/runtime-contracts.mdcontracts/runtime-contracts.mdLP-22
runtime/specification/engineering-runtime-platform.mdruntime/specification/engineering-runtime-platform.mdLP-32
runtime/components/phase-11-4-runtime-procedures-workflows-specification.mdruntime/components/*.mdLP-42
docs/development/phase-10-*.mdruntime/specification/archive/LP-32
core/methodology/DEVELOPMENT_WORKFLOW.mdcore/methodology/DEVELOPMENT_WORKFLOW.mdLP-13
core/methodology/RESPONSE_TEMPLATE.mdcore/methodology/RESPONSE_TEMPLATE.mdLP-13
core/methodology/GIT_FREEZE_PROCEDURE.mdcore/methodology/GIT_FREEZE_PROCEDURE.mdLP-13
core/methodology/CONTEXT_FILE_POLICY.mdcore/methodology/CONTEXT_FILE_POLICY.mdLP-13
templates/*templates/*LP-73
templates/prompts/*templates/prompts/*LP-73
runtime/manifests/defaults/procedures-manifest.mdruntime/manifests/defaults/procedures-manifest.mdLP-54
runtime/manifests/defaults/workflows-catalog.mdruntime/manifests/defaults/workflows-catalog.mdLP-54
runtime/manifests/defaults/delegation-manifest.mdruntime/manifests/defaults/delegation-manifest.mdLP-54
runtime/manifests/defaults/enforcement-manifest.mdruntime/manifests/defaults/enforcement-manifest.mdLP-54
runtime/manifests/defaults/context-providers-manifest.mdruntime/manifests/defaults/context-providers-manifest.mdLP-54
runtime/manifests/defaults/execution-manifest.mdruntime/manifests/defaults/execution-manifest.mdLP-54
.cursor/**adapters/cursor-adapter-v1/workspace/**LP-65
adapters/cursor-adapter-v1/profile.mdadapters/cursor-adapter-v1/profile.mdLP-65
adapters/cursor-adapter-v1/manifest.jsonadapters/cursor-adapter-v1/manifest.jsonLP-65
tests/Architecture/EngineeringRuntimePlatformIntegrityTest.phpvalidation/tests/LP-96
tests/Architecture/EngineeringOperatingSystemIntegrityTest.phpvalidation/tests/LP-96
tests/Architecture/Support/ErpIntegritySupport.phpvalidation/src/Support/LP-96
tests/Architecture/Support/EosIntegritySupport.phpvalidation/src/Support/LP-96
docs/developer-guide.mddocs/developer-guide.mdLP-108
docs/runtime-validation.mddocs/runtime-validation.mdLP-108
docs/acceptance-checklist.mddocs/acceptance-checklist.mdLP-108
(spec) config schemasschemas/config/*.jsonLP-117
knowledge/**knowledge/**LP-83

Product repo paths (post-12-7 — created, not extracted)

PathSource
vendor/zaixos/engineering-platform/Composer install
.zaixos/platform.ymlFrom schemas/config/examples/platform.yml
.zaixos/platform.lockGenerated at materialization
.zaixos/platform/Symlink → vendor (default)
.zaixos/extensions/manifest.ymlEmpty template
.zaixos/adapters/cursor-adapter-v1/workspace/Materialized from package
.cursor/Mount → .zaixos/adapters/.../workspace/

Stays in product (not in platform package)

PathPost-migration role
docs/architecture/*Product constitution
docs/development/README.mdStub pointer to platform developer-guide (12-9)
tests/Architecture/ModuleBoundaryTest.phpProduct CI
tests/Architecture/GovernanceDocumentationTest.phpSplit: product rules stay; platform refs updated
phpunit.xmlAdds EngineeringRuntimePlatform testsuite → vendor path
AGENTS.mdProduct module docs + link to .zaixos/

Removed from product (12-9)

PathReplacement
docs/development/ERP_* (authority set)vendor/.../docs/
docs/development/*-manifest.mdPlatform runtime/manifests/defaults
docs/development/ENGINEERING_INDEX.mddeveloper-guide.md
Authoritative .cursor/ copyMaterialized mount only
tests/Architecture/ErpIntegritySupport in productInvoke platform package tests

PatternRewrite
docs/developer-guide.mddocs/developer-guide.md (platform) or @zaixos/engineering-platform doc path
../skills/adapters/cursor-adapter-v1/workspace/skills/ (in platform repo)
docs/platform/core/constitution/ or docs/technical/ as appropriate
contracts/runtime-contracts.mdcontracts/runtime-contracts.md

Automated link check in platform CI after Wave 8.


manifest.json path updates (adapter metadata)

Current runtime-adapter-v1.json paths reference docs/development/must update in platform repo to:

Metadata keyNew relative path (from platform repo root)
procedureManifestruntime/manifests/defaults/procedures-manifest.md
workflowManifestruntime/manifests/defaults/workflows-catalog.md
delegationManifestruntime/manifests/defaults/delegation-manifest.md
enforcementManifestruntime/manifests/defaults/enforcement-manifest.md
contextProviderManifestruntime/manifests/defaults/context-providers-manifest.md
executionManifestruntime/manifests/defaults/execution-manifest.md
adapterProfileadapters/cursor-adapter-v1/profile.md
erpCoreAuthorityruntime/specification/engineering-runtime-platform.md
runtimeContractsAuthoritycontracts/runtime-contracts.md

Semantic content unchanged — path strings only. Validation: ContractComplianceTest.


Package Split Plan v1.0 — Phase 12-4.

ZAIXOS Knowledge Portal — public engineering docs at /docs · Staff operations at /admin