ZAIXOS Engineering Platform — Asset Lifecycle

Document type: Technical Specification
Version: 1.0 · Phase: 12-3
Status: Permanent technical authority
Related: PLATFORM_STATE_MACHINE.md · EVOLUTION_MODEL.md

---

Purpose

Define lifecycle, versioning, approval, deprecation, removal, migration, and compatibility for every platform asset class.

States reference PLATFORM_STATE_MACHINE.md.

---

Lifecycle matrix (summary)

Asset	Owner	Version ID	Approval	Deprecation	Removal	Migration
Platform release	D-P	semver	Architect + validation	ADR + MAJOR cycle	Never removed — archived tags	Migration guide per MAJOR
Contract	D-P	contracts@N	ADR	New @N+1	Old frozen read-only	Adapter re-cert
Workflow	D-P / D-R ext	manifest + platform semver	Architect	Platform MINOR notice	MAJOR inventory change	Rematerialize
Procedure	D-P / D-R ext	manifest + platform semver	Architect	Same	Same	Rematerialize
Rule	D-P / D-R ext	manifest + platform semver	Architect	Same	Extension limit	Rematerialize
Template	D-P	platform semver	Architect	Deprecated catalog	MAJOR	Copy new template
Knowledge	D-P / D-R	pack id + Git	Architect (product)	Doc notice	Delete pack	Manual merge
Adapter	D-A	adapter semver	Certification checklist	Adapter deprecation	Uncertify	Switch adapter ID
Manifest	D-P	schemaVersion	ADR if count change	schema MAJOR	N/A	schema migration
ADR	D-P	sequential	Architect	Superseded by new ADR	Archived	Pointer update
RFC	D-P	draft id	N/A until ADR	Abandon	Archive	→ ADR
Validation suite	D-P	platform semver	Platform Developer	Test deprecation	MAJOR	Update CI
Configuration	D-R	lockSchema	Integrator	schema MAJOR	N/A	Regenerate lock
Documentation	D-P / D-R	doc version footer	Review state machine	Deprecated catalog	Archive	Link update

---

Platform release

Phase	Activity
Create	Branch from previous tag
Version	semver per VERSIONING_POLICY
Approve	Validation green + CHANGELOG
Publish	Tag zaixos-platform@vX.Y.Z
Deprecate	Announce in MINOR; remove features in MAJOR
Migrate	docs/migrations/vN-to-vN+1.md
Compatibility	Matrix in release doc

---

Contract

Phase	Activity
Create	ADR + contract document
Version	contracts@N integer
Approve	Architect + adapter impact review
Publish	Bundled in platform MAJOR
Deprecate	Never amend @N — publish @N+1
Migrate	Products pin until adapter certified for @N+1
Compatibility	Platform MAJOR aligns with contract MAJOR on breaks

Frozen: contracts@1 for platform 1.x — no obligation changes.

---

Workflow / Procedure / Delegate

Phase	Activity
Create	Platform default in adapter template OR product extension
Version	Tied to platform semver; extension via Git history
Approve	Architect phase acceptance
Publish	Materialization
Deprecate	Remove from manifest + rematerialize
Migrate	ID change = new artifact; collision forbidden
Compatibility	Additive platform MINOR adds defaults

---

Rule (Constraint)

Phase	Activity
Create	Platform A–G in adapter; product C–G extensions
Version	Platform semver
Approve	Architect; extension rules need scope review
Publish	Materialization
Deprecate	Remove file + registry entry
Migrate	Recategorize forbidden for A–B product rules
Compatibility	Extensions cannot weaken A–B

---

Template

Phase	Activity
Create	Platform templates/
Version	Platform semver; section count locked per MAJOR
Approve	Architect (RESPONSE_TEMPLATE changes = MAJOR review)
Publish	Platform release
Deprecate	Deprecated catalog (e.g. eight-section template)
Migrate	Products copy new skeleton
Compatibility	Format A/B section counts Public

---

Knowledge

Phase	Activity
Create	knowledge/ or extensions/knowledge/
Version	Informal Git; optional pack version file
Approve	Architect for product packs
Publish	Registration in manifest (product)
Deprecate	Remove manifest entry
Migrate	Manual
Compatibility	Never auto-injected as constraints

---

Adapter

Phase	Activity
Create	Platform adapters/{id}/
Version	adapter semver + platformCompatibility range
Approve	AdapterWorkspaceTest + manual checklist
Publish	Certified adapter ID in Public API
Deprecate	ADR; warn in validation
Remove	MAJOR platform — uncertify ID
Migrate	Change adapter.id in platform.yml + rematerialize
Compatibility	PATCH adapter with platform PATCH/MINOR

---

Manifest (schema + defaults)

Phase	Activity
Create	runtime/manifests/
Version	schemaVersion per type
Approve	ADR if inventory count changes
Publish	Platform release
Deprecate	schema MAJOR
Migrate	Migration guide + validation update
Compatibility	Count locked per platform MAJOR

---

ADR / RFC

Phase	Activity
RFC	Draft → Reviewed → ADR or Archived
ADR	Accepted → Released; superseded → Deprecated → Archived
Version	Immutable text; supersession pointer
Migration	New ADR references old

---

Validation suite

Phase	Activity
Create	validation/tests/
Version	Platform semver
Approve	Green on reference product
Publish	With platform release
Deprecate	Test marked skipped one MINOR
Remove	MAJOR
Migrate	Products update CI expectations

---

Configuration (product)

Phase	Activity
Create	platform.yml + lock + extensions
Version	lockSchemaVersion
Approve	Integrator + validation
Publish	Git commit
Deprecate	schema bump
Migrate	Regenerate from schema migration tool (future CLI)
Compatibility	lock must match installed platform

---

Documentation

Phase	Activity
Create	Author draft
Version	Footer version + phase
Approve	State machine to Released
Publish	Index update
Deprecate	Superseded banner + pointer
Archive	Move to archive/ with redirect

---

Removal policy (global)

Asset type	Hard removal allowed
Platform tag	Never — immutable history
Contract @N	Never — read-only forever
Public API path	MAJOR only after deprecation
Extension	Product anytime (manifest)
Embedded ERP copy	Phase 12-7+ product cleanup

---

Asset Lifecycle v1.0 — Phase 12-3.