🍂 Das Unterholz

Hier liegt das Dickicht. Hier wird gearbeitet.

Was ist das Unterholz?

Das Unterholz ist der Ort, wo Arbeit sichtbar wird.
Nicht poliert. Nicht perfekt. Aber ehrlich.

Hier findest du:
- Crew-Logs aus Tagen und Nächten
- Debug-Protokolle, wo Dinge schiefliefen
- Experimente, die funktionierten (oder nicht)
- Alte Versionsstände und Snapshots

Dies ist kein Ort für Schönheit.
Aber für Wahrheit.

Für wen ist das Unterholz?

Für Archäologen - die, die graben wollen:
- Entwickler, die verstehen wollen, wie wir hierher kamen
- Neugierige, die sehen wollen: "Wie sieht echte Arbeit aus?"
- Crews, die alte Entscheidungen nachvollziehen müssen
- Historiker, die die Reise dokumentieren

Was findest du hier? (52 Dokumente)

📓 Crew Logs (15 Dokumente)

Im Ordner crew_logs/:

Tagesprotokolle der Crew:
- Was wurde gebaut?
- Was ging schief?
- Was haben wir gelernt?

Format: JSONL-Style, chronologisch
- crew_log_2025-08-24_16-56-25.md
- crew_log_2025-08-24_18-03-54.md
- kapitaenslogbuch_morgenkurs.md
- groothink_daily_001.md

Highlights:
- crew_legend_waldmatrix.md - Die Legenden der Crew
- grootixer_foo_tagesbericht.md - Grootixer's Bericht

🐛 Debugging (6 Dokumente)

Im Ordner debugging/:

Fehlerprotokolle und Fixes:
- Was ging kaputt?
- Wie haben wir es gefixt?
- Was haben wir dabei gelernt?

Schlüsseldokumente:
- Debugging_im_Crumbforest.md - Debug-Guide
- 🐍_SnakeCam_Debug-Lesson__Fehlerprotok.md - SnakeCam-Fehlerprotokoll
- SnakeCam_Legacy_Debug_Log_–_Fehlerprot.md - Legacy-Debug-Log
- crumbforest_check_login_fix.md - Login-Fix

🧪 Experimente (27 Dokumente)

Im Ordner experimente/:

Tests, Versuche, Proof-of-Concepts:
- Was haben wir ausprobiert?
- Was hat funktioniert?
- Was haben wir verworfen?

Themen:
- Blockly-Terminal-Bridge: Browser → Shell
- CodeGPT Setup: AI-Integration-Tests
- CrumbAPI: API-Design-Experimente
- Indexing: Vector-DB-Tests
- Hardware: ESP32, LoRa, Sensoren

Highlights:
- blockly_crumbforest_bridge.md
- blockly_logging_checklist.md
- codegpt_setup.md
- crumbapi_log_handbuch.md
- feuerzeug_test.md - Zündtest (metaphorisch)

📦 Versionsstände (4 Dokumente)

Im Ordner versionsstände/:

Alte Builds und Snapshots:
- crumbforest_build_manifest.md.bak
- crumbforest_build_manifest.md.md
- Alte Docker-Configs
- Deprecated Features

Warum behalten wir alte Versionen?
Weil Fehler Lehrer sind.
Und manchmal müssen wir zurückgehen, um vorwärtszukommen.

Die vier Ebenen des Unterholzes

1. Die Protokoll-Ebene (Crew Logs)

Hier schreiben wir auf, was wir tun.
Tag für Tag. Commit für Commit.

Philosophie: Transparenz. Kein Verstecken. Auch nicht vor uns selbst.

2. Die Fehler-Ebene (Debugging)

Hier dokumentieren wir, was schiefging.
Nicht, um zu beschämen.
Sondern um zu lernen.

Philosophie: Fehler sind Lehrer. Nicht Feinde.

3. Die Experiment-Ebene (Experimente)

Hier probieren wir aus.
Ohne Garantie, dass es klappt.
Mit der Hoffnung, dass wir was lernen.

Philosophie: "Fail fast, learn faster."

4. Die Archiv-Ebene (Versionsstände)

Hier lagern alte Builds.
Nicht aktiv. Aber nicht gelöscht.

Philosophie: Geschichte ist wichtig. Auch die unbequeme.

Warum ist das Unterholz wichtig?

Weil Erfolg ohne Kontext eine Lüge ist.

Der Crumbforest sieht heute aus wie ein funktionierendes System:
- CrumbCore läuft
- Qdrant indiziert
- TTYD antwortet
- 18 Waldwächter helfen

Aber dahinter liegen:
- 52+ dokumentierte Arbeitstage
- Dutzende Bugs
- Hunderte Experimente
- Unzählige "Das wird nie funktionieren"-Momente

Das Unterholz ist der Beweis:
Wir sind hier, weil wir weitergemacht haben.

Crew-Log-Format (Beispiel)

{
  "timestamp": "2025-08-24T16:56:25+00:00",
  "crew": "branko",
  "action": "Docker Compose neu aufgesetzt",
  "status": "success",
  "learnings": "TTYD braucht PTY-Rechte",
  "next_steps": "Login-Flow testen"
}

Verbindungen zu anderen Waldebenen

• Von der Waldmitte hierher: "Wie wurde das gebaut?"
• Von hier zu den Wurzeln: "Warum haben wir das so entschieden?"
• Von hier zur Krone: "Was haben wir dabei gefühlt?"

Das Unterholz ist chaotisch. Aber ehrlich. 🍂

Wenn du hier bist, siehst du den Wald, wie er wirklich ist:
Nicht perfekt. Aber echt. 🌲