ZAIXOS Engineering Platform — Release Plan

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

---

Purpose

Define platform release sequence, consumer release sequence, and dependency order through GA.

---

Release timeline

12-5:  (no public release)     internal scaffold only
12-6:  1.0.0-rc.1 … rc.n       platform repo pre-release tags
12-7:  1.0.0-rc.final          consumer pins rc (Dental Clinic integration branch)
12-8:  1.0.0-rc.final          validation sign-off (no version bump if unchanged)
12-9:  1.0.0 GA                zaixos-platform@v1.0.0 + Packagist publish
       Product release note     Dental Clinic documents platform consumer cutover

---

Platform release sequence

Order	Release	Artifact	Depends on
R1	1.0.0-rc.1	First extraction wave merged	12-5 scaffold
R2	1.0.0-rc.2+	Incremental waves	R1 + wave gates
R3	1.0.0-rc.final	All waves + platform CI green	R2 + EX-W6
R4	1.0.0 GA	Tag + CHANGELOG + compatibility matrix	12-8 PV-* pass

Publishing: Packagist (or private Composer registry) at R4 only for production consumers.

---

Consumer release sequence (Dental Clinic)

Order	Action	Depends on
C1	Integration branch: composer require rc	R3 published
C2	.zaixos/ + materialization	C1
C3	CI green on integration branch	C2 + CO-*
C4	Merge to main (Architect acceptance)	12-8 PV-*
C5	Product release doc: "Platform consumer @ 1.0.0"	R4 + C4
C6	Remove embedded ERP (12-9)	C5

Rule: C4 must not precede R3. C6 must not precede R4.

---

Dependency order graph

12-5 Scaffold
    ↓
12-6 R1 rc.1 (Wave 1)
    ↓
12-6 R2 rc.n (Waves 2–8)
    ↓
R3 rc.final
    ↓
12-7 C1–C3 Consumer integration
    ↓
12-8 Validation sign-off
    ↓
R4 GA 1.0.0  ──►  C4–C6 Consumer cutover complete

---

Release artifacts (platform GA)

Artifact	Location
Git tag	zaixos-platform@v1.0.0
CHANGELOG	Platform repo CHANGELOG.md
Compatibility matrix	docs/releases/v1.0.0.md
Composer dist	zaixos/engineering-platform 1.0.0
Checksum manifest	Release notes (adapter workspace SHA-256)
Migration guide ERP→ZEP	docs/migrations/embedded-to-composer.md

---

Release artifacts (consumer)

Artifact	Location
.zaixos/platform.lock @ 1.0.0	Dental Clinic repo
composer.lock update	Dental Clinic repo
Product release doc section	docs/releases/ (product)
AGENTS.md platform pointer	Product root

---

Release coordination

Role	Platform release	Consumer release
Platform Architect	Approve R4	Review C4
Platform Developer	Execute tag (Developer Git)	Support materialization
Product Architect	—	Approve C4, C6
Product Developer	—	Execute composer + CI

---

Post-GA release train

After 12-9:

Type	Cadence	Consumer action
PATCH	As needed	Lock bump + composer update
MINOR	Quarterly target	Review CHANGELOG + validation
MAJOR	ADR-driven	Migration guide + Architect review

Per RELEASE_STRATEGY.md.

---

Release blockers (hard)

• Any EX-W* failure open
• PV-1 parity fail
• contractMajor mismatch
• Architect rejection on 12-8 Format B
• KPI-8 adapter conformance < 100%

---

Release Plan v1.0 — Phase 12-4.