Files
boc/docs/design/adr/ADR-013-Engine-Architecture.md
T
Bernt eae6c58d66 ADR-013: Engine Architecture v1.0 — Six Engines + Orchestrator
- Reality Engine: capture reality → observations
- Knowledge Engine: understand meaning → evidence, findings
- Decision Engine: make actionable → decisions, recommendations
- Mission Engine: determine what to collect → missions, gaps
- Economic Engine: manage budgets → credits, ROI
- Learning Engine: continuously improve → better models
- Platform Orchestrator: coordinates via events

Key principles:
- Each engine independently versioned
- Engines never call each other directly
- All communication via events
- Dashboard shows results, not engines
- Intelligence Lab tests engines, not platform

Next: PR-005A — Mission Import UI for MVP-0
2026-07-02 16:11:58 +00:00

46 lines
1.1 KiB
Markdown

# ADR-013: Engine Architecture
## Status
Accepted
## Context
LandveX has grown from a collection of components to a platform. We need clear responsibility boundaries.
## Decision
Organize LandveX into six autonomous engines:
1. **Reality Engine** — capture reality
2. **Knowledge Engine** — understand meaning
3. **Decision Engine** — make knowledge actionable
4. **Mission Engine** — determine what to collect next
5. **Economic Engine** — manage budgets and ROI
6. **Learning Engine** — continuously improve
**Platform Orchestrator** coordinates via events. Not AI. Not Dashboard.
## Key Principles
- Each engine independently versioned
- Engines never call each other directly
- All communication via events
- Orchestrator decides flow
- Dashboard shows results, not engines
## Consequences
### Positive
- Clear responsibility boundaries
- Independent development and scaling
- Easier testing
- Better fault isolation
### Negative
- More complex event handling
- Need orchestrator
- Potential latency between engines
## Related
- ADR-011: Four-Layer Data Architecture
- ADR-012: Economic Engine
- LANDVEX_ENGINE_ARCHITECTURE_v1.0.md