SESSION 03 / 06
Dokumente verfeinern,
erstellen und verknüpfen
Verbindliche Quellen · Specs · Pyramiden · 100 Zeilen
Jee Jun Young
BWL statt Informatik → Journalismus · Auslandsvertrieb → Wechsel in die Entwicklung
iOS · Android · Frontend Etwa 5½ Jahre (im sechsten Jahr)
Entwicklung von iOS-/macOS-Apps für ein Kollaborationstool eines Großunternehmens
Seit 2026 Web- und Serverentwicklung sowie Vermarktung als Einzelentwickler mit Vibe Coding
TEIL 1 — Rückblick
Vercel, Supabase:
Haben Sie etwas veröffentlicht?
Es ist in Ordnung, wenn Sie es noch nicht versucht haben.
RÜCKBLICK · Termine 1 und 2
Die Dokumente, die Claude liest · Noch einmal
Die Restaurantanalogie aus Termin 2 — noch einmal
Claude ist jedes Mal eine neue Aushilfe. An die Arbeit von gestern erinnert sie sich nicht.
Nur mit Zubereitungsregeln an der Küchenwand schmeckt es jedes Mal gleich.
Diese Zubereitungsregeln sind:
CLAUDE.md — die Masterdatei, die Claude laut Vorgabe immer lesen soll.
Mit genau diesem großgeschriebenen Dateinamen wird sie vom System automatisch erkannt.
Große Projekte haben getrennte Regelblätter je Abteilung:
Heute: Wie verfeinert, erstellt und verknüpft man diese Regelblätter?
ORGANIGRAMM · Eine Analogie
Unternehmensorganigramm = Claudes Dokumentenhierarchie
Das Gesamtbild des Unternehmens im Kopf = Konzept · PRD
Masterregeln, nach denen das gesamte Unternehmen Konzept und PRD folgt
Wie unsere Abteilung handeln soll, wenn Vorgaben von oben geändert werden
Abteilungsregeln — Gastraum / Küche
Die Menschen, die vor Ort tatsächlich arbeiten
Detaillierte Spezifikationsdokumente
CANON — SINGLE SOURCE OF TRUTH
Verbindliche Quelle — Bedeutung in der Entwicklung
Verbindliche Quelle = Single Source of Truth
kurz SSOT
Für jede Information
darf es genau eine maßgebliche Originalquelle geben.
Der englische Begriff: Canonical
Canonical leitet sich von „canon“ ab (Maßstab, Gesetz, verbindlicher Textbestand): „maßgeblich“ oder „offiziell“.
In der Informatik: die eine als verbindlich festgelegte Form unter mehreren Darstellungen.
Beispiele: Canonical URL (die maßgebliche unter doppelten URLs) · Canonical form (2/4 und 4/8 auf 1/2 normalisieren)
Verbindliche Quelle · SSOT · Canonical — drei Ausdrücke für denselben Gedanken.
Beispiel
Telefonnummern stehen in drei Excel-Dateien: Personalabteilung, Verwaltung und Teamleitung.
Jemand ändert seine Nummer, aber nur die Personaldatei wird aktualisiert.
→ Die anderen beiden enthalten die alte Nummer.
→ Niemand weiß, welche stimmt.
Bei Software ist es genauso. Liegt derselbe Einstellungswert an drei Stellen,
entstehen Fehler, wenn nur eine davon geändert wird.
CANON · REFERENCE · SPEC
Verbindliche Quelle · Referenz · Spec — wie das tatsächlich funktioniert
Beispiel ① · Die verbindliche Quelle der Materialverarbeitung
„Unser Unternehmen schmilzt Kunststoff bei 280 Grad, um Produkte herzustellen.“
→ Diese Information darf nur im Dokument der Materialverarbeitung stehen.
→ Fertigung und Maschinenraum müssen auf diese eine Stelle verweisen.
→ Jemand ändert auf 290 Grad und sagt den anderen Bereichen nichts → ein Unfall.
Beispiel ② · Verbindliche Quelle und Verantwortlicher im Maschinenraum
„Unsere Maschine ist das Modell ABC-150. Für die Schmelztemperatur ist die Materialverarbeitung maßgeblich. Zur Mengenregelung, zum Starten und Stoppen sowie zu Probeläufen nach Upgrades fragen Sie zuerst das Personal im Maschinenraum. Der Maschinenraum teilt Änderungen anschließend der Materialverarbeitung und Fertigung mit.“
→ Die verbindliche Quelle und der Änderungsverantwortliche als Anlaufstelle stehen fest.
→ Eigene Zuständigkeiten und die anderer Bereiche sind klar getrennt.
→ Ohne diese Festlegung beginnen die anderen Bereiche, Unsinn anzustellen.
Zwei Bedingungen für eine verbindliche Quelle (UND):
① Sie steht an genau einer Stelle + ② Alle anderen Stellen verweisen auf sie
Ist auch nur eine Bedingung verletzt, steht dieselbe Information an zwei Stellen unterschiedlich. Menschen und KI wissen nicht, was stimmt. Das Ergebnis: ein Unfall.
Warum verbindliche Quellen
für Claude wichtig sind
welches maßgeblich ist.
verschwindet die Arbeit.
„Dieses Dokument ist das Original.“
Diese eine Zeile entscheidet über Erfolg oder Scheitern des Projekts.
DOC TYPES — 5 CATEGORIES
Dokumente in fünf Dimensionen
Produktidee · Für wen · Warum
Technologiewahl · Systemarchitektur · Datenmodell
UI · Design · Ansichten · Farben · Schriften
Server · Hosting · Infrastruktur · Umgebungsvariablen
⑤ Anlass für verbindliche Quellen und Referenzen —
Wenn mindestens zwei Systeme Informationen teilen müssen, etwa Web, Server, Android und iOS,
und Claude auch nur der geringste Raum für Verwechslungen bleibt,
→ kann jeder solche Bereich eine verbindliche Quelle brauchen.
Warum Spec-/Design-
Dokumente nötig sind
Ohne Spec rät die KI.
Nach hundert oder zweihundert Vermutungen
lässt sich nicht mehr zurückverfolgen, wo es schiefging.
sieht man sofort, was falsch ist.
Es fehlt jeder Vergleichsmaßstab.
Niemand baut ein Haus ohne Bauplan.
Der Plan ist die Spec, das Haus der Code.
Ein Beispiel in einer Zeile
Mit einem Einzeiler festigen
Der genaue Wert ist die verbindliche Quelle.
Eine maßgebliche Zeile, auf die alle Fabriken verweisen.
Ohne Mitteilung auf 290°C ändern → ein Unfall.
911 · Panamera · Cayenne · Taycan —
ein Erscheinungsbild, an dem man alle sofort als Porsche erkennt.
Flyline · Scheinwerfersignatur · Proportionen.
Eine Designquelle, verteilte Fabriken
Alle Modelldesigns werden an einer Stelle entschieden.
911 · Panamera · Cayenne — unterschiedliche Werke.
Ohne verbindliche Quelle → Die Designer jedes Werks raten selbst.
Eine passende Krümmung für den 911, eine für den Cayenne — jeweils getrennt.
→ Man erkennt nicht mehr auf einen Blick, dass es ein Porsche ist.
Beides kann eine verbindliche Quelle sein.
Laut Arbeitsregeln: Welche Abteilung pflegt das Dokument,
und welche Abteilungen dürfen es nur lesen und für ihre Arbeit heranziehen?
→ Über diese eine Frage müssen Sie nachdenken.
PART 2
Die
Dokumentenhierarchie
Der Kern des heutigen Termins.
HIERARCHY
Änderungen gehen nur von oben nach unten
↓
↓
↓
↓
Ändert man zuerst den Code,
beginnen Dokumente und Code auseinanderzulaufen.
Verbindungen zwischen Dokumenten
„Dieses Dokument verweist auf jenes.“
Sagen Sie es der KI ausdrücklich.
Sonst liest die KI ein völlig anderes Dokument
und arbeitet in die falsche Richtung.
SINGLE RESPONSIBILITY · ATTENTION
Nicht alles in eine Datei stopfen
Eine grobe Orientierung: etwa 100 Zeilen (keine absolute Grenze)
Backend-Entwickler zerlegen ihr ganzes Berufsleben lang Code mit diesen Begriffen — warum?
Weil auch Menschen sich in einer Datei verirren. KI geht es genauso.
Zu kurz: Kontext fehlt.
Zu lang oder ohne innere Ordnung: Die KI verirrt sich darin.
Wird all das in einer Datei vermischt, verliert die KI den Verstand:
Dafür gibt es auch einen Forschungsbegriff: Context Rot, Kontextverfall.
In langen Dokumenten bricht die Aufmerksamkeit ein.
Die Zeilenzahl ist nicht alles — zwei Achsen betrachten
① Codezeilen (LOC) + ② Zyklomatische Komplexität
Ein Vergleich: zwei Straßen von je 50 Metern
Gleiche Strecke, aber null gegenüber fünf Entscheidungen. Auf unbekanntem Weg führt einmal falsch Abbiegen in ein anderes Viertel.
Bei Code ebenso: 50 Zeilen ohne Verzweigungen gegenüber zwölf Verzweigungen. Eine falsche Abzweigung führt KI ins falsche Viertel.
Branchenstandard: CC ≤ 10. SonarQube und ESLint messen automatisch (McCabe, 1976).
Die Regel gilt also nicht nur für CLAUDE.md. Sie gilt genauso für Ihren Web- und Backend-Code.
Die Lösung: Dateien aufteilen.
Bei langen Dateien oder vielen Verzweigungen Claude fragen: „Kannst du diese Datei aufteilen?“
Ein 50 Jahre alter Grundsatz der Entwicklung: Separation of Concerns, Trennung der Verantwortlichkeiten.
Nicht auswendig lernen. Nur wissen, dass es den Begriff gibt.
Diese Unternehmensstruktur —
wer hat sie geschaffen?
Menschen haben sie geschaffen.
Organigramm zeichnen, Abteilungen aufteilen, verbindliche Quellen und Verantwortliche festlegen.
Das Unternehmen läuft, weil diese Struktur geschaffen wurde.
Und erst recht bei KI?
KI kann diese Struktur nicht selbst schaffen.
Schon Menschen brauchen sie vorgegeben, KI umso mehr.
Menschen müssen sie liefern. Diese Struktur heißt Dokumentation.
PART 3
Rückblick auf zehn Grundsätze
+ die drei heutigen Grundsätze
RÜCKBLICK auf Termin 2
Heute ergänzen wir drei weitere.
TODAY · 3 NEW PRINCIPLES
Drei Grundsätze kommen heute hinzu
Diese drei gehen wir nacheinander durch.
Aber diese Intelligenz hängt an der Leine ihres Unternehmens.
Ändert das Unternehmen seine Regeln,
denken Sie, ohne den Grund zu kennen:
„Claude ist heute irgendwie seltsam.“
EVIDENCE
Claudes Leistungsschwankungen
— tatsächliche Berichte
April 2026 — GitHub, Reddit, X
Anthropic senkte den voreingestellten Denkaufwand auf „medium“,
um Serverkosten zu sparen.
Die Nutzer wurden nicht informiert.
Der Leiter von Claude Code musste sich persönlich dazu äußern.
Auch einzelne Rückgänge von Opus 4.7 in bestimmten Benchmarks wurden gemeldet.
KI-Unternehmen sind auch Unternehmen. Ihre Produktqualität ändert sich mit den geschäftlichen Umständen.
Das ist der grundlegende Grund, übertriebene Werbung zu hinterfragen.
Rückbezug auf Termine 1 und 2
Ein-Klick-Coding und Ein-Klick-Geschäfte gibt es nicht
Die Botschaft aus Terminen 1 und 2 — „Darüber haben wir gesprochen, oder?“
Heute haben wir aber so lange über das Verfeinern und Verknüpfen von Dokumenten gesprochen.
Verbindliche Quelle → Hierarchie → 100 Zeilen → Vorführung…
Kommt Ihnen das nicht seltsam vor?
Auf YouTube und Instagram heißt es: „Ein Klick reicht für alles“, oder?
„Einfach die KI fragen, Programmierkenntnisse unnötig“
Wie hohl dieses Versprechen ist,
zeige ich anhand von Gesprächen in einem echten Entwicklerchat.
COMMUNITY EVIDENCE
Jeden Tag anders drauf — das erlebe nicht nur ich
KakaoTalk-Chat einer Entwicklercommunity · Letzte Tage (Namen und Profile anonymisiert)
KI ist kein öffentliches Gut mit Qualitätsgarantie.
Sie ist ein Dienst, dessen Zustand sich täglich ändert.
Drei Gegenmaßnahmen: ① Regelmäßig das Verhalten prüfen ② Mehrere Werkzeuge nutzen (Claude, Gemini, Codex) ③ An Communities teilnehmen
Die eigene Antwort zu verteidigen ist sein Instinkt.
Claudes Ergebnisse an Gemini oder Codex geben
oder umgekehrt.
In der Praxis werden Codeerstellung und Codereview auf verschiedene KIs verteilt.
Nutzen Sie Gegenprüfungen aktiv.
:
Kehrt sich das Verhältnis um, geben die meisten innerhalb von zwei Wochen auf.
Teilen Sie die Arbeit von Anfang an in leicht prüfbare Stücke.
10 PRINCIPLES — 8/10
■ Heute behandelt (Termin 3) · ■ In Termin 2 behandelt · ■ Spätere Termine
Wir haben acht der zehn Grundsätze behandelt — heute kamen drei hinzu (#1, #5, #9).
Die übrigen zwei (#7, #8) folgen später.
10 Minuten Pause
PART 4
Claude fragen
Fragen Sie Claude
nach diesen Dingen.
Wie sollte ich CLAUDE.md strukturieren?
Was gehört in PLANNING.md?
Was ist ein PRD? Was ist eine Spec? Was unterscheidet sie?
Schlage die Dokumentenstruktur vor, die mein Projekt braucht
HOMEWORK PROMPTS · 5
Fragen Sie zu Hause noch einmal so.
F1 · Verbindliche Quellen prüfen
„Gibt es in meinem Projekt Dokumente, die eine verbindliche Quelle brauchen könnten?“
F2 · Gemeinsame Web-/Backend-Dokumente und Verantwortliche
„Welche Dokumente müssen Web und Backend gemeinsam nutzen? Wer sollte dann die verbindliche Quelle halten?“
F3 · Dokumente je Abteilung konkretisieren
„Welche Dokumente sollten Web und Backend jeweils neben Design und Architektur besitzen?“
F4 · Backend-Infrastrukturdokumente
„Wie sollte das Backend seine Infrastrukturdokumentation aufbauen?“
F5 · Ein visuelles Diagramm
„Stelle Verweise zwischen Dokumenten, Original-/Kopie-Beziehungen und die Hierarchiepyramide als visuelles HTML-Diagramm dar. Ich möchte es mit eigenen Augen prüfen.“
TODAY'S KEY TAKEAWAY
BONUS — Drei Achsen zum Verhören der KI
PART 5
Die heutige
Hausaufgabe
Probieren Sie es zu Hause.
• PRD.md = Produktanforderungen (was, für wen, warum)
• CLAUDE.md = Regeln, die Claude immer liest
Fehlen sie, lassen Sie Claude sie erstellen.
• Sobald die Arbeit an Referenzen beginnt → „Was wird in Markdown ergänzt, und warum liest Claude das?“
Erleben, dass Quellen und Referenzen nicht bloß Wörter sind, sondern ein Mechanismus, dem KI folgt.
Sie müssen den Vorschlag nicht unverändert übernehmen. Dass es einen Strukturvorschlag gibt, ist der Anfang.
Der Fachbegriff: Domain Knowledge. Beim Vibe Coding gehören WHAT und WHY dem Menschen. Ordnen und Erklären sind wichtiger als je zuvor.
SESSION 03 / 06
Vielen Dank
für Ihre Arbeit heute.
Nächstes Mal — Termin 4.
F12 drücken, und alles ist sichtbar — die Sicherheitsrealität beim Vibe Coding.
OPEN CHAT
Bei Fragen nutzen Sie bitte
den offenen KakaoTalk-Chat.