install.md — Standard oder Workaround?
install.md (öffnet in neuem Tab) verspricht: strukturierte Markdown-Datei, die KI-Agenten autonom durch Installation führen — statt zufällige Webseiten zu scrapen.
Steve Baka sieht das nüchtern: Jedes ernsthafte Projekt hat bereits ein Getting-Started. README, Quickstart, Onboarding — wenn ein Agent npm install nicht aus normalem Docs folgt, ist das Tooling oder die Docs schlecht, nicht das Fehlen eines Sonderformats.
Für DACH-Agenturen gilt: Ein Pflege-Artefakt weniger schlägt ein zweites, das driftet — besonders wenn Kunden ohnehin knappe Doc-Budgets haben.
Redundanz und DONE WHEN vs. Gherkin
install.md dupliziert Inhalt aus Getting-Started — plus KI-Preamble („Execute all steps autonomously“) und OBJECTIVE / DONE WHEN. Das ist Gherkin-ähnlich (Given/When/Then seit 2008), nur mit anderen Keywords.
Wer maschinenlesbare, prüfbare Installation will, hat Optionen mit Ökosystem: Gherkin/Cucumber, Makefile, Dockerfile, Shell-Skripte — battle-tested statt neuem Keyword-Set.
Zwei parallele Install-Docs → zwei Wahrheiten. Single Source of Truth gewinnt.
AI-Slop vs. echte Lücke
install.md passt in ein Muster: Bauen ist billig geworden, Standards entstehen vor Problembeweis. Verdächtig, nicht automatisch nutzlos — aber skeptisch prüfen, ob es Kundenmehrwert oder Hype ist.
Die Lücken, die install.md adressiert (HTML-Scraping, veraltete Snippets), werden durch bessere Docs plus Agent-Readiness geschlossen: Markdown, llms.txt, saubere Quickstarts — siehe Dokumentation KI-lesbar machen.
Auf heutige Modell-Limits zu bauen, erinnert an Prompt-Tricks von GPT-3 — oft in 6–18 Monaten obsolet.
Was Agenturen stattdessen empfehlen sollten
1. Bulletproof Getting-Started: Prerequisites, Copy-Paste-Befehle, Verify-Schritt am Ende, Fehler häufigster Fälle.
2. Bestehende executable Formate wo nötig — nicht install.md als drittes Format.
3. Agent-Readiness der normalen Docs — Negotiation, llms.txt, klare Überschriften; Modelle lesen menschliche Guides immer besser.
4. Eine Quelle pflegen — Beratungs-ROI entsteht durch Qualität und Automatisierung der Referenz, nicht durch Parallel-Standards.
Pragmatisches Urteil für Kundenprojekte
install.md schadet selten — hilft gelegentlich spezifischen Agent-Setups. Default-Empfehlung: nein, solange Getting-Started und KI-Lesbarkeit nicht stehen.
Wenn Kunde install.md verlangt: als generiertes Artefakt aus dem Quickstart bauen, nicht manuell pflegen.
Wetten auf Zeitloses (klare menschliche Docs) statt Temporäres (Format für heutige Agent-Schwächen) — das skaliert in Beratung und Produkt gleichermaßen.
