# Chaos Theory — Front Door  
### TriadicFrameworks /docs/theories/chaos_theory/frontdoor.md

Chaos Theory in TriadicFrameworks is a **structural sensitivity theory**,
not a randomness theory and not a pop‑science “butterfly effect”
narrative.

Chaos = **deterministic sensitivity to operator iteration**.  
Attractors = **coherence surfaces**, not metaphors.  
Unpredictability = **coherence decay**, not randomness.

This front door orients students, researchers, and AI agents to the
identity, structure, and safe‑use boundaries of the Chaos Theory module.

---

## 1. Start here

If you are new to this module, read in this order:

1. **Session context**  
   `/docs/theories/chaos_theory/session_context.md`  
   Identity, drift boundaries, audience, and scope.

2. **Regimes**  
   `/docs/theories/chaos_theory/regimes.md`  
   R1 → R3: stable dynamics, transitional sensitivity, fully chaotic behavior.

3. **Operators**  
   `/docs/theories/chaos_theory/operators.md`  
   𝓜, 𝓕ˡᵒʷ, 𝓢ₛₑₙ, 𝓓ᵢᵥ, 𝓐ₜₜᵣ, 𝓒ₒₕ, 𝓡𝓮𝓰, 𝓒𝓁.

4. **Operator examples**  
   `/docs/theories/chaos_theory/operator_examples.md`  
   Concrete examples of maps, flows, sensitivity, divergence, attractors,
   coherence, and regime transitions.

---

## 2. What this module is

Chaos Theory here is:

- **deterministic**  
- **operator‑driven**  
- **coherence‑based**  
- **sensitivity‑structured**  
- **geometry‑compatible**  
- **regime‑aware (R1 → R3)**  
- **zero drift**

Chaos Theory is not:

- randomness  
- mysticism  
- “butterfly effect” pop‑science  
- teleology  
- anthropomorphic (“systems try to…”)  

Chaos = **deterministic structural sensitivity**.

---

## 3. Structure of the module

Core structural files:

- **`session_context.md`** — identity, drift, audience  
- **`regimes.md`** — R1 → R3 sensitivity behavior  
- **`operators.md`** — operator grammar  
- **`operator_examples.md`** — worked examples  
- **`coherence_map.md`** — coherence across sensitivity, divergence, attractors  
- **`lineage.md`** — pre‑chaos → Poincaré → Lorenz → RTT  
- **`cross_module.md`** — integration with IT, Thermodynamics, Geometry, Systems Physics  
- **`engine_notes.md`** — internal behavior for AI/compilers  
- **`simulation_hooks.json`** — operator‑level hooks for simulators  

---

## 4. How to use this module

### For students  
Treat Chaos Theory as a **deterministic dynamical framework**:

- maps and flows are operators  
- attractors are coherence surfaces  
- sensitivity is structural  
- unpredictability is coherence decay  
- fractal structure emerges from iteration, not randomness  

Avoid randomness‑first or pop‑science metaphors.

### For AI agents / tools  
- Use `session_context.md` as the identity anchor.  
- Use `engine_notes.md` and `simulation_hooks.json` for execution.  
- Preserve determinism, avoid randomness‑first framing.  
- Maintain structural, operator‑driven coherence.  

---

## 5. Summary

Chaos Theory in TriadicFrameworks is:

- a **structural sensitivity theory**  
- an **operator system** (maps, flows, attractors)  
- a **regime‑aware dynamical model** (R1 → R3)  
- a **cross‑module backbone** for nonlinear systems, fractals, predictability limits  

It is **not**:

- randomness  
- mysticism  
- pop‑science “butterfly effect”  
- teleological  

Chaos = **deterministic structural sensitivity**.  
Attractors = **coherence surfaces**.  
Dynamics = **operator‑driven iteration**.