# Axiom — Executive Product Requirements

**Nuclear Energy Unified Technology for Research, Operations & Networks**

| Property | Value |
|----------|-------|
| Version | 2.0 |
| Last Updated | 2026-03-20 |
| Status | Active Development (v0.4.0) |
| Product Owner | Ben Booth |

---

## The Story So Far

For decades, operations facilities have run on paper logs, spreadsheets, phone calls, and siloed software systems. System operators track 30-minute surveillance checks on clipboards. Researchers schedule beam time via email chains. Meeting decisions evaporate into forgotten transcripts. Experiment data lives on individual hard drives. Compliance evidence is assembled by hand, days before an regulatory body inspection.

This worked when domain-specific energy was a mature, slow-moving industry. It doesn't work now.

Nuclear energy is entering its most consequential decade — advanced systems, medical isotope production at scale, AI-augmented operations, digital twins, and a global push to triple domain-specific capacity by 2050. The facilities that thrive will be the ones that digitize intelligently, connecting their data, their people, and their decision-making into a coherent system.

Axiom is that system.

Built at the University of Texas at Austin's Nuclear Engineering Teaching Laboratory (PartnerLab), Axiom draws on six decades of system operations experience and the latest advances in AI, data engineering, and software architecture. It stands on the shoulders of the researchers, operators, and engineers who built the domain-specific infrastructure we have today — and extends their work into the digital age.

---

## What Axiom Does

Axiom is a **modular digital platform for operations facilities**. It replaces fragmented workflows with integrated digital tools, organized as independently deployable modules:

### Core Platform

| Module | Purpose | Details |
|--------|---------|---------|
| [Data Platform](prd-data-platform.md) | Lakehouse architecture, time-series ingestion, analytics | Bronze → Silver → Gold medallion pattern |
| [Scheduling System](prd-scheduling-system.md) | Cross-cutting time management, resource allocation | Unified scheduling across all modules |
| [Compliance Tracking](prd-compliance-tracking.md) | Regulatory monitoring, evidence generation | 30-minute check enforcement, regulatory body audit support |

### Operations

| Module | Purpose | Details |
|--------|---------|---------|
| [System Ops Log](prd-system-ops-log.md) | Console checks, shift handoffs, maintenance tracking | Tamper-proof audit trail, digital shift summaries |
| [Experiment Manager](prd-experiment-manager.md) | Sample lifecycle, metadata, chain of custody | ROC authorization, results correlation |
| [Analytics Dashboards](prd-analytics-dashboards.md) | Superset visualizations, KPIs, trending | System utilization, fuel burnup, data quality |
| [Medical Isotope Production](prd-medical-isotope.md) | Customer orders, production batching, QA/QC, shipping | End-to-end isotope lifecycle |

### Computational

| Module | Purpose | Details |
|--------|---------|---------|
| [Model Corral](prd-model-corral.md) | Physics model registry, ROM versioning, validation datasets | [Tech spec](../tech-specs/spec-model-corral.md) |
| [Digital Twin Hosting](prd-digital-twin-hosting.md) | ROM execution, shadow runs, prediction validation | [Tech spec](../tech-specs/spec-digital-twin-architecture.md) |

### Intelligence Platform

| Capability | Agent | Details |
|------------|-------|---------|
| [Signal Processing](../tech-specs/spec-agent-architecture.md) | **EVE** (Event Evaluator) | Ingests voice memos, meetings, code, chat → structured intelligence |
| [Document Lifecycle](../tech-specs/spec-publisher.md) | **PR-T** (Purty) | .md → .docx → OneDrive/Box with bidirectional sync |
| [Resource Stewardship](prd-agent-state-management.md) | **M-O** (Micro-Obliterator) | Data retention, system hygiene, scratch management |
| [Diagnostics](../tech-specs/spec-executive.md) | **D-FIB** (Defib) | System health, security scans, configuration audit |
| [Export Control Routing](../tech-specs/spec-model-routing.md) | **Neut** (Orchestrator) | Two-tier LLM routing, sensitivity classification |
| [Knowledge Infrastructure](prd-rag.md) | RAG | Domain packs · three-store (public/restricted/EC) · knowledge maturity pipeline |
| [Prompt Registry](../tech-specs/spec-prompt-registry.md) | Platform | Versioned prompt templates, caching hints, audit trail |
| [External Connections](../tech-specs/spec-connections.md) | Connections | Unified auth for OneDrive, Box, GitHub, GitLab, Teams |

### Security & Access Control

| Capability | Details |
|------------|---------|
| [Export Control](../tech-specs/spec-model-routing.md) | Keyword + SLM classification, VPN-gated private endpoints |
| [Security & Access Control](prd-security.md) | OpenFGA (ReBAC/RBAC/ABAC), prompt injection defense |
| [PrivateCloud Integration](../tech-specs/spec-model-routing.md#9-deployment-options-for-the-private-endpoint) | Data locality for export-controlled simulation codes |

---

## How It's Built

Everything in Axiom is an **extension**. Web apps, agents, tools, utilities — all extensions, discovered via TOML manifests, deployed independently. The core provides infrastructure; domain functionality ships as modules.

| Principle | Implementation |
|-----------|---------------|
| **Everything is an extension** | 3-tier discovery: project → user → builtin |
| **System-agnostic core** | System-specific features via external extension repos |
| **Offline-first** | Queue locally, sync on restore — operations facilities lose network |
| **Human-in-the-loop** | Agents inform, humans approve — especially for safety-adjacent actions |
| **Model-agnostic** | Cloud LLMs for general use, private endpoints for export-controlled data |

For technical architecture, see the [Executive Tech Spec](../tech-specs/spec-executive.md).

---

## The Agent Team

Axiom agents are named after robots from Pixar's WALL-E — a film about a world made uninhabitable by environmental neglect. The irony is intentional: Axiom helps build the cleanest large-scale energy source available, exactly the technology that could prevent the future WALL-E depicts.

| Agent | Character | Role | CLI |
|-------|-----------|------|-----|
| **Neut** | The Axiom | Orchestrator — routes commands, delegates, maintains context | `axiom chat` |
| **EVE** | Probe droid | Event Evaluator — signal detection and intelligence extraction | `axiom signal` |
| **M-O** | Cleaning robot | Micro-Obliterator — resource stewardship and system hygiene | `axiom mo` |
| **PR-T** | Beauty bot | Purty — document lifecycle, .md → polished .docx → publish | `axiom pub` |
| **D-FIB** | Medical bot | Defib — diagnostics, security health, configuration audit | `axiom doctor` |

---

## Where We Are

```mermaid
gantt
    title Axiom Deployment Phases
    dateFormat  YYYY-MM
    section Foundation
    CLI + Extension System (v0.1-0.3)       :done, f1, 2026-01, 2026-02
    Signal Pipeline (EVE)                    :done, f2, 2026-01, 2026-03
    Export Control Router                    :done, f3, 2026-02, 2026-03
    Publisher (PR-T)                         :done, f4, 2026-02, 2026-03
    RAG + Knowledge Base                     :done, f5, 2026-03, 2026-03
    State Management + Retention (M-O)       :done, f6, 2026-03, 2026-03
    section Current (v0.4)
    Agent Identity (EVE, M-O, PR-T, D-FIB)  :active, c1, 2026-03, 2026-04
    OneDrive Bidirectional Sync              :active, c2, 2026-03, 2026-04
    Connections Framework                    :active, c3, 2026-03, 2026-04
    section Next
    System Ops Log                          :n1, 2026-04, 2026-06
    Experiment Manager                       :n2, 2026-04, 2026-06
    Security (OpenFGA)                       :n3, 2026-05, 2026-07
    Agentic RAG + Interaction Log            :n4, 2026-04, 2026-06
    Prompt Registry                          :n5, 2026-04, 2026-06
    Knowledge Maturity Pipeline              :n6, 2026-05, 2026-07
    section Future
    Digital Twin Hosting                     :ft1, 2026-07, 2026-10
    Multi-Facility Support                   :ft2, 2026-08, 2027-01
```

**1,600+ automated tests. 46 documents. 17 builtin extensions. 5 agents.** All open source.

---

## Document Family

This executive PRD is the entry point. Each capability has its own detailed PRD and technical specification:

### Product Requirements

| PRD | Status |
|-----|--------|
| [Agent State Management](prd-agent-state-management.md) | ✅ Shipped |
| [Agents Platform](prd-agents.md) | 🟡 Partial |
| [Analytics Dashboards](prd-analytics-dashboards.md) | 🔲 Planned |
| [Compliance Tracking](prd-compliance-tracking.md) | 🔲 Planned |
| [Connections](prd-connections.md) | 📋 Spec'd |
| [Data Platform](prd-data-platform.md) | 🔲 Planned |
| [Experiment Manager](prd-experiment-manager.md) | 🔲 Planned |
| [Intelligence Amplification](prd-intelligence-amplification.md) | 📋 Designed |
| [Media Library](prd-media-library.md) | 🔲 Planned |
| [Medical Isotope Production](prd-medical-isotope.md) | 🔲 Planned |
| [Neut CLI](prd-axi-cli.md) | 🟡 Partial |
| [Publisher](prd-publisher.md) | ✅ Shipped |
| [System Ops Log](prd-system-ops-log.md) | 🔲 Planned |
| [Scheduling System](prd-scheduling-system.md) | 🔲 Planned |
| [Security & Access Control](prd-security.md) | 📋 Spec'd |

### Technical Specifications

| Spec | Focus |
|------|-------|
| [Executive Tech Spec](../tech-specs/spec-executive.md) | Architecture overview, implementation status |
| [Agent Architecture](../tech-specs/spec-agent-architecture.md) | Signal pipeline, extractors, correlator, synthesizer |
| [Model Routing](../tech-specs/spec-model-routing.md) | Export control classification, two-tier LLM routing |
| [RAG Architecture](../tech-specs/spec-rag-architecture.md) | Three-tier corpus, EC-compliant embeddings |
| [Connections](../tech-specs/spec-connections.md) | Unified auth, credential resolution, endpoint watcher |
| [State Management](../tech-specs/spec-agent-state-management.md) | Hybrid file/PostgreSQL backend, retention policies |
| [Publisher](../tech-specs/spec-publisher.md) | Document lifecycle, format-endpoint compatibility |
| [Data Architecture](../tech-specs/spec-data-architecture.md) | Medallion pattern, Iceberg, schemas |
| [Digital Twin](../tech-specs/spec-digital-twin-architecture.md) | Surrogate models, WASM runtime |
| [Glossary System](../tech-specs/spec-glossary-system.md) | glossary.toml format, roll-up, `axiom glossary` CLI |
| [Prompt Registry](../tech-specs/spec-prompt-registry.md) | Versioned templates, composition model, caching |
| [RAG Knowledge Maturity](../tech-specs/spec-rag-knowledge-maturity.md) | Layers 0-5, interaction log, crystallization, M-O sweep |
| [Observability](../tech-specs/spec-observability.md) | Metrics taxonomy, alerting, distributed traces |

### Architecture Decisions

| ADR | Decision |
|-----|----------|
| [ADR-001](adr-001-polyglot-monorepo-bazel.md) | Monorepo (Python, not Bazel) |
| [ADR-002](adr-002-hyperledger-fabric-multi-facility.md) | Hyperledger for tamper-proof audit |
| [ADR-003](adr-003-lakehouse-iceberg-duckdb-superset.md) | Iceberg + DuckDB lakehouse |
| [ADR-004](adr-004-infrastructure-terraform-k8s-helm.md) | Terraform + K8S + Helm |
| [ADR-006](adr-006-mcp-agentic-access.md) | MCP + CLI as agentic interfaces |
| [ADR-010](adr-010-cli-architecture.md) | CLI as agentic terminal |

### Research

| Document | Topic |
|----------|-------|
| [State Backend Whitepaper](../research/whitepaper-state-backend-comparison.md) | Flat file vs PostgreSQL: benchmarks, token efficiency |
| [Platform Comparison](../research/platform-comparison-databricks.md) | Axiom vs Databricks |
| [DeepLynx Assessment](../research/deeplynx-assessment.md) | INL DeepLynx peer-platform analysis |

---

## Research Foundations

Axiom is developed at UT Austin's Department of Mechanical Engineering, Nuclear & Radiation Engineering Program, with research alignment to active NEUP proposals:

| Research Area | Axiom Alignment |
|---------------|--------------------|
| Operator LLM Safety | Export control routing, prompt injection defense |
| Cyber-Nuclear Security | Security architecture, EC leakage detection |
| Digital Twin Framework | Model Corral, Digital Twin Hosting, surrogate validation |
| AI Cross-Section Tuning | RAG-indexed domain-specific data, model-agnostic gateway |

---

*For technical architecture, see the [Executive Tech Spec](../tech-specs/spec-executive.md). For terminology, see the [Glossary](../glossary.md) (human-readable) or run `axiom glossary <term>` (machine-queryable, sourced from `docs/glossary-axiom.toml` + `docs/glossary-domain.toml`). For the CLI, run `axiom --help`.*
