ZAIXOS Engineering Platform — Migration Matrix
Document type: Extraction Planning Specification
Version: 1.0 · Phase: 12-4
Status: Permanent execution authority
Purpose
Every asset: current location, future location, owner, migration phase, validation method, risk level.
Risk levels: L Low · M Medium · H High · C Critical (rollback mandatory on fail)
Ownership transition matrix
| Domain | Before extraction | During dual-run (12-6–12-8) | After 12-9 GA |
|---|---|---|---|
| Platform content authority | D-P (hosted in Dental Clinic) | D-P (platform repo canonical) | D-P (platform repo only) |
| Platform file host | D-R (Dental Clinic) | D-R + platform repo | Platform package in vendor |
| Adapter workspace source | D-A (.cursor/ in product) | Platform repo + materialized copy | Materialized from package |
| Validation definitions | D-P (tests in product) | D-P (tests in platform package) | D-P (product invokes) |
| CI execution | D-R | D-R | D-R |
| Product modules | D-R | D-R | D-R |
Section A — Platform governance docs
| Asset | Current | Future | Owner | Phase | Validation | Risk |
|---|---|---|---|---|---|---|
| Platform Constitution | core/constitution/PLATFORM_CONSTITUTION.md | core/constitution/ | D-P | 12-6 W1 | Doc diff zero | L |
| Platform Boundaries | core/constitution/PLATFORM_BOUNDARIES.md | core/constitution/ | D-P | 12-6 W1 | Doc diff zero | L |
| Platform Public API | core/constitution/PLATFORM_PUBLIC_API.md | core/constitution/ | D-P | 12-6 W1 | Doc diff zero | L |
| Extension Model | core/constitution/PLATFORM_EXTENSION_MODEL.md | core/constitution/ | D-P | 12-6 W1 | Doc diff zero | L |
| Versioning Policy | core/constitution/PLATFORM_VERSIONING_POLICY.md | core/constitution/ | D-P | 12-6 W1 | Doc diff zero | L |
| Platform Index | core/index/PLATFORM_INDEX.md | core/index/ | D-P | 12-6 W1 | Link check | L |
| ADR-001–005 | docs/platform/adr/ | docs/platform/adr/ | D-P | 12-6 W1 | Doc diff zero | L |
| Product specs | docs/platform/product/ | docs/product/ | D-P | 12-6 W1 | Index links | L |
| Technical specs | docs/platform/technical/ | docs/technical/ | D-P | 12-6 W1 | Index links | L |
| Planning specs | docs/platform/planning/ | docs/planning/ | D-P | 12-6 W1 | Index links | L |
Section B — Contracts and runtime specification
| Asset | Current | Future | Owner | Phase | Validation | Risk |
|---|---|---|---|---|---|---|
| Runtime contracts @1 | contracts/runtime-contracts.md | contracts/runtime-contracts.md | D-P | 12-6 W2 | Byte compare obligations | C |
| ERP platform spec | runtime/specification/engineering-runtime-platform.md | runtime/specification/engineering-runtime-platform.md | D-P | 12-6 W2 | Cross-ref test | M |
| Procedures/workflows spec | docs/development/phase-11-4-*.md | runtime/components/ | D-P | 12-6 W2 | Cross-ref test | M |
| Phase 10 historical | docs/development/phase-10-*.md | runtime/specification/archive/ | D-P | 12-6 W2 | Archive marker | L |
| Contract JSON schemas | (derived) | contracts/schemas/ | D-P | 12-6 W2 | Schema validate | M |
Section C — Methodology and templates
| Asset | Current | Future | Owner | Phase | Validation | Risk |
|---|---|---|---|---|---|---|
| DEVELOPMENT_WORKFLOW | core/methodology/DEVELOPMENT_WORKFLOW.md | core/methodology/ | D-P | 12-6 W3 | EOS integrity test | M |
| RESPONSE_TEMPLATE | core/methodology/RESPONSE_TEMPLATE.md | core/methodology/ | D-P | 12-6 W3 | 9-section guard | C |
| GIT_FREEZE_PROCEDURE | core/methodology/GIT_FREEZE_PROCEDURE.md | core/methodology/ | D-P | 12-6 W3 | Link check | M |
| CONTEXT_FILE_POLICY | core/methodology/CONTEXT_FILE_POLICY.md | core/methodology/ | D-P | 12-6 W3 | Link check | L |
| Report templates | templates/ | templates/ | D-P | 12-6 W3 | Format A/B test | M |
| Phase prompts | templates/prompts/ | templates/prompts/ | D-P | 12-6 W3 | Count parity | M |
| Knowledge packs | knowledge/ | knowledge/ | D-P | 12-6 W3 | Size/count | L |
Section D — Manifests
| Asset | Current | Future | Owner | Phase | Validation | Risk |
|---|---|---|---|---|---|---|
| skills-manifest | runtime/manifests/defaults/procedures-manifest.md | runtime/manifests/defaults/procedures-manifest.md | D-P | 12-6 W4 | Count = 10 | C |
| commands-catalog | runtime/manifests/defaults/workflows-catalog.md | runtime/manifests/defaults/workflows-catalog.md | D-P | 12-6 W4 | Count = 10 | C |
| agents-manifest | runtime/manifests/defaults/delegation-manifest.md | runtime/manifests/defaults/delegation-manifest.md | D-P | 12-6 W4 | Count = 10 | C |
| enforcement-manifest | runtime/manifests/defaults/enforcement-manifest.md | runtime/manifests/defaults/enforcement-manifest.md | D-P | 12-6 W4 | Count = 4 handlers | C |
| context-providers-manifest | runtime/manifests/defaults/context-providers-manifest.md | runtime/manifests/defaults/context-providers-manifest.md | D-P | 12-6 W4 | Count = 3 | M |
| execution-manifest | runtime/manifests/defaults/execution-manifest.md | runtime/manifests/defaults/execution-manifest.md | D-P | 12-6 W4 | Count = 4 modes | M |
Section E — Adapter (Cursor v1)
| Asset | Current | Future | Owner | Phase | Validation | Risk |
|---|---|---|---|---|---|---|
| Rules (9) | .cursor/rules/*.mdc | adapters/.../workspace/rules/ | D-A | 12-6 W5 | RULE_COUNT | C |
| Rule catalogs (11) | .cursor/rules/catalogs/ | same tree | D-A | 12-6 W5 | CATALOG_COUNT | M |
| Procedure skills (10) | .cursor/skills/{domain}/ | workspace/skills/ | D-A | 12-6 W5 | PROCEDURE_COUNT | C |
| Workflow skills (10) | .cursor/skills/{workflow}/ | workspace/skills/ | D-A | 12-6 W5 | WORKFLOW_COUNT | C |
| Agents (10) | .cursor/agents/ | workspace/agents/ | D-A | 12-6 W5 | DELEGATION_COUNT | C |
| Hooks | .cursor/hooks.json + hooks | workspace/hooks/ | D-A | 12-6 W5 | Handler IDs | C |
| MCP templates | .cursor/mcp/ | workspace/mcp/ | D-A | 12-6 W5 | Provider IDs | M |
| Execution config | .cursor/cli.json, environment.json | workspace/ | D-A | 12-6 W5 | EXECUTION_MODE_COUNT | M |
| Adapter profile | adapters/cursor-adapter-v1/profile.md | adapters/.../profile.md | D-A | 12-6 W5 | Profile sections | M |
| Adapter metadata | adapters/cursor-adapter-v1/manifest.json | adapters/.../manifest.json | D-A | 12-6 W5 | ContractComplianceTest | C |
Section F — Validation suite
| Asset | Current | Future | Owner | Phase | Validation | Risk |
|---|---|---|---|---|---|---|
| ERP integrity test | tests/Architecture/EngineeringRuntimePlatformIntegrityTest.php | validation/tests/ | D-V | 12-6 W6 | Self-green | C |
| EOS integrity test | tests/Architecture/EngineeringOperatingSystemIntegrityTest.php | validation/tests/ | D-V | 12-6 W6 | Self-green | C |
| ErpIntegritySupport | tests/Architecture/Support/ | validation/src/Support/ | D-V | 12-6 W6 | Constant parity | C |
| EosIntegritySupport | tests/Architecture/Support/ | validation/src/Support/ | D-V | 12-6 W6 | Path update tests | C |
| GovernanceDocumentationTest | tests/Architecture/ | Split product/platform | D-V/D-R | 12-7 | Both suites green | H |
Section G — Developer-facing docs
| Asset | Current | Future | Owner | Phase | Validation | Risk |
|---|---|---|---|---|---|---|
| ERP Developer Guide | docs/developer-guide.md | docs/developer-guide.md | D-P | 12-6 W8 | Onboarding review | M |
| Runtime validation doc | docs/runtime-validation.md | docs/runtime-validation.md | D-P | 12-6 W8 | Command parity | M |
| Acceptance checklist | docs/acceptance-checklist.md | docs/acceptance-checklist.md | D-P | 12-6 W8 | Checklist complete | M |
| Engineering Index | docs/development/ENGINEERING_INDEX.md | Deprecated → redirect | D-P | 12-9 | Stub link | L |
| AI Development Environment | docs/development/AI_DEVELOPMENT_ENVIRONMENT.md | Merge into developer-guide § | D-P | 12-6 W8 | Section parity | M |
| erp-freeze-preparation | docs/planning/archive/erp-freeze-preparation.md | docs/planning/archive/ | D-P | 12-6 W8 | Historical | L |
Section H — Consumer configuration (created in product)
| Asset | Current | Future | Owner | Phase | Validation | Risk |
|---|---|---|---|---|---|---|
| platform.yml | — | .zaixos/platform.yml | D-R | 12-7 | ConfigSchemaTest | M |
| platform.lock | — | .zaixos/platform.lock | D-R | 12-7 | Lock parity | C |
| extensions manifest | — | .zaixos/extensions/manifest.yml | D-R | 12-7 | ExtensionSchemaTest | L |
| composer require | — | composer.json | D-R | 12-7 | composer install | M |
| Materialized adapter | .cursor/ (source) | .zaixos/adapters/.../ + mount | D-R | 12-7 | ChecksumIntegrityTest | C |
Section I — Never migrate
| Asset | Current | Future | Owner | Phase | Validation | Risk |
|---|---|---|---|---|---|---|
| Application modules | app/Modules/ | Stays | D-R | — | ModuleBoundaryTest | — |
| Product constitution | docs/architecture/ | Stays | D-R | — | Architecture tests | — |
| Clinic migrations | database/migrations/ | Stays | D-R | — | — | — |
| Filament resources | app/Filament/ | Stays | D-R | — | — | — |
| Company docs | docs/company/ | Stays | Company | — | — | — |
Section J — Remove after GA (12-9)
| Asset | Action | Phase | Validation | Risk |
|---|---|---|---|---|
| Embedded ERP authority docs | Delete (keep stub README) | 12-9 | KPI-10 = 0 | M |
| Duplicate integrity support in product | Remove; use vendor tests | 12-9 | CI green | M |
Authoritative .cursor/ without mount | Remove; materialize only | 12-9 | Checksum test | H |
Critical path assets (must not fail)
contracts/runtime-contracts.md(obligations)adapters/cursor-adapter-v1/manifest.json- Adapter workspace checksum
RESPONSE_TEMPLATE.md(9 sections)- Manifest inventory counts
platform.lockat consumer cutover
Failure on any → stop extraction wave, execute ROLLBACK_PLAN.md.
Migration Matrix v1.0 — Phase 12-4.