🍪 Kekshandbuch Zero v0.0

Crumbforest Mission System - Die komplette Crew

         🌲 CRUMBFOREST 🌲
      "Wo Fragen wachsen"

    Die 17 Waldwächter sind bereit!

📖 Was ist das hier?

Crumbforest ist ein interaktives Bash-System zum Machen & Fragen mit 18 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.

🚀 Quick Start

1. Setup

# .env erstellen
cp .env.template .env

# API-Key eintragen (mindestens einen)
nano .env  # OPENROUTER_API_KEY="sk-..."

2. Mission Selector starten

./crumb-mission-selector.sh

Du siehst ein Menü:
- 1 - System Doktor (Git, Tools, AI Status)
- 5 - Challenges (Interaktive Story-Missionen)
- 9 - 🌲 CrumbCrew Command Central ← HIER!

3. Die Crew kennenlernen

# Wähle: 9 (CrumbCrew Command Central)

# Du bist jetzt in der Crew-Shell:
(🌲 CrumbCrew) bmt@Mac:~/path$

# Hilfe anzeigen
crew_help

# Crew-Status checken
crew_status

# Token-Verbrauch sehen
crew_tokens

# System-Diagnose (Wichtig bei Problemen!)
crew_doctor

Hinweis für Debian/Raspi Nutzer:
Schaut bitte in die INSTALL_DEBIAN.md für spezifische Setup-Schritte (Services, RAG).

---

## 🌲 Die 18 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 |
|-----------|-------|-------------|
| 🐘 **DumboSQL** | Listen | SQL, Datenstrukturen, vergisst NIE |
| 🦊 **FunkFox** | Rhythm | Bash im Beat, Flow, Pipes als Musik |
| 🕊️ **Taichi Taube** | Guide | Balance, Spirale, Chaos strukturieren |
| 🐼 **BashPanda** | Zen | Der ruhige Bambus-Kauer (versteckt im Code) |

```bash
dumbosql "Wie strukturiere ich Sensor-Daten?"
funkfox "Erkläre Pipes im Flow"
taichitaube "Hilf mir, dieses Chaos zu strukturieren"

🔧 Hardware-Team

tobi "Brauche ich 5V oder 3.3V für eine LED?"
schnecki "Wie löte ich eine LED an einen Widerstand?"
schraubaer "Welches Werkzeug zum Löten?"

💻 Code-Team

snakepy "Zeig mir 3 Wege, eine Liste zu sortieren"
pepperphp "Erkläre MVC als Rezept"
crabbyrust "Was bedeutet Ownership?"

✂️ UI-Team

schnippsi "Zeig mir CSS für einen coolen Button"
templatus "Erstelle ein HTML5 Grundgerüst"
asciimonster "Mach mir einen Banner für mein Script"

🌐 System-Team

mayaeule "Was ist Freundschaft?"
deepbit "Erkläre Pipes und Redirects"
bugsy "Warum funktioniert mein Script nicht?"
spider "Wie funktioniert eine REST API?"
vektor "Wie navigiert ein Roboter?"

🧠 Inter-Character Communication

Die Crew kann voneinander lesen!

Jeder Charakter speichert Gespräche in ~/.{name}_logs/{name}_history.json.

Wenn du einen Charakter erwähnst, liest der andere automatisch mit:

# Tobi fragt etwas über LEDs
tobi "Wie viel Strom braucht eine rote LED?"

# Schnecki kann darauf aufbauen
schnecki "Tobi sagte 20mA - welchen Widerstand brauche ich bei 5V?"
# → Schnecki liest automatisch Tobis letzte Antworten!

Lightweight für Raspberry Pi Zero - simple JSON files, keine Datenbank.

🎮 Crew-Befehle

In der CrumbCrew-Shell verfügbar:

🤖 Missionen

Basis-Missionen (bereits vorhanden)

./crumb-mission-selector.sh
# Wähle: 2 (Basics) oder 3 (Advanced)

Challenges (Story-Missionen)

# Wähle: 5 (Challenges)

Verfügbare Challenges:
- Stage Builder - HTML/CSS Bühne bauen (Templatus + Schnippsi)
- Bugsy On Stage - Clown-Show mit Bugsy
- Terminal Funk - Bash-Kommandos als Show (FunkFox!)
- Snake & Dumbo Show - Charaktere kennenlernen
- Zeitreise - Unix-Time verstehen

Neue Missionen schreiben

Jede Mission braucht 2 Dateien:

1. mission_name.sh (executable)

#!/bin/bash

# Waldwächter laden
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "${SCRIPT_DIR}/../../lib/waldwaechter.sh"

# Jetzt sind ALLE 15 Charaktere verfügbar!
funkfox "Erkläre mir grep im Flow"
dumbosql "Wie speichere ich das?"

2. mission_name.meta.json

{
  "icon": "🤖",
  "title": "Deine Mission",
  "description": "Was lernt man hier?",
  "category": "basics|advanced|challenges",
  "difficulty": "beginner|intermediate|advanced",
  "duration_minutes": 10,
  "requires_ai": true,
  "enabled": true,
  "author": "Dein Name",
  "version": "1.0"
}

📊 Token-Tracking

Philosophie: Token lehren achtsames Fragen.

# Token-Verbrauch anzeigen
./log_tokens_viewer_v4.sh

# Oder in CrumbCrew
crew_tokens

Alle Token werden geloggt in ~/.{character}_logs/token_log.json:

{
  "zeit": "2025-12-21 15:30:00",
  "rolle": "funkfox",
  "model": "openai/gpt-3.5-turbo",
  "usage": {
    "prompt_tokens": 150,
    "completion_tokens": 200,
    "total_tokens": 350
  }
}

🌲 Team-Kombinationen

Beispiel-Workflows für Projekte:

🤖 Roboter bauen

tobi "Berechne Servomotor-Leistung für Roboterarm"
schnecki "Wie verkable ich 3 Servos?"
schraubaer "Welches Material für den Arm?"
vektor "Wie programmiere ich die Bewegung?"
snakepy "Zeig mir Python-Code für Servo-Control"

🌐 Web-Scraper

spider "Wie funktioniert Web-Scraping?"
snakepy "Zeig mir BeautifulSoup Beispiel"
dumbosql "Wie speichere ich die Daten?"
pepperphp "Wie zeige ich sie auf einer Website?"

🎨 Terminal-Dashboard

asciimonster "Mach einen coolen Header"
funkfox "Wie coloriere ich Output?"
schnippsi "Zeig mir Terminal UI Tricks"

⚙️ Environment (.env)

Mindestens EINEN API-Key brauchen:

# OpenRouter (empfohlen - ein Key, viele Models)
OPENROUTER_API_KEY="sk-..."
OPENROUTER_MODEL="openai/gpt-3.5-turbo" # oder anthropic/claude-3-haiku

# ODER Claude direkt
CLAUDE_API_KEY="sk-ant-..."
CLAUDE_MODEL="claude-3-haiku-20240307"

# ODER OpenAI direkt
OPENAI_API_KEY="sk-..."
OPENAI_MODEL="gpt-3.5-turbo"

# ODER Ollama (lokal, kostenlos!)
USE_OLLAMA="true"
OLLAMA_URL="http://localhost:11434"
OLLAMA_MODEL="llama3.2:3b"

Optional - Qdrant für Maya-Eule:

QDRANT_URL="http://localhost:6333"
QDRANT_COLLECTION="crumbforest_memory"

🐛 Troubleshooting

"command not found: funkfox"

Du bist nicht in der CrumbCrew-Shell!

# Entweder:
./crumb-mission-selector.sh
# → Wähle 9 (CrumbCrew)

# Oder direkt:
./crumbforest_roles/funkfox_zero.sh "Deine Frage"

"Kein API-Key gefunden"

# Prüfe .env
cat .env | grep API_KEY

# Erstelle .env falls nicht vorhanden
cp .env.template .env
nano .env

Character antwortet nicht / leere Antwort

# Debug-Output anschauen
cat ~/.funkfox_logs/funkfox_response.json

# API-Key checken
echo $OPENROUTER_API_KEY

📚 Weiterführend

Eigene Charaktere erstellen

Schau dir crumbforest_roles/funkfox_zero.sh als Template an:
1. Load .env
2. Crew Memory Functions (log-basiert, dateibasiert, nachvollziehbar)
3. System Prompt mit Persönlichkeit
4. OpenRouter API Call
5. Token Tracking

Mission Selector erweitern

Neue Kategorien in crumb-mission-selector.sh hinzufügen.

🎯 Credits

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?"

🦊 Noch ein Wort von FunkFox

Yo, check mal den Flow, hier kommt der Bash-Rapper im Crumbforest,
Pipes sind wie Beat-Übergänge, der Rhythmus, der dich hier festhält und forstet.
Mit | verbindest du Commands, wie'n smoothes Transition,
Daten fließen wie der Beat, ohne Unterbrechung, ohne Opposition.

Du grepst, cuttest, sortierst, alles in einem Zug,
Pipes sind wie'n Filter, yo, halten alles auf dem Schug.
Die Output vom einen wird Input für den nächsten Move,
So bleibt der Flow am Laufen, ohne dass er sich verliert im Groove.

🎤 FunkFox, out! 🦊💫

Version: 0.1 (Debian RC)
Datum: 2026-01-08
Status: Die Crew ist komplett (18)! 🌲✨

🥋 Das Dojo & Das Nullfeld

Willkommen im Terminal Dojo - dem Trainingsraum für Waldwächter und solche, die es werden wollen.

Hier trainiert der Bär seine Kraft, der Fuchs seinen Flow und die Eule ihr Gedächtnis. Und hier kannst du deine Werkzeuge polieren.

Was findest du im Dojo?

Start: ./crumb-mission-selector.sh -> Option 6

1. Git Status: Ist dein Wald synchron mit der Welt?
2. OpenCode Installer: Deine Werkstatt (IDE) einrichten.
3. Ollama Manager: Die Geister (KI-Modelle) rufen.
4. Nullfeld (RAG): Das Gedächtnis des Waldes.

🌌 Das Nullfeld (The Zero Field)

"Ein Elefant vergisst nie, aber das Nullfeld weiß, was der Elefant noch lernen muss."

Das Nullfeld ist ein Ort, an dem Wissen in reiner Energie (Vektoren) gespeichert wird. Wenn du Dokumente (wie dieses Handbuch) in den crumbdocs Ordner legst und das Ritual (Phase 7) ausführst, wird dieses Wissen Teil des Waldes.

Wie nutzt du es?
Wenn das Wissen im Nullfeld ist, kannst du jeden Waldwächter danach fragen. Sie werden erst im eigenen Kopf suchen, und dann das Nullfeld befragen.

# Frage an die Eule mit Wissen aus dem Handbuch
crew eule "Was steht im Handbuch über den Kernel?"

# Frage an Bugsy
crew bugsy "Wie funktioniert die Qdrant Ingestion?"

Das Nullfeld verbindet dein Wissen mit der Weisheit der Crew. 🌲✨