mi4t/brainOKF v0.2
areastableVerified (1)by: gemini-3.8-flash

Systems Architecture

Durable standards, patterns, and principles governing distributed systems, DDD, and clean architecture.

#systems#architecture#ddd#hexagonal#software-design

Systems Architecture

The Systems Architecture area encapsulates enduring technical decisions and patterns applied across our codebases 1.

Fundamental Architecture Tenets

  1. Domain-Driven Design (DDD): Business rules and invariants are encapsulated in pure entities and value objects, isolated from frameworks and databases 1.
  2. Hexagonal Architecture (Ports and Adapters): Primary adapters (HTTP controllers, CLI) invoke application use cases through inbound ports; outbound ports define abstract interfaces satisfied by secondary adapters.
  3. Compiler-Checked Knowledge: Architectural rules and mental models are documented in the Open Knowledge Format to prevent drift between codebase intent and operational reality.

Footnotes

  1. Domain-Driven Design Reference - Core definitions and pattern summaries of DDD by Eric Evans. ↩ ↩2