ZAIXOS Engineering Platform — Product Capabilities

Document type: Product Definition
Version: 1.0 · Phase: 12-2
Status: Permanent product authority
Stability levels: Aligned with PLATFORM_PUBLIC_API.md — Public, Internal, Experimental, Deprecated

---

Capability Map Overview

ID	Capability	Purpose	Owner	Stability (v1)
C-01	Engineering Governance	Define platform authority, boundaries, ADRs	D-P Platform	Public (docs)
C-02	Runtime Platform	Abstract ERP runtime model	D-P Platform	Public (spec)
C-03	Runtime Contracts	Obligate adapter behavior (contracts@1)	D-P Platform	Public — frozen
C-04	Runtime Adapters	Materialize contracts in IDE workspace	D-A Adapter	Public (certified profiles)
C-05	Validation	Integrity + contract conformance tests	D-P Platform · D-R invokes	Public (test commands)
C-06	Templates	Reports, prompts, manifests	D-P Platform	Public
C-07	Knowledge	Developer guide, indexes, onboarding	D-P Platform	Public
C-08	Installation	Deliver platform into product repo	D-P Platform	Internal → Public at GA
C-09	CLI	Local validate, materialize, diagnose	D-P Platform	Experimental
C-10	SDK	Tooling integration API	D-P Platform	Experimental
C-11	Extensions	Product-specific registry without core edits	D-P spec · D-R registers	Public (registry schema)
C-12	Future Services	Marketplace, hosted validation, org policy	D-P Platform	Future / Experimental

---

C-01 — Engineering Governance

Attribute	Value
Purpose	Single authority for how ZAIXOS engineers: constitution, boundaries, versioning, extension rules
Owner	Platform (D-P) — Platform Architect
Stability	Public documents semver with platform major releases
Artifacts	PLATFORM_CONSTITUTION.md, PLATFORM_BOUNDARIES.md, ADRs
Consumer	All personas; architects enforce in product repos

---

C-02 — Runtime Platform

Attribute	Value
Purpose	Define abstract Runtime Components independent of IDE file formats
Owner	Platform (D-P)
Stability	Public specification; breaking changes require major platform version
Artifacts	Runtime spec prose, component definitions, manifest schemas
Consumer	Adapter authors, architects, validation

---

C-03 — Runtime Contracts

Attribute	Value
Purpose	Machine-readable obligations adapters must satisfy
Owner	Platform (D-P)
Stability	contracts@1 frozen — no obligation changes without new contract major
Artifacts	Contract JSON, JSON schemas, component manifests
Consumer	Adapters (implement), validation (verify)

---

C-04 — Runtime Adapters

Attribute	Value
Purpose	Translate platform semantics → native IDE artifacts (e.g. Cursor rules, skills, hooks)
Owner	Adapter maintainer (D-A) under Platform Architect
Stability	Public adapter profile + manifest version; workspace template Internal until documented
Artifacts	adapters/cursor-v1/ (future repo path), .cursor/ in product (materialized)
Consumer	Developers (session); products pin adapter compatibility in lock file

v1 certified adapter: Cursor Adapter v1 (1.0.0-phase-11-9 baseline semantics)

---

C-05 — Validation

Attribute	Value
Purpose	Prove platform + adapter + product integration integrity before merge/release
Owner	Platform owns tests; Product owns CI wiring (D-V)
Stability	Public test entrypoints and pass criteria
Artifacts	EngineeringRuntimePlatformIntegrityTest, acceptance checklists
Consumer	Developers locally; CI on PR

---

C-06 — Templates

Attribute	Value
Purpose	Standardize phase outputs and architect reviews
Owner	Platform (D-P)
Stability	Public template structure (section counts fixed per version)
Artifacts	Format A/B reports, RESPONSE_TEMPLATE, phase prompts
Consumer	Runtime Implementation, Architect

---

C-07 — Knowledge

Attribute	Value
Purpose	Onboard developers and integrators without oral tradition
Owner	Platform (D-P) for platform docs; Product for product docs
Stability	Public developer guide; Internal runbooks for platform team
Artifacts	docs/developer-guide.md (future), PRODUCT_* specs, ERP_DEVELOPER_GUIDE (transitional)
Consumer	All developers

---

C-08 — Installation

Attribute	Value
Purpose	Place platform artifacts in product repo deterministically
Owner	Platform (D-P)
Stability	Internal during extraction; Public at platform v1.0.0 GA
Artifacts	Composer package layout, post-install hooks (future), lock file
Consumer	Product integrator, solo developer
v1 note	Specification defines Composer primary; implementation not part of 12-2

---

C-09 — CLI

Attribute	Value
Purpose	validate, materialize, doctor, version reporting
Owner	Platform (D-P)
Stability	Experimental — not required for v1 GA
Artifacts	Future zaixos binary
Consumer	Developers, CI (optional wrapper)

---

C-10 — SDK

Attribute	Value
Purpose	Programmatic access for custom tooling (IDE plugins, CI generators)
Owner	Platform (D-P)
Stability	Experimental
Artifacts	Future PHP/TS library exposing Public surfaces only
Consumer	Platform team, advanced integrators

---

C-11 — Extensions

Attribute	Value
Purpose	Product-specific rules/skills without mutating platform core
Owner	Platform owns schema (D-P); Product registers entries (D-R)
Stability	Public registry schema; extension content Internal to product
Artifacts	.zaixos/extensions/manifest.yml
Consumer	Product teams customizing AI behavior within bounds

---

C-12 — Future Services

Attribute	Value
Purpose	Ecosystem capabilities beyond local package
Owner	Platform (D-P)
Stability	Not classified until ADR
Examples	Marketplace, hosted validation, org extension signing
Consumer	Enterprise, multi-product orgs

---

Capability Dependencies

C-01 Governance
    └── C-02 Runtime Platform
            └── C-03 Runtime Contracts
                    └── C-04 Runtime Adapters
                            └── C-05 Validation
C-06 Templates ──► C-07 Knowledge
C-08 Installation ──► delivers C-01…C-07
C-09 CLI ──► wraps C-05, C-08 (future)
C-10 SDK ──► wraps Public portions of C-05, C-08 (future)
C-11 Extensions ──► extends C-04 without changing C-03
C-12 Future Services ──► optional overlay

---

Product Capabilities v1.0 — Phase 12-2.