Von README.md zu PROGRAM.md: Markdown ist jetzt eine Programmiersprache
22 Jahre lang war Markdown ein Dokumentationsformat. Man schrieb READMEs, Blogbeiträge und Notizen. Es erklärte Dinge an Menschen.
Dann änderte sich etwas. 2024 begannen KI-Coding-Assistenten, .cursorrules und copilot-instructions.md zu lesen. 2025 etablierte sich AGENTS.md als universeller Standard. Anfang 2026 veröffentlichte Andrej Karpathy Autoresearch, bei dem der gesamte menschliche Beitrag eine Markdown-Datei namens program.md ist.
Die Entwicklung ist klar:
| Ära | Datei | Zielgruppe | Zweck |
|---|---|---|---|
| 2004-2023 | README.md | Menschen | Dokumentation |
| 2024 | .cursorrules | KI-Coding-Tools | Code-Stil-Regeln |
| 2025 | AGENTS.md | KI-Coding-Agenten | Projektanweisungen |
| 2026 | program.md | Autonome Agenten | Forschungsprogramme |
Markdown ist nicht mehr nur Dokumentation. Es ist eine Programmiersprache für KI.
Die drei Generationen
Generation 1: Dokumentation (README.md)
Der ursprüngliche Markdown-Anwendungsfall. Man schreibt eine README, um Menschen das eigene Projekt zu erklären. Sie ist passiv — sie wartet, bis ein Mensch sie liest. Keine Maschine handelt auf ihrer Basis.
Generation 2: Konfiguration (AGENTS.md, CLAUDE.md)
KI-Coding-Assistenten brauchen Projektkontext. AGENTS.md teilt ihnen Build-Befehle, Coding-Konventionen und Architekturentscheidungen mit. CLAUDE.md passt das Verhalten von Claude Code an. Diese Dateien sind aktiv — eine KI liest sie und ändert ihr Verhalten entsprechend.
Aber der Mensch schreibt noch den Code. Die Markdown-Datei hilft der KI nur, besser zu assistieren.
Generation 3: Programmierung (program.md)
Mit Autoresearch schreibt der Mensch überhaupt keinen Code. Der gesamte Beitrag ist program.md — eine Markdown-Datei, die Forschungsziele, Einschränkungen und Strategie definiert. Der KI-Agent liest sie und schreibt, führt aus und iteriert dann stunden- oder tagelang autonom Code.
Das ist Markdown als Programmiersprache. Das Ergebnis ist kein formatierter Text — es sind laufender Code, experimentelle Ergebnisse und wissenschaftliche Entdeckungen.
Warum Markdown?
Warum haben alle KI-Systeme auf Markdown konvergiert statt auf YAML, JSON oder eine benutzerdefinierte DSL?
Es ist in den Trainingsdaten. LLMs haben während des Trainings Milliarden von Markdown-Dateien gesehen. Sie verstehen seine Konventionen tiefgründig — Überschriften zeigen Hierarchie an, Aufzählungspunkte zeigen Listen an, Codeblöcke zeigen ausführbaren Inhalt an.
Es ist flexibel. Markdown zwingt kein starres Schema auf. Man kann Freitext-Anweisungen, strukturierte Tabellen, Codebeispiele und natürliche Sprache in derselben Datei schreiben. Diese Flexibilität passt dazu, wie Menschen über die Steuerung von KI-Agenten nachdenken.
Es ist überprüfbar. Man kann ein program.md lesen und genau verstehen, was dem Agenten gesagt wird zu tun. Versuchen Sie das mit einer 500-zeiligen YAML-Konfiguration.
Es ist versionierbar. Jede Änderung an den Agentenanweisungen ist ein Git-Commit. Man kann Agentenverhaltensänderungen genauso wie Code-Änderungen vergleichen, prüfen und rückgängig machen.
Was das für Sie bedeutet
Wenn Markdown zu einer Programmiersprache wird, dann wird jeder, der Markdown schreibt, irgendwie zum Programmierer. Die Fähigkeit liegt nicht in der Syntax — sie liegt in der Klarheit des Denkens und der Präzision der Anweisung.
Was jetzt wichtig ist:
Präzise Markdown-Anweisungen schreiben lernen. Je besser Ihr AGENTS.md oder program.md, desto besser performt Ihr KI-Agent. Das ist eine neue Fähigkeit, die technisches Wissen mit klarem Schreiben verbindet.
Eine Referenzbibliothek in Markdown aufbauen. Wenn man Anweisungen für KI-Agenten schreibt, braucht man Referenzmaterial: Dokumentation, Beispiele, Artikel, Best Practices. Dieses Material in sauberem Markdown-Format zu haben, macht es sofort nutzbar.
Das KI-Markdown-Ökosystem verstehen. Den Unterschied zwischen AGENTS.md, CLAUDE.md, llms.txt und program.md kennen. Jedes dient einem anderen Zweck im wachsenden Markdown-for-AI-Stack.
Wissen für Agentenanweisungen erfassen
Gute KI-Agentenanweisungen zu schreiben erfordert Wissen. Man muss die Domäne, die Tools, die Einschränkungen und die Ziele verstehen. Viel dieses Wissens lebt im Web — in Dokumentationsseiten, Blogbeiträgen, Forschungsartikeln und Tutorials.
Save konvertiert jede dieser Web-Quellen mit einem Klick in sauberes Markdown. Wenn man ein program.md oder AGENTS.md erstellt, bedeutet das Referenzmaterial bereits in Markdown zu haben, dass man sofort Auszüge erstellen, referenzieren und darauf aufbauen kann.
Die Forscher, die die besten program.md-Dateien schreiben, fangen nicht bei Null an. Sie bauen auf Wissen auf, das sie im Markdown-Format erfasst und organisiert haben.
Save konvertiert jede Webseite in sauberes Markdown — perfekt, um die Referenzbibliothek aufzubauen, die man braucht, um effektive KI-Agentenanweisungen zu schreiben. Save kostenlos testen
## Continue reading
Wie man ein gutes program.md schreibt: Ein praktischer Leitfaden für KI-Agenten-Anweisungen
program.md ist die Datei, die KI-Agenten in Karpathys Autoresearch programmiert. Hier ist, wie man eine schreibt, die Ergebnisse liefert — mit Struktur, Beispielen und Best Practices.
Karpathys Autoresearch & PROGRAM.md: KI, die Experimente macht, während Sie schlafen
Andrej Karpathys Autoresearch lässt KI-Agenten 100+ ML-Experimente über Nacht durchführen, geleitet von einer einzigen Markdown-Datei namens program.md. Hier ist, wie es funktioniert und warum es wichtig ist.
Vibe Coding ist tot. Willkommen beim Agentic Engineering mit Markdown.
Karpathy sagt, Vibe Coding ist passé. Das neue Paradigma ist Agentic Engineering, bei dem Sie KI-Agenten durch Markdown-Dateien orchestrieren, anstatt selbst Code zu schreiben.
AGENTS.md & CLAUDE.md: Die neue README für KI-Coding-Agenten
Erfahren Sie, wie AGENTS.md- und CLAUDE.md-Dateien KI-Coding-Assistenten wie GitHub Copilot, Cursor und Claude Code steuern. Plus: Wie Sie effektive Agenten-Instruktionsdateien für Ihre Projekte schreiben.
Written by
Jean-Sébastien Wallez
I've been making internet products for 10+ years. Built Save on weekends because I wanted my own reading library in clean markdown for Claude and Obsidian. Write here about web clipping, AI workflows, and the small things that make a personal knowledge base actually useful.