Knowledge Portal · engineering documentation

Skip to content

PL-001 — Engineering Platform (ZEP)

Status: Canonical · GA @ 1.0.0
Owner: Platform Architecture
Repository: zaixos-engineering-platform
Package: zaixos/engineering-platform
Last updated: 2026-07-05


Purpose

Product-independent engineering foundation — methodology, runtime contracts, certified adapters, validation, and this knowledge base.


Responsibilities

Owns

  • Engineering Operating System (EOS) methodology
  • Runtime contracts and materialization pipeline
  • Cursor Adapter v1 (certified IDE integration)
  • Architecture validation suites
  • Official engineering documentation portal (docs/)

Does not own

  • Product domain logic (PRD-xxx)
  • AI agent execution (PL-003)
  • Intelligence / learning (PL-004)
  • Design tokens (PL-002)

Architecture

mermaid
flowchart TB
    subgraph ZEP["PL-001"]
        GOV[Constitution L0]
        METH[Methodology L1]
        CON[Contracts L2]
        RT[Runtime Spec L3]
        ADP[Adapters L4]
        MAT[Materialization L5]
        VAL[Validation L6]
    end
    CONSUMER[Product .zaixos/] --> MAT
    MAT --> ADP
    ADP --> CON

Contracts

Primary consumer surface: runtime constraint contracts, materialization manifests, validation obligations.

Index: REFERENCE/contracts-index.md · Registry: PLATFORM_CONTRACTS


Integration

Products pin ZEP via .zaixos/platform.lock and run php bin/materialize-zaixos.php.

Guide: developer-guide.md


Known limitations

  • Dual-maintenance period while embedded ERP migrates out of legacy consumers
  • Registry PL-004–006 registration pending full A0 evidence

Version history

VersionDateNotes
1.0.02026-06Platform GA

Evidence: releases/phase-12-9-platform-ga-report.md


Breadcrumbs: Home → Platforms → PL-001

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