kruemel/crumbmissions
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e1cae4fbd1eb8c76bc563f8c2233e8bdfcb06e99
crumbmissions/README.md
Branko May Trinkwald 819d2d4ec0 ⚙️ OZMAI Präzisierungen: Ehrlichkeit über Marketing 
OZMAI hat zentrale Inkonsistenzen identifiziert und korrigiert.

✅ 5 Haupt-Korrekturen:

1. **17 Waldwächter** (nicht 15)
   - 17 Character Scripts existieren tatsächlich
   - Alle Vorkommen korrigiert (README + KEKSHANDBUCH)

2. **Crew Memory präzisiert**
   - "Log-basiertes Gedächtnis (dateibasiert, nachvollziehbar)"
   - NICHT "autonomes Agentensystem"
   - Zero-Trust-kompatibel

3. **LiPo Safety Disclaimer**
   - ⚠️ Lern- und Simulationskonzept
   - Echte LiPo-Akkus nur unter Aufsicht
   - Haftungsschutz

4. **Token-Kosten als Richtwerte**
   - "Richtwerte, modellabhängig"
   - Transparenz statt Abrechnung
   - Passt zur Kinderfrage-Philosophie

5. **Hardware-Anforderungen realistisch**
   - Grundsystem: Pi Zero kompatibel
   - Vision/ML: Pi 4+ oder Desktop
   - Bash 3.2 → Bash 4+ empfohlen

🔺 **Das Dreieck präzisiert:**
   - "Didaktisches Modell, nicht technisches Modul"
   - Struktur, Flow, Balance

📝 **Weitere Anpassungen:**
   - Bash 3.2 Kompatibilität klargestellt
   - OpenCV Hardware-Anforderungen transparent
   - Mond Maschine: Pi 4+ empfohlen

"Präzision statt Marketing" - OZMAI schaut drauf! 🔍

🤖 Generated with Claude Code
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-21 18:47:11 +01:00

270 lines
9.0 KiB
Markdown
Raw Blame History

# 🌲 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
```bash
# 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](https://194-164-194-191.sslip.io/crumbblocks/lipo_6s_charger_sim_safe_v7.html)
- ⚠️ **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! 🌙🌈
## 📚 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
## 🤖 Waldwächter nutzen
```bash
# 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 (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](CLAUDE.md)** - Vollständige Architektur & Entwickler-Docs
- **[KEKSHANDBUCH_ZERO_v0.0.md](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
```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** - 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](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
- 17 Waldwächter komplett
- Logs im Repo
- Token-Tracking
- Crew Memory (log-basiert)
---
*Erstellt mit 💚 im Crumbforest*
**"Der Wald ist nie fertig - er wächst mit jeder Idee!"** 🌲🌱
Reference in New Issue View Git Blame Copy Permalink