Architecture Principles

Status: Canonical
Last updated: 2026-07-05

---

Normative rules

Sourced from TECHNICAL_ARCHITECTURE.md and platform constitution.

ID	Rule
AR-01	Platform never depends on products
AR-02	Products depend on platform public surfaces only
AR-03	Contracts never depend on adapters
AR-04	Adapters implement contracts
AR-09	Products extend; never modify platform core
AR-10	No circular dependencies
AR-11	Documentation first
AR-12	Contracts first
AR-15	Single source of truth
AR-18	Extension before modification

---

Module boundaries

flowchart TB
    subgraph ModuleA["Module A"]
        D1[Domain]
        A1[Application]
        I1[Infrastructure]
    end
    subgraph ModuleB["Module B"]
        D2[Domain]
        A2[Application]
    end
    A1 -->|Contract / Event| A2
    A1 -.-x|FORBIDDEN| I2[Module B Infrastructure]

---

Platform vs product

Owns	Platform	Product
Agent execution	PL-003	Adapter + UI only
Learning / version registry	PL-004	Federation read via Integration
Presentation / Filament	—	Product
Domain entities	—	Product modules

See ADR/ADR-005-platform-vs-product-separation.md.

---

Related

• ddd-rules.md
• ARCHITECTURE/README.md
• MODULE_BOUNDARIES

Breadcrumbs: Home → Engineering → Architecture Principles