MD-Dateien: Die Infrastruktur, die KI-Entwicklung von Anfang an richtig macht

Nicht bessere Prompts, sondern eine durchdachte Infrastruktur aus MD-Dateien macht KI-Entwicklung konsistent und skalierbar. TJ zeigt, wie sein Team der KI alles Nötige einmalig mitgibt — Umsysteme, Coding-Style, Corporate Identity, Engineering- und Design-Prinzipien — sodass sie von Schritt eins an qualitativ hochwertige Anwendungen baut. Warum das Prinzip auf einer IBM-Entwicklerkonferenz aus den 90ern fußt und was du davon heute direkt ableiten kannst, hörst du in dieser Folge.

Die Lego-Platte: Was MD-Dateien überhaupt leisten

MD-Dateien sind keine Notizzettel — sie sind die strukturelle Grundlage, auf der KI-gestützte Entwicklung zuverlässig funktioniert. TJ beschreibt sie als das „Habitat" der KI: ein klar definierter Rahmen, der der KI mitteilt, in welcher Welt sie arbeitet. Wer diesen Rahmen einmal sauber aufsetzt, spart sich bei jeder neuen Anwendung das mühsame Wiederholen von Regeln, Kontexten und Präferenzen. Die KI kennt das Spielfeld — und entwickelt darin. Das ist der eigentliche Hebel: nicht mehr erklären, sondern dokumentiert haben.

Umsysteme und Coding-Style: Was die KI über deinen Stack wissen muss

Im Koerting Institute sind aktuell 23 Umsysteme dokumentiert — von Klick-Tipp über Zoom bis Stripe und LexOffice. Das klingt nach Verwaltungsaufwand, ist aber entscheidend: Weil die KI weiß, dass Stripe das Abrechnungssystem ist, schlägt sie nie Digistore vor. Sie denkt im richtigen Stack. Ergänzt wird das durch den Coding-Style-Guide, der festlegt, wie Code dokumentiert wird, welche Praktiken vermieden werden sollen und wie qualitativ hochwertige Entwicklung im Team aussieht. Beides sind eigenständige MD-Dateien — und beides muss nur einmal geschrieben werden.

Corporate Identity und Dokumentationsrichtlinien: Konsistenz ohne Kontrolle

Damit alle Anwendungen einheitlich wirken, steckt die Corporate Identity ebenfalls in einer MD-Datei: Farbgebung, Klammer-Syntax, visuelles Erscheinungsbild. Die KI greift automatisch darauf zurück. Parallel dazu regeln Dokumentationsrichtlinien über das Tool Linear, wie Features, Bugs und Release Notes festgehalten werden. Das klingt nach Bürokratie — ist aber das Gegenteil. Wer einmal definiert, wie Dinge dokumentiert werden, befreit sein Team davon, es jedes Mal neu aushandeln zu müssen. Struktur schafft Spielraum.

Engineering-Prinzipien: Eine IBM-Lektion, die 30 Jahre Gültigkeit hat

Vor 30 Jahren lernte TJ auf einer IBM-Entwicklerkonferenz in Keystone, Colorado von Paul Giangara — damals einer der Chefentwickler bei IBM — zehn Prinzipien für performante Anwendungen. Eines davon: Denke den nächsten Nutzerschritt voraus und führe ihn im Hintergrund schon aus. Wenn der Nutzer dann klickt, ist das Ergebnis sofort da. Ein weiteres Prinzip ist der Zwei-Fakten-Check bei kritischen Berechnungen. Beide Prinzipien stehen jetzt in der Engineering-MD-Datei — und die KI baut sie automatisch in jede Anwendung ein. Kein Erinnern, kein Nachfragen. Einfach drin.

Design-Prinzipien und Fazit: Anwendungen, die kein Handbuch brauchen

Die jüngste Ergänzung sind Design-Prinzipien — nicht im grafischen Sinne, sondern auf der Ebene der Usability. Wie werden Buttons angeordnet? In welcher Reihenfolge führt man Menschen durch Eingabemasken? Die Antworten stehen in der MD-Datei, damit Anwendungen selbsterklärend sind. Kein Handbuch für Melissa, Nina oder Mia — einfach öffnen und verstehen. Das ist die eigentliche Qualität dieser Infrastruktur: Nicht die KI wird besser, weil man besser prompts. Sie wird besser, weil sie von Anfang an den richtigen Kontext hat. Einmal aufsetzen. Immer profitieren.

Das nimmst du mit

• Wenn du deine Umsysteme — zum Beispiel Stripe, Klick-Tipp oder n8n — als MD-Datei mitgibst, schlägt die KI dir nie wieder Lösungen vor, die nicht in deinen Stack passen.
• Engineering-Prinzipien wie der Zwei-Fakten-Check gehören in eine MD-Datei: Dann baut die KI sie automatisch in jede Anwendung ein, ohne dass du sie jedes Mal neu erklärst.
• Das IBM-Prinzip von Paul Giangara aus Keystone, Colorado gilt noch heute: Denke den nächsten Nutzerschritt voraus, führe ihn im Hintergrund aus — und das Ergebnis ist sofort da, wenn der Nutzer klickt.
• Design-Prinzipien in MD-Dateien sorgen dafür, dass Anwendungen selbsterklärend sind und kein Handbuch brauchen — ein konkreter Qualitätsgewinn für alle, die täglich damit arbeiten.
• Eine MD-Datei-Infrastruktur ist keine einmalige Fleißarbeit, sondern die Voraussetzung dafür, dass KI-Entwicklung konsistent, skalierbar und vom ersten Schritt an qualitativ hochwertig bleibt.

Kapitel

• 00:00 Einstieg: Was steckt in den MD-Dateien?
• 01:31 Umsysteme: Welche Tools kennt die KI?
• 02:07 Coding-Style-Guide: Wie wird bei euch entwickelt?
• 02:57 Corporate Identity & Dokumentationsrichtlinien
• 03:38 Engineering-Prinzipien: IBM-Lektion aus Keystone, Colorado
• 05:17 Design-Prinzipien: Usability statt Handbuch

Noch mehr von den Koertings ...

Das KI-Café ... jede Woche Mittwoch (>350 Teilnehmer) von 16:30 bis 18:00 Uhr ... online via Zoom .. kostenlos und nicht umsonst
Jede Woche Mittwoch um 16:30 Uhr öffnet das KI-Café seine Online-Pforten ... wir lösen KI-Anwendungsfälle live auf der Bühne ... moderieren Expertenpanel zu speziellen Themen (bspw. KI im Recruiting ... KI in der Qualitätssicherung ... KI im Projektmanagement ... und vieles mehr) ... ordnen die neuen Entwicklungen in der KI-Welt ein und geben einen Ausblick ... und laden Experten ein für spezielle Themen ... und gehen auch mal in die Tiefe und durchdringen bestimmte Bereiche ganz konkret ... alles für dein Weiterkommen.
Melde dich kostenfrei an ... www.koerting-institute.com/ki-cafe/

Mit jedem Prompt ein WOW! ... für Selbstständige und Unternehmer
Ein klarer Leitfaden für Unternehmer, Selbstständige und Entscheider, die Künstliche Intelligenz nicht nur verstehen, sondern wirksam einsetzen wollen. Dieses Buch zeigt dir, wie du relevante KI-Anwendungsfälle erkennst und die KI als echten Sparringspartner nutzt, um diese Realität werden zu lassen. Praxisnah, mit echten Beispielen und vollständig umsetzungsorientiert.
Das Buch ist ein Geschenk, nur Versandkosten von 9,95 € fallen an. Perfekt für Anfänger und Fortgeschrittene, die mit KI ihr Potenzial ausschöpfen möchten.
Das Buch in deinen Briefkasten ... https://koerting-institute.com/shop/buch-mit-jedem-prompt-ein-wow/

Die KI-Lounge ... unsere Community für den Einstieg in die KI (>2800 Mitglieder)
Die KI-Lounge ist eine Community für alle, die mehr über generative KI erfahren und anwenden möchten. Mitglieder erhalten exklusive monatliche KI-Updates, Experten-Interviews, Vorträge des KI-Speaker-Slams, KI-Café-Aufzeichnungen und einen 3-stündigen ChatGPT-Kurs.

Tausche dich mit über 4.000 KI-Enthusiasten aus, stelle Fragen und starte durch.
Initiiert von Torsten & Birgit Koerting, bietet die KI-Lounge Orientierung und Inspiration für den Einstieg in die KI-Revolution.
Hier findet der Austausch statt ... www.koerting-institute.com/ki-lounge/

Starte mit uns in die 1:1 Zusammenarbeit
Wenn du direkt mit uns arbeiten und KI in deinem Business integrieren möchtest, buche dir einen Termin für ein persönliches Gespräch. Gemeinsam finden wir Antworten auf deine Fragen und finden heraus, wie wir dich unterstützen können. Klicke hier, um einen Termin zu buchen und deine Fragen zu klären.
Buche dir jetzt deinen Termin mit uns ... www.koerting-institute.com/termin/

Weitere Impulse im Netflix Stil ...
Wenn du auf der Suche nach weiteren spannenden Impulsen für deine Selbstständigkeit bist, dann gehe jetzt auf unsere Impulseseite und lass die zahlreichen spannenden Impulse auf dich wirken.
Inspiration pur ... www.koerting-institute.com/impulse/

Die Koertings auf die Ohren ...
Wenn dir diese Podcastfolge gefallen hat, dann höre dir jetzt noch

weitere informative und spannende Folgen an ...
über 500 Folgen findest du hier ... www.koerting-institute.com/podcast/

Wir freuen uns darauf, dich auf deinem Weg zu begleiten!