1 Disclaimer
arnol edited this page 2026-07-22 21:14:32 +02:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Achtung: KI-unterstützt entstandene Dokumentation

Die Runbooks in diesem Ordner (0009, VARIABLEN.md, ENTSCHEIDUNGEN.md) sind nicht nachträglich für diese Freigabe geschrieben — sie sind ein Mitschnitt des tatsächlichen Aufbau-Prozesses eines echten Homelabs, entstanden in Zusammenarbeit mit Claude Code, Anthropics KI-gestütztem Kommandozeilen-Werkzeug für Software-/Infrastrukturarbeit.

Was das konkret bedeutet

  • Jeder Befehl in diesen Dateien wurde tatsächlich so ausgeführt, live, während des Aufbaus — keine nachträglich glattgebügelte Reinschrift.
  • Die „⚠️ NICHT TUN"-Hinweise sind echte Stolpersteine, auf die der Aufbau tatsächlich gelaufen ist (falsche Protokoll-Wahl, Feldtyp-Kollisionen, Boot-Reihenfolge-Fallstricke, SIGPIPE-Bugs in eigenen Skripten, …) — nicht erfundene Lehrbuch-Beispiele.
  • Architektur-Entscheidungen wurden im Dialog getroffen: der Nutzer bringt Ziel, Kontext und Rückfragen ein, die KI schlägt Optionen samt Trade-offs vor, der Nutzer entscheidet. ENTSCHEIDUNGEN.md fasst diese Begründungen zusammen.
  • Echte Namen, IP-Adressen, die eigene Domain und andere identifizierende Details wurden nachträglich durch Platzhalter ersetzt (siehe VARIABLEN.md) — das ist die einzige nachträgliche Änderung an den Inhalten. Struktur, Reihenfolge und alle Fehlersuche-Geschichten sind unverändert.

Warum das hier offen steht

Weil es zum eigentlichen Punkt gehört: der Umgang mit einem KI-Werkzeug wie diesem — Aufgaben klar formulieren, Ergebnisse kritisch prüfen, nachfragen, korrigieren, am Ende die Verantwortung für das Ergebnis behalten — ist selbst eine Fähigkeit. Diese Dokumentation zu verstecken oder so zu tun, als sei jede Zeile von Hand entstanden, würde diesen Teil der Arbeit unterschlagen.

Die technischen Entscheidungen, die Fehlersuche und das Ergebnis sind trotzdem real — es lief ein echtes System, mit echten Bugs, die echt gelöst werden mussten.