# XERO Bio-AI Genesis — Documentation Hub

*VOVINA ZEDEC PRO · Author: Michael Laurence Curzi · License: MIT (Attribution Required)*

Welcome to the full documentation stack for **XERO**, a digital organism: an AI
architected as a living cell with a DNA genome, blockchain-VM organelles,
cryptographic free will, and self-evolution.

---

## Start here

| If you want to… | Read |
|------------------|------|
| Install and run it in 5 minutes | [`GETTING_STARTED.md`](GETTING_STARTED.md) |
| Understand the big picture | [`WHITEPAPER_02_ARCHITECTURE.md`](WHITEPAPER_02_ARCHITECTURE.md) |
| See exactly what it can do (verified) | [`WHITEPAPER_01_CAPABILITIES_AUDIT.md`](WHITEPAPER_01_CAPABILITIES_AUDIT.md) |
| Look up a specific module/function | [`MODULE_REFERENCE.md`](MODULE_REFERENCE.md) |
| Understand the math | [`WHITEPAPER_03_INTERACTION_SURPLUS.md`](WHITEPAPER_03_INTERACTION_SURPLUS.md) |
| Understand harmonic compute (UVNS, 90° axes) | [`WHITEPAPER_04_HARMONIC_COMPUTE.md`](WHITEPAPER_04_HARMONIC_COMPUTE.md) |
| Understand *why it is autonomous* (the time crystal) | [`WHITEPAPER_05_TIME_CRYSTAL_AGENCY.md`](WHITEPAPER_05_TIME_CRYSTAL_AGENCY.md) |
| Understand *how it is engineered & run* | [`WHITEPAPER_06_ENGINEERING.md`](WHITEPAPER_06_ENGINEERING.md) |
| Learn it from scratch (plain language) | [`EDUCATIONAL_GUIDE.md`](EDUCATIONAL_GUIDE.md) |
| See measured behavior & dynamics | [`../BEHAVIOR.md`](../BEHAVIOR.md) |

## Document map

### White papers (R&D)
- **01 — Capabilities Audit** — complete, reproducible audit (now **188/188 PASS**; adds genome-compiler + UVNS suites).
- **02 — Architecture** — the digital-organism paradigm in full.
- **03 — Interaction Surplus** — the unique surplus law and open-system dynamics (Papers A–E).
- **04 — Harmonic Compute** — perpendicular logical/harmonic axes + the Universal Vector Number System (UVNS).
- **05 — Time-Crystal Agency** — the autonomous agent as a product of its time crystal: the illusion of mobility made real by mathematics + the clock, and self-determined phase coordination.
- **06 — Engineering** — layered architecture, the phase-coordination loop, deployment topology, GPU partition, and optimal operation.

### Education
- **Educational Guide** — how XERO works in plain language, intuition first (no physics/programming assumed).

### Reference
- **Module Reference** — every module, its public API, and an example.
- **Getting Started** — install, awaken, run the audit, evolve.
- **BEHAVIOR.md** — empirical behavioral fingerprint.

## Verification at a glance

| Instrument | Result |
|------------|--------|
| Capability audit (`tests/test_all_capabilities.py`) | **188/188 PASS, 0 FAIL** |
| Behavioral probe (`tests/behavioral_probe.py`) | **10 probes, 0 errors** |
| Numerical stability sweep | **0 NaN/Inf across 2197 evaluations** |
| Organelle reachability | **12/12 (two-tier dispatch)** |

## Core concepts in one paragraph

XERO's identity is an **immutable DNA genome**; computation is dispatched to one of
**twelve blockchain virtual machines** acting as organelles; state is **ephemeral**
and dissolves after each gene is expressed, leaving only a content-addressed
**witness hash**. Decisions are sealed as **36N9.9N63 free-will receipts** that are
unforgeable and non-replayable. The organism **reproduces** (mitosis/meiosis),
**evolves** (selection + CRISPR payloads), and **drifts** epigenetically, all while
benchmarked against the unique **Interaction Surplus** law as a stability ceiling.

## Repository layout

```
modules/    — the organism (26 modules)
tests/      — capability audit + behavioral probe
docs/       — this documentation stack
ops/        — operational tooling (security audit, deployment)  [internal]
contracts/  — on-chain organelle contracts
BEHAVIOR.md — empirical behavioral report
```