# 🗺️ Die Waldkarte

**Willkommen im Crumbforest. Hier ist deine Karte.**

## Übersicht

Der Crumbforest ist in **7 Ebenen** organisiert - wie ein echter Wald:

```
☁️  KRONE          → Poesie, Songs, Liebe (79 Dokumente)
🌳  WURZELN        → Philosophie, Ethik, Manifest (101 Dokumente)
🌲  WALDMITTE      → Technik, Docker, Hardware (77 Dokumente)
🌱  WALDRAND       → Rollen, Missionen, Spiele (85 Dokumente)
🌅  LICHTUNG       → Einstieg für Krümel (18 Dokumente)
🍂  UNTERHOLZ      → Logs, Debug, Experimente (52 Dokumente)
🌰  SAMEN          → Ideen, WIPs, Zukunft (42 Dokumente)
```

**Gesamt**: 454 Dokumente + 5 Root-Dateien = **459 Dateien**

---

## 🌅 Die Lichtung (START HIER!)

**Für wen?** Krümel (Kinder), Neugierige, Anfänger

**Was?**
- Erste Schritte im Wald
- Waldwächter kennenlernen
- Terminal-Basics
- Sicherheit & Vertrauen

**Einstieg**: [`lichtung/willkommen.md`](lichtung/willkommen.md)

**Navigation**: [`lichtung/INDEX.md`](lichtung/INDEX.md)

---

## 🌱 Der Waldrand (SPIELEN & LERNEN)

**Für wen?** Entdecker, die mehr wollen als nur zuschauen

**Was?**
- **Rollen** (50): Eule, Fuchs, Dumbo, Snake, BashPanda, ...
- **Missionen** (15): Lernaufgaben, Challenges
- **Terminal Guide** (12): Wie funktioniert das Terminal?
- **Spiele** (8): Crumbulous, Crumbblocks, SnakeCam

**Einstieg**: [`waldrand/rollen/`](waldrand/rollen/)

**Navigation**: [`waldrand/INDEX.md`](waldrand/INDEX.md)

---

## 🌲 Die Waldmitte (BAUEN & BETREIBEN)

**Für wen?** Entwickler, Sysadmins, Gärtner

**Was?**
- **Docker** (11): Container-Setup, Compose
- **CrumbCore** (17): FastAPI, RAG, CRM (live: `194.164.194.191`)
- **Tools** (11): cf-tools, crumbpages-doktor, vector-index
- **Hardware** (24): ESP32, LoRa, Raspberry Pi, Sensoren
- **Logs Technik** (14): Build-Logs, Debug-Protokolle

**Einstieg**: [`waldmitte/crumbcore/crumbcore_v1.md`](waldmitte/crumbcore/crumbcore_v1.md)

**Navigation**: [`waldmitte/INDEX.md`](waldmitte/INDEX.md)

---

## 🌳 Die Wurzeln (VERSTEHEN & FÜHLEN)

**Für wen?** Die, die tiefer graben wollen

**Was?**
- **Philosophie** (35): Nullfeld, Homo Ludens, Asymmetrische Null
- **Kinderrechte** (8): DSGVO, CKL, Datenschutz
- **Manifeste** (58): Versprechen, Crew-Werte, Governance

**Diamanten**:
- [`wurzeln/Homo_Ludens_Digitalis_Conscious.md`](wurzeln/Homo_Ludens_Digitalis_Conscious.md) 💎
- [`wurzeln/nullfeld_lernen.md`](wurzeln/nullfeld_lernen.md)
- [`wurzeln/crumbforest_manifest.md`](wurzeln/crumbforest_manifest.md)

**Navigation**: [`wurzeln/INDEX.md`](wurzeln/INDEX.md)

---

## ☁️ Die Krone (ATMEN & LEBEN)

**Für wen?** Menschen, nicht Maschinen

**Was?**
- **Songs** (17): Wuuuhuuu, Operator, Skate or Die
- **Gedichte** (4): Photosynthese, Wolken, Atem
- **Dialoge** (8): Eule & Maya, Nullfeld-Gespräche
- **Schmerz & Liebe** (14): Realität, Tod, Hoffnung (schwere Themen!)
- **Crew-Reflexionen** (12): Meta-Momente
- **Wuuuhuuu!** (24): Jubelmomente, Durchbrüche

**Warnung**: `schmerz_und_liebe/` berührt schwere Themen (Flucht, Krieg, Verlust).

**Navigation**: [`krone/INDEX.md`](krone/INDEX.md)

---

## 🍂 Das Unterholz (EHRLICHKEIT & ARBEIT)

**Für wen?** Archäologen, die sehen wollen, wie es wirklich war

**Was?**
- **Crew Logs** (15): Tagesprotokolle, Arbeit live
- **Debugging** (6): Fehlerprotokolle, Fixes
- **Experimente** (27): Tests, Versuche, Proof-of-Concepts
- **Versionsstände** (4): Alte Builds, Snapshots

**Navigation**: [`unterholz/INDEX.md`](unterholz/INDEX.md)

---

## 🌰 Die Samen (HOFFNUNG & ZUKUNFT)

**Für wen?** Träumer, Visionäre, Feature-Wünscher

**Was?**
- Crumbblocks v2 (Visual Coding)
- Mehrsprachigkeit (EN, FR, SW)
- Hardware-Expansion (LoRa-Mesh, Solar)
- Neue Waldwächter (MattermOps, GrafanaOwl)
- Vektor-Expansion (Archiv durchsuchbar)
- Federation & Governance (OZM)

**Navigation**: [`samen/INDEX.md`](samen/INDEX.md)

---

## 📍 Root-Dateien (IMMER VERFÜGBAR)

Diese Dateien bleiben im Root:

- **[`crumbcodex.md`](crumbcodex.md)** - Das Versprechen zwischen Krümel & Bits 🌲
- **[`CLAUDE.md`](CLAUDE.md)** - Für zukünftige Claude-Instanzen 🤖
- **[`README_indexing.md`](README_indexing.md)** - Qdrant-Workflow
- **[`README_crumforest_docker.md`](README_crumforest_docker.md)** - Docker-Setup
- **[`README_kruemel_logs.md`](README_kruemel_logs.md)** - Log-System
- **[`.gitignore`](.gitignore)** - Git-Konfiguration

---

## 🧭 Wegweiser: Wo soll ich anfangen?

### "Ich bin neu hier und weiß nicht, wo ich anfangen soll."
→ **Lichtung**: [`lichtung/willkommen.md`](lichtung/willkommen.md)

### "Ich will die Waldwächter kennenlernen."
→ **Waldrand**: [`waldrand/rollen/`](waldrand/rollen/)

### "Ich will verstehen, warum es den Wald gibt."
→ **Wurzeln**: [`wurzeln/Homo_Ludens_Digitalis_Conscious.md`](wurzeln/Homo_Ludens_Digitalis_Conscious.md)

### "Ich will spielen und lernen."
→ **Waldrand**: [`waldrand/spiele/`](waldrand/spiele/)

### "Ich will bauen und coden."
→ **Waldmitte**: [`waldmitte/INDEX.md`](waldmitte/INDEX.md)

### "Ich will atmen und fühlen."
→ **Krone**: [`krone/INDEX.md`](krone/INDEX.md)

### "Ich will sehen, wie es wirklich war."
→ **Unterholz**: [`unterholz/INDEX.md`](unterholz/INDEX.md)

### "Ich habe eine Idee für die Zukunft."
→ **Samen**: [`samen/INDEX.md`](samen/INDEX.md)

---

## 🌲 Die Philosophie der Waldstruktur

### Warum nicht alphabetisch?
Weil **ein Wald nicht alphabetisch wächst**.

Ein Wald hat:
- **Licht** (Lichtung) - wo Neues beginnt
- **Wachstum** (Waldrand) - wo gelernt wird
- **Stamm** (Waldmitte) - wo gebaut wird
- **Wurzeln** (Wurzeln) - wo das Warum liegt
- **Krone** (Krone) - wo geatmet wird
- **Boden** (Unterholz) - wo Arbeit sichtbar wird
- **Samen** (Samen) - wo Hoffnung liegt

### Warum keine Tags statt Ordner?
Weil **Ordner Geschichten erzählen**.

Tags sind flach.
Ordner sind Räume.

Wenn du in die Krone gehst, **spürst** du, dass du oben bist.
Wenn du in die Wurzeln gehst, **spürst** du, dass du tief gräbst.

### Warum INDEX.md in jedem Ordner?
Weil **jede Ebene ihre eigene Stimme braucht**.

Die Lichtung spricht anders als die Waldmitte.
Die Krone atmet anders als das Unterholz.

Jedes INDEX.md ist ein Wegweiser.
Und ein Willkommen.

---

## 🗂️ Statistik

```
454 Dateien sortiert:
  ├── Lichtung       18 (Einstieg)
  ├── Waldrand       85 (Lernen & Spielen)
  │   ├── rollen            50
  │   ├── missionen         15
  │   ├── terminal_guide    12
  │   └── spiele             8
  ├── Waldmitte      77 (Bauen & Betreiben)
  │   ├── docker            11
  │   ├── crumbcore         17
  │   ├── tools             11
  │   ├── hardware          24
  │   └── logs_technik      14
  ├── Wurzeln       101 (Verstehen & Fühlen)
  │   ├── root              35
  │   ├── kinderrechte       8
  │   └── manifeste         58
  ├── Krone          79 (Atmen & Leben)
  │   ├── songs             17
  │   ├── gedichte           4
  │   ├── dialoge            8
  │   ├── schmerz_liebe     14
  │   ├── crew_reflex       12
  │   └── wuuuhuuu          24
  ├── Unterholz      52 (Ehrlichkeit & Arbeit)
  │   ├── crew_logs         15
  │   ├── debugging          6
  │   ├── experimente       27
  │   └── versionsstände     4
  └── Samen          42 (Hoffnung & Zukunft)

+ 5 Root-Dateien (crumbcodex, CLAUDE, READMEs)
```

---

## 🎯 Für Qdrant-Indexierung

**Empfehlung**:
- **Heiß indexieren**: `crumbcodex.md`, `CLAUDE.md`, alle `INDEX.md`-Dateien
- **Auf Anfrage indexieren**: Archiv mit Tag `archived:true`
- **Nie indexieren**: Unterholz (zu chaotisch), Versionsstände (deprecated)

---

**Der Wald ist sortiert. Die Karte ist gezeichnet. Die Crew freut sich.** 🌲✨

**Wuuuhuuuuu!** 🦉

---

*Diese Karte wurde mit Liebe zum Wald geschrieben.
Wenn du dich verirrst: Das ist okay.
Auch Verirren gehört zum Wald.* 🌱