16 lines
2 KiB
Markdown
16 lines
2 KiB
Markdown
|
# Achtung: KI-unterstützt entstandene Dokumentation
|
|||
|
|
|
|||
|
|
Die Runbooks in diesem Ordner (`00`–`09`, `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](https://claude.com/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.
|