Nomos OS Architecture

Nomos OS is engineered on the Dual-Core State Machine (Substrate Core vs. Intent Core). It establishes an inverted control flow where a compiled Go engine executes deterministic state transitions, invoking the LLM strictly as a bounded cognitive coprocessor.

---

🏛️ The Three Architectural Planes

flowchart TD
    subgraph P1["1. Intent Plane (Yang)"]
        direction TB
        A1["LLM Reasoning & Tangents"]
        A2["Cognitive Playbooks (/nomos-plan, /nomos-deep-review)"]
        A3["Creative Synthesis & Cognitive Profiling"]
    end

    subgraph P2["2. Execution Substrate (Yin)"]
        direction TB
        B1["Compiled Go Binary Engine (nomos)"]
        B2["Transactional SQLite State (~/.nomos/data/db/)"]
        B3["39 Binary Machine-Enforced DoD Quality Gates"]
        B4["Transient Git Worktree Sandbox (2PC GitOps)"]
    end

    subgraph P3["3. Membrane Plane (Public Portals)"]
        direction TB
        C1["SophiaLabs Portal (sophialabs.ca)"]
        C2["Sophia Soma AI Inference Runtime"]
        C3["Conduit MCP Integration Rails"]
    end

    P1 <-->|"Deterministic Gating"| P2
    P2 -->|"Static Distribution & SSoT"| P3

---

📚 Core Architecture Specifications

Specification	Description
DAG Task Engine	Deterministic task DAG orchestration, heuristic cycle bundling, dynamic auto-remediation, and 2PC merge mechanics.
Dual-Core Engine (Substrate vs. Intent)	Inverted control flow, deterministic cognitive scaffolding, and the physical totem inception paradigm.
Dual-Tier AI Operating System	Tier 1 (AGY-IDE) vs. Tier 2 (Nomos Code) governance, >90% Go code reusability, and Phase Discipline invariants.
Ecosystem Manifest Schema	The authoritative 6-node manifest (ecosystem.yaml) governing multi-plane workstation discovery and runtime telemetry.
Substrate Core Reflection	Machine-reflected Go AST state machines, 7 Core Invariant Laws, and CapBAC capability budget ceilings.
Transient Worktree Sandboxing	AST pre-commit isolation, dynamic go.work multi-repo stitching, and zero-leak release lifecycle.
The 39 DoD Quality Gates	Direct Go-native AST verification of cyclomatic complexity, docstring density, import boundaries, and phase discipline.

---

📖 Theoretical & Strategic Essays

For high-level essays on autonomous agent engineering maturity and inference economics, visit the SophiaLabs Handbook:

• The 4 Stages of AI Engineering Maturity
• Harness Over Model (The Architectural Manifesto)
• The 90-Day Velocity Curve
• The Token Tax and Inference Economics