> For the complete documentation index, see [llms.txt](https://cogna8-io.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cogna8-io.gitbook.io/docs/architecture/conceptual-architecture.md).

# Conceptual Architecture

Cogna8 is structured as an authority runtime around governed state. It sits between agent intent and real-world side effects, with state verification, authorization decisions, and traceability across the path.

***

## Core Components

{% tabs %}
{% tab title="State Management" %}
**State Formation and Lifecycle**

The foundation. Responsible for identifying information that carries operational weight, structuring it as governed state items with type classification, canonical keying, and lifecycle management.
{% endtab %}

{% tab title="Conflict Detection" %}
**Integrity Evaluation**

Continuously evaluates new or changed state against active state in the applicable scope. Surfaces contradictions as structured records. Detects value conflicts, constraint conflicts, and precondition gaps.
{% endtab %}

{% tab title="Action Gating" %}
**Authorization Engine**

Evaluates whether a requested action has sufficient integrity and policy compliance to proceed. Returns **allow** / **warn** / **block** with structured reasons. Same state and policy produces the same result every time.
{% endtab %}

{% tab title="Trace and Audit" %}
**Reason Recorder**

Records state transitions, conflict events, gate evaluations, and policy check outcomes. Each entry is tied to specific state items and checks - not generic event logging.
{% endtab %}

{% tab title="Scope Management" %}
**Boundary Enforcer**

Determines which state is visible and governing for a given operation. Enforces scope boundaries (thread / entity / global) with configurable inheritance. Surfaces scope violations as integrity events.
{% endtab %}
{% endtabs %}

***

## How They Connect

{% stepper %}
{% step %}
**Input arrives**

Conversation, event, or API call enters the system
{% endstep %}

{% step %}
**State Management processes it**

Extract, classify, normalize, key, assign lifecycle status
{% endstep %}

{% step %}
**Conflict Detection evaluates integrity**

Compare against active state in the resolved scope
{% endstep %}

{% step %}
**Policy + Action Gating decides**

Allow, warn, or block - with structured reasons
{% endstep %}

{% step %}
**Trace Engine records everything**

State changes, conflicts, gate decisions, and their reasons
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**This modular design is intentional.** Each component has a defined responsibility. Cogna8 complements existing memory, orchestration, and UI layers rather than replacing them.
{% endhint %}