📖 README komplett aktualisiert - v0.1-robots-complete

✨ Neue Inhalte: - 🤖 Komplette Robots-Kategorie (3 Missionen beschrieben) - 🌙 Mond Maschine prominent platziert - 🌲 Alle 15 Waldwächter nach Teams organisiert - 📊 Token-Tracking & Kosten transparent - 🌍 Alle Philosophien dokumentiert - 🏗️ Projekt-Struktur aktualisiert - 🔗 Links zu Simulatoren & Demos Von 52 auf 267 Zeilen gewachsen! 💚 🤖 Generated with Claude Code Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-21 17:23:11 +01:00
parent 3ee5214405
commit f85b4d48d9
1 changed files with 228 additions and 13 deletions
--- a/README.md
+++ b/README.md
@@ -1,6 +1,8 @@
 # 🌲 Crumbforest Missions - CF_Zero_V1

-Ein interaktives Bash-Lern-System mit KI-gestützten Charakteren für spielerisches Command-Line-Training.
+Ein interaktives Bash-Lern-System mit 15 KI-gestützten Waldwächtern für spielerisches Command-Line-Training und Roboter-Projekte.
+
+**"Was kostet die Frage eines Kindes?"** - Transparentes Token-Tracking für pädagogische Zwecke.

 ## 🚀 Quick Start

@@ -10,42 +12,255 @@ Ein interaktives Bash-Lern-System mit KI-gestützten Charakteren für spielerisc

 # Einzelne Mission ausführen
 bash missions/basics/fridolin.sh
+
+# Robots Mission (neu!)
+bash missions/robots/mond_maschine.sh
 ```

+## 🤖 Robots-Kategorie ⭐ NEU!
+
+Drei komplette Missionen zum Roboter-Bauen mit der ganzen Crew:
+
+### 🔋 LiPo Power Academy
+"Power braucht Respekt, nicht Angst"
+- 8 Phasen: Grundlagen → Sicherheit → Power-Verteilung
+- Lerne alles über LiPo-Batterien für Roboter-Projekte
+- 6 Waldwächter: CapaciTobi, CrabbyRust, Schnecki, Schraubbär, DumboSQL, Vektor
+- [LiPo 6S Charger Simulator](https://194-164-194-191.sslip.io/crumbblocks/lipo_6s_charger_sim_safe_v7.html)
+
+### 🌈 Regenbogen-Zählmaschine
+"Etwas bauen was noch keiner gebaut hat - sonst muss man es ja nur reparieren!"
+- 7 Phasen: Vision → Hardware → Code → Art
+- Baue einen Farb-Event-Counter mit Sensor, Code & Visualisierung
+- 13 Waldwächter: Die komplette Crew!
+- Hardware + Software + Creative Coding
+
+### 🌙 Mond Maschine - Rainbow Predictor
+"Vorhersagen heißt verstehen - Die Natur durch Code begreifen"
+- 8 Phasen: Computer Vision → ML → Astronomie
+- Predict when rainbows appear using moon phases & weather data
+- 13 Waldwächter: Computer Vision, APIs, ML Light
+- OpenCV + Weather APIs + Astronomical calculations
+- Bonus: Learn about Lunar Rainbows! 🌙🌈
+
 ## 📚 Features

- **Interaktive Lernmissionen** - Von Navigation bis DNS
- **KI-Assistenten** - Charakterbasierte Helfer (Deepbit, Bugsy, Schnippsi, etc.)
+- **Interaktive Lernmissionen** - Von Basics bis Advanced & Robots
+- **15 Waldwächter** - KI-Assistenten mit Persönlichkeit (siehe unten)
+- **Das Dreieck** - DumboSQL, FunkFox, Taichi Taube (Foundation)
 - **Metadata-driven** - Neue Missionen ohne Code-Änderungen hinzufügen
- **Kamera-Gestenerkennung** - SnakeCam mit Computer Vision
- **Token-Tracking** - OpenRouter API Nutzung überwachen
+- **Token-Tracking** - Transparent: "Was kostet die Frage eines Kindes?"
+- **Crew Memory** - Waldwächter kommunizieren miteinander
+- **Logs im Repo** - Strukturiert in `logs/{character}/`
+
+## 🌲 Die 15 Waldwächter
+
+### 🔺 Das Dreieck (Foundation)
+- **🐘 DumboSQL** - Der nie vergessende Elefant (SQL & Daten)
+- **🦊 FunkFox** - Der Bash Rapper (Terminal-Flow mit Beat)
+- **🕊️ Taichi Taube** - Die Balance-Bringerin (Spirale & Ordnung)
+
+### 🔧 Hardware-Team
+- **🐿️ CapaciTobi** - Kondensator-Experte (Elektronik & Power)
+- **🐌 Schnecki** - Verkabelungs-Guru (langsam & präzise)
+- **🐻 Schraubbär** - Mechanik-Meister (schweres Gerät)
+
+### 💻 Code-Team
+- **🐍 SnakePy** - Python-Guide (mehrere Wege zeigen)
+- **🧓 PepperPHP** - Structure Mentor (MVC wie ein Rezept)
+- **🦀 CrabbyRust** - Security Guardian (Memory-safe)
+- **🕷️ Spider** - Network Feeler (APIs & Verbindungen)
+
+### 🎨 UI-Team
+- **✂️ Schnippsi** - CSS & Styling (alles schick machen)
+- **📄 Templatus** - Template-Master (HTML-Struktur)
+- **👾 ASCII-Monster** - Terminal Artist (ASCII-Art)
+
+### 🧭 System-Team
+- **🦉 Maya-Eule** - Weise Eule mit Gedächtnis (Meta-Wissen)
+- **🔧 Deepbit** - Bash-Erklärer (deep diving)
+- **🐛 Bugsy** - Debugging-Helfer (Fehler-Detektiv)
+- **🧭 Vektor** - Point-to-Point Guide (Navigation)

 ## 🦊 Verfügbare Missionen

-### Basics
+### 📚 Basics
 - **Fridolin** - Navigation (`pwd`, `ls`, `cd`)
 - **Balu** - Dateien erstellen (`mkdir`, `touch`, `echo`)
 - **Noko** - Dateien lesen (`cat`, `head`, `tail`, `grep`)

-### Advanced
+### 🚀 Advanced
 - **DNS Deep Dive** - DNS-Tools (`dig`, `nslookup`, `host`)
 - **SSH Security** - SSH-Verbindungen und Keys

-## 🤖 KI-Assistenten
+### 🏆 Challenges
+- **Stage Builder** - Komplexe Bash-Herausforderungen
+
+### 🤖 Robots ⭐ NEU!
+- **🔋 LiPo Power Academy** - Batterie-Wissen für Roboter
+- **🌈 Regenbogen-Zählmaschine** - Farb-Event-Counter
+- **🌙 Mond Maschine** - Rainbow Predictor mit Computer Vision
+
+## 🤖 Waldwächter nutzen

 ```bash
-export OPENROUTER_API_KEY="your-key"
-./crumbforest_roles/deepbit_zero.sh "Wie funktioniert grep?"
+# Source die Library
+source lib/waldwaechter.sh
+
+# Frag einen Waldwächter
+mayaeule "Was ist wichtiger - das Ziel oder der Weg?"
+funkfox "Erkläre mir Pipes im Flow!"
+dumbosql "Wie strukturiere ich eine Datenbank?"
+snakepy "Zeig mir 3 Wege, um eine Liste zu sortieren"
+
+# Alle verfügbar:
+# mayaeule, deepbit, bugsy, schnippsi, templatus
+# tobi, schraubaer, schnecki
+# dumbosql, funkfox, taichitaube
+# snakepy, pepperphp, crabbyrust
+# spider, vektor, asciimonster
 ```

+## 📊 Token-Tracking & Logs
+
+**Philosophie:** "Was kostet die Frage eines Kindes?"
+
+- Token-Verbrauch wird transparent angezeigt
+- Logs landen in `logs/{character}/`
+- Crew Memory: Waldwächter lesen andere Logs
+- Mission Logs: `logs/missions/*.json`
+
+```bash
+# Logs checken
+ls logs/
+ls logs/mayaeule/
+cat logs/missions/mond_maschine_*.json
+```
+
+Typische Kosten:
+- Einzelne Frage: ~200-800 tokens (~$0.0002-0.0008)
+- Komplette Mission: ~5,000-7,000 tokens (~$0.005-0.007)
+- **Unter 1 Cent pro Mission!** 💚
+
 ## 📖 Dokumentation

-Siehe [CLAUDE.md](CLAUDE.md) für vollständige Architektur und Entwickler-Dokumentation.
+- **[CLAUDE.md](CLAUDE.md)** - Vollständige Architektur & Entwickler-Docs
+- **[KEKSHANDBUCH_ZERO_v0.0.md](KEKSHANDBUCH_ZERO_v0.0.md)** - User Manual mit allen 15 Waldwächtern

-## 🌍 Philosophie
+## 🌍 Philosophien

-**Waldwächter-Prinzip:** Transparenz über Magie - Metadata-driven, erweiterbar, bildungsfreundlich.
+**"Das Dreieck"** - DumboSQL, FunkFox, Taichi Taube
+- Struktur, Flow & Balance
+- Die Grundlage für komplexe Projekte
+
+**"Power braucht Respekt, nicht Angst"** - LiPo Power Academy
+- Sicherheit durch Wissen
+- 7 goldene Regeln für LiPo-Batterien
+
+**"Etwas bauen was noch keiner gebaut hat"** - Regenbogen-Zählmaschine
+- Kreativität statt Reparatur
+- Inspiriert durch Kinderfragen
+
+**"Vorhersagen heißt verstehen"** - Mond Maschine
+- Die Natur durch Code begreifen
+- Computer Vision + Machine Learning + Astronomie
+
+**"Was kostet die Frage eines Kindes?"**
+- Token-Tracking für Transparenz
+- Pädagogischer Wert über alles
+
+**"Ein Elefant vergisst nie"** - DumboSQL
+- Crew Memory über Projekt-Grenzen
+- Persistente Konversations-Historie
+
+**"wir ja nie fertig"** 🌱
+- Der Wald wächst mit jeder Idee
+- Community-driven Education
+
+## 🏗️ Projekt-Struktur
+
+```
+CF_Zero_V1/
+├── crumb-mission-selector.sh    # Hauptmenü
+├── lib/
+│   └── waldwaechter.sh          # 15 Waldwächter als Functions
+├── crumbforest_roles/           # 17 Character Scripts
+├── missions/
+│   ├── basics/                  # Einsteiger
+│   ├── advanced/                # Fortgeschrittene
+│   ├── challenges/              # Herausforderungen
+│   └── robots/                  # 🤖 NEU! 3 Robot-Missionen
+├── logs/                        # 🌲 Projekt-basierte Logs
+│   ├── {character}/             # Pro Waldwächter
+│   └── missions/                # Mission Logs
+├── CLAUDE.md                    # Projekt-Dokumentation
+├── KEKSHANDBUCH_ZERO_v0.0.md    # User Manual
+└── README.md                    # Diese Datei
+```
+
+## 🔧 Setup
+
+```bash
+# .env erstellen mit API Key
+echo "OPENROUTER_API_KEY=your-key-here" > .env
+
+# Mission Selector starten
+./crumb-mission-selector.sh
+
+# Oder direkt eine Mission
+bash missions/robots/mond_maschine.sh
+```
+
+## 🎯 Use Cases
+
+- **Terminal lernen** - Interaktive Bash-Basics
+- **Roboter bauen** - Hardware + Software Projekte
+- **Computer Vision** - OpenCV mit SnakePy lernen
+- **Datenbanken** - SQL mit DumboSQL verstehen
+- **APIs integrieren** - Spider zeigt den Weg
+- **Kreativ coden** - Projekte die Spaß machen!
+
+## 🌟 Besonderheiten
+
+- **Alle Waldwächter haben Persönlichkeit** - FunkFox rappt, Maya-Eule philosophiert
+- **Inter-Character Communication** - Waldwächter lesen andere Logs
+- **Metadata-driven** - Missions als .sh + .meta.json
+- **Token-Transparenz** - Kosten werden angezeigt
+- **Community-driven** - Missionen entstehen aus User-Ideen
+- **Raspberry Pi kompatibel** - Läuft auf Raspi Zero!
+
+## 📦 Requirements
+
+- Bash 3.2+ (macOS default)
+- curl, jq
+- OpenRouter API Key
+- Optional: Python 3 für Robot-Missionen (opencv-python, numpy, ephem)
+
+## 🚀 Next Steps
+
+1. Mission Selector starten: `./crumb-mission-selector.sh`
+2. Eine Robot-Mission ausprobieren
+3. Eigene Mission-Idee einreichen
+4. Den Wald wachsen lassen! 🌱
+
+## 🔗 Links
+
+- [LiPo 6S Charger Simulator](https://194-164-194-191.sslip.io/crumbblocks/lipo_6s_charger_sim_safe_v7.html)
+- [Rainbow Counter Demo](https://194-164-194-191.sslip.io/crumbblocks/rainbow_counter.html)
+
+---
+
+## 🏷️ Version
+
+**v0.1-robots-complete**
+- 3 Robot-Missionen
+- 15 Waldwächter komplett
+- Logs im Repo
+- Token-Tracking
+- Crew Memory

 ---

 *Erstellt mit 💚 im Crumbforest*
+
+**"Der Wald ist nie fertig - er wächst mit jeder Idee!"** 🌲🌱