--- type: "Comparison" title: "AGENTS.md vs. README.md (für KI-Agenten): Was soll Ihren Coding-Agent steuern?" description: "AGENTS.md vs. README.md für KI-Coding-Agenten 2026. AGENTS.md ist jetzt der etablierte Standard (60k+ Repos, Codex, Cursor, Next.js 16.3) — README bleibt wichtig. So nutzen Sie beide." resource: "https://www.contextstudios.ai/de/vergleich/agents-md-vs-readme-for-ai-agents" language: "de" tags: ["AGENTS.md vs README", "AI context file", "human vs machine readme"] generated: by: "process:contextstudios-md/1" at: "2026-10-08T22:19:16.935Z" status: "stable" --- # AGENTS.md vs. README.md (für KI-Agenten): Was soll Ihren Coding-Agent steuern? Coding-Agenten wie Claude Code, Cursor und Codex lesen Ihr Repo, bevor sie es anfassen — aber wo gehören die Anweisungen hin? Jahrelang war README.md die einzige Option; AGENTS.md ist heute der eigens dafür gebaute Standard für Agenten-Anweisungen. Beide sind keine echten Rivalen: README ist die menschliche Eingangstür, AGENTS.md das Anweisungsblatt des Agenten. Dieser Vergleich betrachtet gezielt die Aufgabe „Agenten-Kontext“. ## Detaillierter Vergleich | Faktor | AGENTS.md | README.md (für KI-Agenten) | Gewinner | |--------|------|------|--------| | Zweck & Zielgruppe | Eigens für KI-Agenten gebaut: ein dedizierter Ort für Build-/Test-Befehle, Konventionen und Leitplanken, die der Agent befolgen muss. | Zuerst für Menschen geschrieben — Onboarding, Installation und Projektüberblick. Agenten können sie lesen, aber sie ist nicht als Anweisungsblatt gedacht. | AGENTS.md | | Standardisierung & Tool-Unterstützung | Offener Standard, verwaltet von der Linux Foundation (Agentic AI Foundation); von 28+ Tools unterstützt (Codex, Cursor, GitHub Copilot, Aider, Zed, Sourcegraph Amp) und in 60.000+ Open-Source-Repositories vorhanden. | Universelle Datei, aber ohne agent-spezifische Konvention — jedes Tool raten, welche Teile des README Anweisungen sind. | AGENTS.md | | Signal statt Rauschen für den Agenten | Enthält nur agentenrelevante Regeln, sodass das Modell nicht von Badges, Lizenzen oder Marketing abgelenkt wird. | Mischt Installationsschritte, CI-Badges, Contribution-Hinweise und Marketing — das verwässert die eigentlichen Anweisungen. | AGENTS.md | | Menschliche Eingangstür | Wird von Menschen selten gelesen; GitHub/npm rendern sie nicht als Landing-Dokument. | Der Standard-Einstiegspunkt für Menschen, gerendert auf GitHub, npm und den meisten Registries — für Menschen unersetzlich. | README.md (für KI-Agenten) | | Monorepo & verschachteltes Scoping | Unterstützt verschachtelte AGENTS.md-Dateien, die Agenten pro Paket zusammenführen — sauberes Scoping in großen Repos. | Ordnerweise READMEs existieren, sind aber kein konventioneller, von Agenten gelesener Scoping-Mechanismus. | AGENTS.md | | Wartungsaufwand | Eine zusätzliche Datei, die synchron bleiben muss — hält Agentenregeln aber davor, in der menschlichen Doku zu verrotten. | Nur eine Datei zu pflegen — einfacher, aber hier vergrabene Agentenregeln veralten unbemerkt. | Unentschieden | | Universalität & Fallback | Neuerer Standard; einige ältere Agenten-Setups suchen noch nicht danach. | Wird praktisch von jedem Menschen und Tool gelesen und ist der übliche Fallback, wenn keine AGENTS.md vorhanden ist. | README.md (für KI-Agenten) | ## Wichtige Statistiken - **AGENTS.md is reported across 60,000+ open-source repositories by mid-2026, supported by OpenAI Codex, Cursor and GitHub Copilot.** — [Tech With Ibrahim (Medium) — Top AI Agent Standards 2026](https://techwithibrahim.medium.com/top-ai-agent-standards-to-know-in-2026-c4a53f4b6bfd) (2026) - **In Vercel's own agent evals, a compressed 8KB docs index embedded in AGENTS.md hit a 100% pass rate, while modular skills maxed out at 79%.** — [Vercel — AGENTS.md outperforms skills in our agent evals](https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals) (2026) - **Next.js 16.3 ships first-party AGENTS.md docs so agents like Claude Code, Cursor and Codex get framework context by default.** — [Next.js 16.3: AI Improvements](https://nextjs.org/blog/next-16-3-ai-improvements) (2026) - **AGENTS.md is a single standardized markdown file at the repository root that gives coding agents project-specific conventions — replacing fragmented per-tool config files.** — [AGENTS.md Guide 2026 (vibecoding.app)](https://vibecoding.app/blog/agents-md-guide) (2026) - **By 2026 AGENTS.md has become the default way engineering teams give AI coding agents the context they need — including monorepo and nested-package patterns.** — [BuildBetter — AGENTS.md Complete Guide for Engineering Teams 2026](https://blog.buildbetter.ai/agents-md-complete-guide-for-engineering-teams-in-2026) (2026) - **Kontrollierte Studie an 10 Repositories und 124 GitHub-Pull-Requests: Die Anwesenheit einer AGENTS.md-Datei ist mit ca. 28,6 % niedrigerer medianer Laufzeit und ca. 16,6 % reduzierten Output-Token-Verbrauch verbunden, bei vergleichbarer Task-Abschlussrate.** — [arXiv 2601.20404 — Mohsenimofidi et al. (Jan 2026, v2 Mrz 2026)](https://arxiv.org/abs/2601.20404) (2026) ## Wählen Sie AGENTS.md, wenn... - KI-Agenten sollen bestimmte Build-, Test- und Style-Konventionen befolgen - Sie arbeiten in einem Monorepo und brauchen verschachtelte, paketweise Agentenregeln - Ihr Team nutzt täglich Codex, Cursor, Copilot oder Claude Code - Sie wollen Agenten-Anweisungen von menschlicher Marketing-/Doku trennen ## Wählen Sie README.md (für KI-Agenten), wenn... - Das Projekt ist winzig und eine einzige lesbare Datei genügt - Sie brauchen die universelle Datei, die jeder Mensch und jedes Tool auf GitHub/npm liest - Ihre Agenten/Tools sind älter als AGENTS.md und suchen nur nach README - Sie dokumentieren zuerst für Menschen, dann für Agenten ## Unsere Empfehlung Um einem KI-Coding-Agenten zu sagen, wie er in Ihrem Repo arbeiten soll, ist AGENTS.md 2026 der klare Standard — verbreitet über 60.000+ Repositories, unterstützt von Codex, Cursor und Copilot und in Next.js 16.3 ab Werk enthalten. README.md bleibt für das menschliche Onboarding zuständig und ist der universelle Fallback, den viele Agenten lesen, wenn keine AGENTS.md existiert. Best Practice: Behalten Sie beide. Menschliche Doku, Installationsschritte und Badges in die README; Build-/Test-Befehle, Konventionen, Nicht-anfassen-Pfade und Agentenregeln in die AGENTS.md. Pressen Sie Agenten-Anweisungen nicht in die README — dort verwässern sie die menschliche Doku und werden übersehen. ## Häufig gestellte Fragen **Q: Ersetzt AGENTS.md die README.md?** A: Nein. Sie bedienen unterschiedliche Zielgruppen. README.md bleibt die menschliche Eingangstür für Onboarding und Installation; AGENTS.md ist die maschinenlesbare Anweisungsdatei für Coding-Agenten. Behalten Sie beide. **Q: Ist AGENTS.md jetzt wirklich ein Standard?** A: Ja — bis Mitte 2026 ist sie über 60.000+ Repositories verbreitet und wird von OpenAI Codex, Cursor und GitHub Copilot unterstützt; Next.js 16.3 liefert AGENTS.md-Doku ab Werk mit. **Q: Was gehört in AGENTS.md vs. README.md?** A: AGENTS.md: Build-/Test-Befehle, Code-Konventionen, Nicht-anfassen-Pfade, PR- und Review-Regeln. README.md: Projektüberblick, Installation, Nutzung, Badges und menschliche Contribution-Hinweise. **Q: Funktioniert ein Agent auch mit nur einer README?** A: Meist ja — viele Agenten greifen auf die README zurück, wenn keine AGENTS.md existiert. Bessere, konsistentere Ergebnisse bekommen Sie aber mit einer dedizierten AGENTS.md und sauberen, rein agentenbezogenen Anweisungen.