# 🧭 Theus Documentation Map

> **Welcome to Theus!** This framework is vast, covering everything from high-level AI philosophy to low-level Rust memory management. To avoid getting lost, please choose the **Persona** that best fits your current goal.

---

## 🚀 Persona 1: The AI Developer
**Goal:** "I want to build an Agent *now*. I don't care about memory zones or Rust macros yet."

*   **Start Here:** [**AI Developer Guide (Quickstart)**](https://github.com/dohuyhoang93/theus/blob/main/Documents/AI_DEVELOPER_GUIDE.md)
    *   *Time:* 15 mins
    *   *Outcome:* A running Hello World agent.
*   **Reference:** [**Cheatsheet (Pattern Registry)**](https://github.com/dohuyhoang93/theus/blob/main/Documents/tutorials/en/Chapter_01.md)

---

## 🏗️ Persona 2: The System Architect
**Goal:** "I need to understand how Theus ensures reliability. How does the Rust Core work? What is POP?"

*   **Theory:** [**POP Whitepaper v2.0 (The Source of Truth)**](https://github.com/dohuyhoang93/theus/blob/main/Documents/POP_Whitepaper_v2.0.md)
    *   *Concepts:* 3-Axis Context, Strict Mode, Neural Darwinism.
*   **Design:** [**Architecture Specification v2.2**](https://github.com/dohuyhoang93/theus/blob/main/Documents/Architecture/theus_v2_2_architecture.md)
    *   *Concepts:* Rust Microkernel, Tiered Guards, Zero-Copy Heavy Zone.
*   **Philosophy:** [**The POP Manifesto**](https://github.com/dohuyhoang93/theus/blob/main/Documents/POP_Manifesto.md)
    *   *Concepts:* "Data is Inert", "Process is Logic".

---

## 🎓 Persona 3: The Learner / Contributor
**Goal:** "I want to master Theus from the ground up or contribute to the core."

**Phase 1: Foundations (Python Layer)**
1.  [**Chapter 1: The First Process**](https://github.com/dohuyhoang93/theus/blob/main/Documents/tutorials/en/Chapter_01.md)
2.  [**Chapter 2: Context & Zones**](https://github.com/dohuyhoang93/theus/blob/main/Documents/tutorials/en/Chapter_02.md)
3.  [**Chapter 3: The Contract (@process)**](https://github.com/dohuyhoang93/theus/blob/main/Documents/tutorials/en/Chapter_03.md)

**Phase 2: Advanced Orchestration**
4.  [**Chapter 11: Workflow Flux (YAML Orchestration)**](https://github.com/dohuyhoang93/theus/blob/main/Documents/tutorials/en/Chapter_11.md)
5.  [**Chapter 10: Heavy Zone Optimization**](https://github.com/dohuyhoang93/theus/blob/main/Documents/tutorials/en/Chapter_10.md)

---

> **Note on Links:** All links point to the official GitHub repository to ensure accessibility from PyPI.
