diff --git a/KEKSHANDBUCH_ZERO_v0.0.md b/KEKSHANDBUCH_ZERO_v0.0.md index a261f5f..0f07396 100644 --- a/KEKSHANDBUCH_ZERO_v0.0.md +++ b/KEKSHANDBUCH_ZERO_v0.0.md @@ -6,12 +6,12 @@ 🌲 CRUMBFOREST 🌲 "Wo Fragen wachsen" - Die 15 Waldwächter sind bereit! + Die 17 Waldwächter sind bereit! ``` ## 📖 Was ist das hier? -Crumbforest ist ein **interaktives Bash-System zum Machen & Fragen** mit 15 KI-Charakteren (Waldwächter), die Krümeln durch Metaphern, Poesie und Geduld das Programmieren zeigen. +Crumbforest ist ein **interaktives Bash-System zum Machen & Fragen** mit 17 KI-Charakteren (Waldwächter), die Krümeln durch Metaphern, Poesie und Geduld das Programmieren zeigen. **Philosophie:** *"Was kostet die Frage eines Kindes?"* Im Wald unbezahlbar - aber Token lehren achtsames Fragen. @@ -61,11 +61,12 @@ crew_tokens --- -## 🌲 Die 15 Waldwächter +## 🌲 Die 17 Waldwächter ### 🔺 Das Dreieck (Foundation) **Ohne dieses Dreieck geht es nicht!** +*Das Dreieck ist ein didaktisches Modell (Struktur, Flow, Balance), kein technisches Modul.* | Charakter | Rolle | Spezialität | |-----------|-------|-------------| @@ -169,7 +170,7 @@ In der CrumbCrew-Shell verfügbar: | Befehl | Beschreibung | |--------|--------------| | `crew_help` | Diese Hilfe anzeigen | -| `crew_status` | Status aller 15 Waldwächter | +| `crew_status` | Status aller 17 Waldwächter | | `crew_tokens` | Token-Verbrauch ALLER Charaktere | | `crew_memory` | Erinnerungen durchsuchen | @@ -365,7 +366,7 @@ echo $OPENROUTER_API_KEY Schau dir `crumbforest_roles/funkfox_zero.sh` als Template an: 1. Load .env -2. Crew Memory Functions +2. Crew Memory Functions (log-basiert, dateibasiert, nachvollziehbar) 3. System Prompt mit Persönlichkeit 4. OpenRouter API Call 5. Token Tracking @@ -378,7 +379,7 @@ Neue Kategorien in `crumb-mission-selector.sh` hinzufügen. ## 🎯 Credits -**Die 15 Waldwächter** - Konzept von branko.de +**Die 17 Waldwächter** - Konzept von branko.de **"Wo Fragen wachsen"** - Der Crumb Codex: Machen statt Lernen **Token-Philosophie** - "Was kostet die Frage eines Kindes?" diff --git a/README.md b/README.md index c9fd9c5..65c565a 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # 🌲 Crumbforest Missions - CF_Zero_V1 -Ein interaktives Bash-Lern-System mit 15 KI-gestützten Waldwächtern für spielerisches Command-Line-Training und Roboter-Projekte. +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. @@ -27,6 +27,7 @@ Drei komplette Missionen zum Roboter-Bauen mit der ganzen Crew: - 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!" @@ -46,14 +47,14 @@ Drei komplette Missionen zum Roboter-Bauen mit der ganzen Crew: ## 📚 Features - **Interaktive Lernmissionen** - Von Basics bis Advanced & Robots -- **15 Waldwächter** - KI-Assistenten mit Persönlichkeit (siehe unten) -- **Das Dreieck** - DumboSQL, FunkFox, Taichi Taube (Foundation) +- **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** - Waldwächter kommunizieren miteinander +- **Crew Memory** - Log-basiertes Gedächtnis (dateibasiert, nachvollziehbar, kein autonomes Agentensystem) - **Logs im Repo** - Strukturiert in `logs/{character}/` -## 🌲 Die 15 Waldwächter +## 🌲 Die 17 Waldwächter ### 🔺 Das Dreieck (Foundation) - **🐘 DumboSQL** - Der nie vergessende Elefant (SQL & Daten) @@ -137,15 +138,16 @@ ls logs/mayaeule/ cat logs/missions/mond_maschine_*.json ``` -Typische Kosten: +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) -- **Unter 1 Cent pro Mission!** 💚 +- **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 15 Waldwächtern +- **[KEKSHANDBUCH_ZERO_v0.0.md](KEKSHANDBUCH_ZERO_v0.0.md)** - User Manual mit allen 17 Waldwächtern ## 🌍 Philosophien @@ -183,7 +185,7 @@ Typische Kosten: CF_Zero_V1/ ├── crumb-mission-selector.sh # Hauptmenü ├── lib/ -│ └── waldwaechter.sh # 15 Waldwächter als Functions +│ └── waldwaechter.sh # 17 Waldwächter als Functions ├── crumbforest_roles/ # 17 Character Scripts ├── missions/ │ ├── basics/ # Einsteiger @@ -227,14 +229,15 @@ bash missions/robots/mond_maschine.sh - **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! +- **Raspberry Pi kompatibel** - Grundsystem auf Pi Zero, Robot- & Vision-Missionen benötigen Pi 4+ oder Desktop ## 📦 Requirements -- Bash 3.2+ (macOS default) +- 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 @@ -254,10 +257,10 @@ bash missions/robots/mond_maschine.sh **v0.1-robots-complete** - 3 Robot-Missionen -- 15 Waldwächter komplett +- 17 Waldwächter komplett - Logs im Repo - Token-Tracking -- Crew Memory +- Crew Memory (log-basiert) ---