Overall Architecture

Status: Canonical
Last updated: 2026-07-05

---

Summary

ZAIXOS is a multi-repo, platform-composed ecosystem:

• PL-001 (ZEP) — engineering methodology, runtime contracts, adapters, validation
• PL-002–PL-006 — specialized platforms (design, AI runtime, intelligence, knowledge, observability)
• PRD-xxx — Laravel modular monolith products consuming platforms via Composer pins
• RP-002 (Registry) — indexes and metadata — not runtime

---

Request path (simplified)

sequenceDiagram
    participant User
    participant Product as PRD-001 UI
    participant AI as PL-003 Runtime
    participant Intel as PL-004
    participant Domain as Product Module
    User->>Product: Interaction
    Product->>AI: Agent turn (contract)
    AI->>Intel: Signals / version lookup
    AI->>Domain: Tool via adapter
    Domain-->>AI: DTO
    AI-->>Product: Structured response
    Product-->>User: Rendered experience

---

Authority layers

Layer	Source
Frozen baselines	docs/releases/
Platform constitution	core/constitution/
Engineering KB	docs/ (this portal)
Company	zaixos-company/ (cite-only)

---

Related

• platform-architecture.md
• product-architecture.md
• technical/TECHNICAL_ARCHITECTURE.md

Breadcrumbs: Home → Architecture → Overall Architecture