🌲 Crumbforest Missions - CF_Zero_V1

Ein interaktives Bash-Lern-System mit 17 KI-gestützten Waldwächtern für spielerisches Command-Line-Training und Roboter-Projekte.

"Was kostet die Frage eines Kindes?" - Transparentes Token-Tracking nach dem Crumb Codex: Fragen stärken Krümel & Wurzel.

🚀 Quick Start

# Mission Selector starten
./crumb-mission-selector.sh

# 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
• ⚠️ Sicherheitshinweis: Lern- und Simulationskonzept. Arbeiten mit echten LiPo-Akkus nur unter Aufsicht erfahrener Erwachsener.

🌈 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! 🌙🌈

☀️ Solar Wasserkocher

"Physik ist der Algorithmus der Natur"

• 6 Phasen: Energie → Schleifen → Optimierung
• Simuliere einen solargetriebenen Wasserkocher mit Physik-Engine
• 3 Waldwächter: CapaciTobi, Schnecki, FunkFox
• Lerne: Variablen, While-Loops und Energie-Management (E = c \cdot m \cdot \Delta T)

📚 Features

• Interaktive Lernmissionen - Von Basics bis Advanced & Robots
• 17 Waldwächter - KI-Assistenten mit Persönlichkeit (siehe unten)
• Das Dreieck - DumboSQL, FunkFox, Taichi Taube (didaktisches Modell, nicht technisches Modul)
• Metadata-driven - Neue Missionen ohne Code-Änderungen hinzufügen
• Token-Tracking - Transparent: "Was kostet die Frage eines Kindes?"
• Crew Memory - Log-basiertes Gedächtnis (dateibasiert, nachvollziehbar, kein autonomes Agentensystem)
• Logs im Repo - Strukturiert in logs/{character}/

🌲 Die 17 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

• Fridolin - Navigation (pwd, ls, cd)
• Balu - Dateien erstellen (mkdir, touch, echo)
• Noko - Dateien lesen (cat, head, tail, grep)

🚀 Advanced

• DNS Deep Dive - DNS-Tools (dig, nslookup, host)
• SSH Security - SSH-Verbindungen und Keys

🏆 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
• ☀️ Solar Wasserkocher - Physik-Simulation & Schleifen-Logik

🤖 Waldwächter nutzen

# 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

# Logs checken
ls logs/
ls logs/mayaeule/
cat logs/missions/mond_maschine_*.json

Typische Kosten (Richtwerte, modellabhängig):

• Einzelne Frage: 200-800 tokens ($0.0002-0.0008)
• Komplette Mission: 5,000-7,000 tokens ($0.005-0.007)
• Richtwert: Unter 1 Cent pro Mission 💚
• Token-Anzeige dient der transparenten Nachvollziehbarkeit, nicht der Abrechnung

📖 Dokumentation

• CLAUDE.md - Vollständige Architektur & Entwickler-Docs
• KEKSHANDBUCH_ZERO_v0.0.md - User Manual mit allen 17 Waldwächtern

🌍 Philosophien

"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
• Machen statt Lernen - Fragen stärken die Wurzel

"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          # 17 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

# .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 - Grundsystem auf Pi Zero, Robot- & Vision-Missionen benötigen Pi 4+ oder Desktop

📦 Requirements

• Bash 3.2+ (macOS default, Bash 4+ empfohlen für volle Features)
• curl, jq
• OpenRouter API Key
• Optional: Python 3 für Robot-Missionen (opencv-python, numpy, ephem)
  • Mond Maschine (Computer Vision): Pi 4+ oder Desktop empfohlen

🚀 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
• Rainbow Counter Demo

---

🎨 Crumbblocks & UI ⭐ NEU!

• Dein Zeichen im Wald - Designe ein UI-Element im Browser
• Bridge-Technology - Sende Daten via Clipboard vom Browser ins Terminal
• Smart Evaluation - Die Crew erkennt automatisch, was du gebaut hast!

🏷️ Version

v0.0-RC3-crumbblocks

• Crumbblocks Integration (Browser <-> Terminal)
• Neue UI Mission "Dein Zeichen im Wald"
• Smart Routing für Evaluations-Skripte
• macOS Pfad-Fixes für Waldwächter
• 3 Robot-Missionen
• 17 Waldwächter komplett

---

Erstellt mit 💚 im Crumbforest

"Der Wald ist nie fertig - er wächst mit jeder Idee!" 🌲🌱