# aionsystem/aion-brain architecture

> Architecture diagram of the GitHub repository aionsystem/aion-brain, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aionsystem/aion-brain
- Repository: https://github.com/aionsystem/aion-brain

## Overview

AION-BRAIN is presented as the logic-and-framework hemisphere of a broader cognitive architecture: it supplies epistemic infrastructure, validation, constitutional safeguards, and domain-specific reasoning instruments. The README’s user path is to navigate by framework, validation entry, or constitutional architecture, with VELA filtering before output. The map preserves major capabilities visible in the README and tree; many subsystems are unsampled, so their internal connections are intentionally not inferred.

Main entry points: [`engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/core.py`](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/core.py) (Benchmark engine), [`engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/core.py`](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/core.py) (Oracle layer), [`engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/core.py`](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/core.py) (Decision engine), [`engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/core.py`](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/core.py) (Strategy engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_architecture["Core architecture"]
  node_vela["VELA Screen 1<br/>[screen1_v03.py]"]
  node_fons[("FONS archive<br/>[fons_archive.py]")]
end

subgraph group_validation["Validation engines"]
  node_constitutional_verifier["Constitutional verifier"]
  node_compositional["Compositional verification<br/>[src]"]
  node_benchmark["Benchmark engine<br/>[core.py]"]
  node_benchmark_reports["Audience reports"]
  node_benchmark_freshness["Benchmark freshness"]
  node_trinity["Trinity scoring<br/>[trinity_scoring.py]"]
  node_oracle["Oracle layer<br/>[core.py]"]
  node_oracle_providers["Oracle providers<br/>[providers.py]"]
  node_oracle_prompts["Oracle prompts<br/>[prompts.py]"]
  node_oracle_verification["Oracle verification<br/>[verification.py]"]
end

subgraph group_reasoning["Cognitive engines"]
  node_decision["Decision engine<br/>[core.py]"]
  node_decision_scoring["Decision scoring<br/>[scoring.py]"]
  node_decision_frameworks["Decision frameworks<br/>[frameworks]"]
  node_strategy["Strategy engine<br/>[core.py]"]
  node_strategy_scoring["Strategy scoring<br/>[scoring.py]"]
  node_strategy_prompts["Strategy prompts<br/>[prompts.py]"]
  node_persona["Persona loader<br/>[persona_loader.py]"]
  node_persona_memory[("Persona memory<br/>[crm_manager.py]")]
end

subgraph group_constitutional["Constitutional safeguards"]
  node_sovereign["Sovereignty stack<br/>[src]"]
  node_temporal["Temporal integrity<br/>[src]"]
  node_trace["Sovereign trace"]
end

subgraph group_frameworks["Frameworks and tools"]
  node_scholastic["Scholastic synthesis"]
  node_mechanism["Mechanism design<br/>[core.py]"]
  node_complexity["Complexity management<br/>[core.py]"]
  node_explanation["Explanation generation<br/>[core.py]"]
  node_domain_tools["Domain tools"]
  node_nonseparable["Coupled systems"]
end

node_reader(("AI session"))
node_agi["AGI router"]

node_reader -->|"enters through"| node_agi
node_agi -.->|"routes to"| node_vela
node_agi -.->|"routes to"| node_benchmark
node_agi -.->|"routes to"| node_sovereign
node_vela -->|"uses archive"| node_fons
node_benchmark -->|"uses reports"| node_benchmark_reports
node_benchmark -->|"uses freshness"| node_benchmark_freshness
node_benchmark -->|"uses scoring"| node_trinity
node_oracle -->|"uses providers"| node_oracle_providers
node_oracle -->|"uses prompts"| node_oracle_prompts
node_oracle -->|"uses verification"| node_oracle_verification
node_decision -->|"uses scoring"| node_decision_scoring
node_decision -->|"uses frameworks"| node_decision_frameworks
node_strategy -->|"uses scoring"| node_strategy_scoring
node_strategy -->|"uses prompts"| node_strategy_prompts
node_persona_memory -->|"loads persona"| node_persona
node_benchmark -.->|"supports validation"| node_constitutional_verifier
node_sovereign -->|"enforced pre-output"| node_vela
node_agi -.->|"routes to"| node_temporal
node_agi -.->|"routes to"| node_compositional
node_agi -.->|"routes to"| node_mechanism
node_agi -.->|"routes to"| node_scholastic
node_agi -.->|"routes to"| node_complexity
node_agi -.->|"routes to"| node_explanation
node_agi -.->|"routes to"| node_domain_tools
node_agi -.->|"routes to"| node_nonseparable
node_agi -.->|"routes to"| node_trace
node_agi -.->|"routes to"| node_decision
node_agi -.->|"routes to"| node_strategy

click node_vela "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/frameworks/VELA/code/screen1/screen1_v03.py"
click node_fons "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/frameworks/VELA/code/fons_archive/fons_archive.py"
click node_sovereign "https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-1-foundation/constitutional-structure-core-v1.0/src"
click node_constitutional_verifier "https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-1-foundation/constitutional-verification-engine-v1.0/src/constitutional_verification"
click node_compositional "https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-0-meta/compositional-verification-calculus-v1.0/src"
click node_benchmark "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/core.py"
click node_benchmark_reports "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/integrations/audience_reports.py"
click node_benchmark_freshness "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/integrations/benchmark_freshness.py"
click node_trinity "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/integrations/trinity_scoring.py"
click node_oracle "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/core.py"
click node_oracle_providers "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/providers.py"
click node_oracle_prompts "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/prompts.py"
click node_oracle_verification "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/verification.py"
click node_decision "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/core.py"
click node_decision_scoring "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/scoring.py"
click node_decision_frameworks "https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/frameworks"
click node_strategy "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/core.py"
click node_strategy_scoring "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/scoring.py"
click node_strategy_prompts "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/prompts.py"
click node_persona "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/personality-architect-v1.0/integrations/persona_loader.py"
click node_persona_memory "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/personality-architect-v1.0/integrations/crm_manager.py"
click node_temporal "https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-2-cognitive-architecture/temporal-integrity-core-v1.0/src"
click node_scholastic "https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-1-foundation/mechanism-design-engine-v1.0/src/scholastic_synthesis"
click node_mechanism "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/mechanism-design-engine-v1.0/src/mechanism_design/core.py"
click node_complexity "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/complexity-management-engine/src/simplexity/core.py"
click node_explanation "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/explanation-generation-engine/src/explanation_engine/core.py"
click node_domain_tools "https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/tools"
click node_nonseparable "https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/non-separable-architecture/primitives"
click node_trace "https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/projects/sovereign-trace/stamp/sovereign_trace_stamp.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_vela,node_fons toneBlue
class node_constitutional_verifier,node_compositional,node_benchmark,node_benchmark_reports,node_benchmark_freshness,node_trinity,node_oracle,node_oracle_providers,node_oracle_prompts,node_oracle_verification toneAmber
class node_decision,node_decision_scoring,node_decision_frameworks,node_strategy,node_strategy_scoring,node_strategy_prompts,node_persona,node_persona_memory,node_agi toneMint
class node_sovereign,node_temporal,node_trace toneRose
class node_scholastic,node_mechanism,node_complexity,node_explanation,node_domain_tools,node_nonseparable,node_reader toneIndigo
```

## Components

### Core architecture

- [VELA Screen 1](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/frameworks/VELA/code/screen1/screen1_v03.py): `frameworks/VELA/code/screen1/screen1_v03.py`
- [FONS archive](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/frameworks/VELA/code/fons_archive/fons_archive.py): `frameworks/VELA/code/fons_archive/fons_archive.py`

### Validation engines

- [Constitutional verifier](https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-1-foundation/constitutional-verification-engine-v1.0/src/constitutional_verification): `engines/tier-1-foundation/constitutional-verification-engine-v1.0/src/constitutional_verification`
- [Compositional verification](https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-0-meta/compositional-verification-calculus-v1.0/src): `engines/tier-0-meta/compositional-verification-calculus-v1.0/src`
- [Benchmark engine](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/core.py): `engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/core.py`
- [Audience reports](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/integrations/audience_reports.py): `engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/integrations/audience_reports.py`
- [Benchmark freshness](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/integrations/benchmark_freshness.py): `engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/integrations/benchmark_freshness.py`
- [Trinity scoring](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/integrations/trinity_scoring.py): `engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/integrations/trinity_scoring.py`
- [Oracle layer](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/core.py): `engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/core.py`
- [Oracle providers](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/providers.py): `engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/providers.py`
- [Oracle prompts](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/prompts.py): `engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/prompts.py`
- [Oracle verification](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/verification.py): `engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/verification.py`

### Cognitive engines

- [Decision engine](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/core.py): `engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/core.py`
- [Decision scoring](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/scoring.py): `engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/scoring.py`
- [Decision frameworks](https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/frameworks): `engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/frameworks`
- [Strategy engine](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/core.py): `engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/core.py`
- [Strategy scoring](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/scoring.py): `engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/scoring.py`
- [Strategy prompts](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/prompts.py): `engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/prompts.py`
- [Persona loader](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/personality-architect-v1.0/integrations/persona_loader.py): `engines/tier-2-cognitive-architecture/personality-architect-v1.0/integrations/persona_loader.py`
- [Persona memory](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/personality-architect-v1.0/integrations/crm_manager.py): `engines/tier-2-cognitive-architecture/personality-architect-v1.0/integrations/crm_manager.py`

### Constitutional safeguards

- [Sovereignty stack](https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-1-foundation/constitutional-structure-core-v1.0/src): `engines/tier-1-foundation/constitutional-structure-core-v1.0/src`
- [Temporal integrity](https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-2-cognitive-architecture/temporal-integrity-core-v1.0/src): `engines/tier-2-cognitive-architecture/temporal-integrity-core-v1.0/src`
- [Sovereign trace](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/projects/sovereign-trace/stamp/sovereign_trace_stamp.py): `projects/sovereign-trace/stamp/sovereign_trace_stamp.py`

### Frameworks and tools

- [Scholastic synthesis](https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/engines/tier-1-foundation/mechanism-design-engine-v1.0/src/scholastic_synthesis): `engines/tier-1-foundation/mechanism-design-engine-v1.0/src/scholastic_synthesis`
- [Mechanism design](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/mechanism-design-engine-v1.0/src/mechanism_design/core.py): `engines/tier-1-foundation/mechanism-design-engine-v1.0/src/mechanism_design/core.py`
- [Complexity management](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-1-foundation/complexity-management-engine/src/simplexity/core.py): `engines/tier-1-foundation/complexity-management-engine/src/simplexity/core.py`
- [Explanation generation](https://github.com/aionsystem/aion-brain/blob/LEFT-BRAIN/engines/tier-2-cognitive-architecture/explanation-generation-engine/src/explanation_engine/core.py): `engines/tier-2-cognitive-architecture/explanation-generation-engine/src/explanation_engine/core.py`
- [Domain tools](https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/tools): `tools`
- [Coupled systems](https://github.com/aionsystem/aion-brain/tree/LEFT-BRAIN/non-separable-architecture/primitives): `non-separable-architecture/primitives`

### Other components

- **AI session**
- **AGI router**

## Connections

- AI session → AGI router: enters through
- AGI router → VELA Screen 1: routes to
- AGI router → Benchmark engine: routes to
- AGI router → Sovereignty stack: routes to
- VELA Screen 1 → FONS archive: uses archive (evidence: `frameworks/VELA/code/screen1/screen1_v03.py`)
- Benchmark engine → Audience reports: uses reports (evidence: `engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/core.py`)
- Benchmark engine → Benchmark freshness: uses freshness (evidence: `engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/core.py`)
- Benchmark engine → Trinity scoring: uses scoring (evidence: `engines/tier-1-foundation/benchmark-engine-v1.0/src/benchmark_engine/core.py`)
- Oracle layer → Oracle providers: uses providers (evidence: `engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/core.py`)
- Oracle layer → Oracle prompts: uses prompts (evidence: `engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/core.py`)
- Oracle layer → Oracle verification: uses verification (evidence: `engines/tier-1-foundation/oracle-layer-v2.1/src/oracle_layer/core.py`)
- Decision engine → Decision scoring: uses scoring (evidence: `engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/core.py`)
- Decision engine → Decision frameworks: uses frameworks (evidence: `engines/tier-2-cognitive-architecture/decision-engine-v1.0/src/decision_engine/core.py`)
- Strategy engine → Strategy scoring: uses scoring (evidence: `engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/core.py`)
- Strategy engine → Strategy prompts: uses prompts (evidence: `engines/tier-2-cognitive-architecture/strategy-engine-v1.1/src/strategy_engine/core.py`)
- Persona memory → Persona loader: loads persona (evidence: `engines/tier-2-cognitive-architecture/personality-architect-v1.0/integrations/crm_manager.py`)
- Benchmark engine → Constitutional verifier: supports validation
- Sovereignty stack → VELA Screen 1: enforced pre-output
- AGI router → Temporal integrity: routes to
- AGI router → Compositional verification: routes to
- AGI router → Mechanism design: routes to
- AGI router → Scholastic synthesis: routes to
- AGI router → Complexity management: routes to
- AGI router → Explanation generation: routes to
- AGI router → Domain tools: routes to
- AGI router → Coupled systems: routes to
- AGI router → Sovereign trace: routes to
- AGI router → Decision engine: routes to
- AGI router → Strategy engine: routes to
