# 🧭 Theus Documentation Map (v3.0.22)

> **Welcome to Theus!** The framework has evolved significantly. This map guides you through high-level AI philosophy, Rust-powered core mechanics, and production-ready implementation patterns.

---

## 🤖 Persona 0: The AI Assistant
**Goal:** "I am an AI coding assistant. Give me the technical grammar and patterns."

*   **Fast Track:** [**AI Quick Reference (Cheat Sheet)**](./tutorials/ai/00_QUICK_REFERENCE.md)
*   **Deep Context:** [**AI Tutorials (10 Modules)**](./tutorials/ai/)
    *   *Highlights:* Shared Memory (Heavy Zone), Flux DSL, and FFI Boundary Quirks.

---

## 🚀 Persona 1: The Implementer
**Goal:** "I want to apply Theus-POP to my project right now."

*   **The Philosophy:** [**The POP Manifesto**](./POP_Manifesto.md)
*   **The Handbook:** [**Theus Tutorial Series (Chapters 1-23)**](./tutorials/en/)

---

## 🏗️ Persona 2: The System Architect
**Goal:** "I need to understand the 'POP' philosophy and the Rust/Python hybrid safety."

*   **The Why:** [**The POP Manifesto**](./POP_Manifesto.md)
*   **Theory:** [**POP Whitepaper v2.0**](./POP_Whitepaper_v2.0.md)
*   **Reference:** [**API Reference (v3.0)**](./Architecture/01_Specs/THEUS_API_REFERENCE.md)

---


## 📂 Documentation Structure (Current)

```text
├── Architecture/
│   ├── 01_Specs/      # API Reference & Feature Matrices
│   ├── 02_ADR/        # Architecture Decision Records (Historical Context)
│   ├── 03_RFC/        # Request for Comments (Current Design Proposals)
│   └── 04_Archive/    # Legacy Designs
├── Benchmarks/        # Performance Reports
├── Incidents/         # Post-mortems & Stability Tracking
├── tutorials/
│   ├── ai/            # 🆕 10 Modules specialized for AI Agentic Systems
│   └── en/            # 23 Chapters for Human Developers
├── POP_Manifesto.md   # Philosophy
├── POP_specification.md # The absolute source of truth
└── POP_Whitepaper_v2.0.md
```

---
*Last Updated: 2026-02-27 | Sync Status: Theus v3.0.22 Core*
