8 Regeln für AGENTS.md: Token sparen und Overengineering durch KI stoppen

X-PostAYiSammlung

Basierend auf Erfahrungen mit rund 60 Milliarden verarbeiteten Tokens hat Marcos Hernanz aus dem Next.js-Team bei Vercel acht Leitregeln für AGENTS.md formuliert. Die Konfiguration zwingt Programmier-Agenten dazu, einfachen und pragmatischen Code zu schreiben, anstatt überflüssige Abstraktionen und Abhängigkeiten zu erzeugen.

Das Wichtigste

  1. Agenten sollen veralteten Code direkt löschen und auf Abwärtskompatibilität, Fallbacks sowie Migrationen verzichten.
  2. Es gilt immer die einfachste Implementierung ohne vorzeitige Abstraktionen oder überflüssige Konfigurationsebenen zu wählen.
  3. Systeme werden schrittweise gebaut: Zuerst eine minimale End-to-End-Lösung fertigstellen, statt funktionierenden Code für unvollständige Architekturen zu zerlegen.
  4. Bestehende Abhängigkeiten im Projekt zuerst prüfen und auf reife Bibliotheken sowie bewährte Muster setzen, anstatt Räder neu zu erfinden.
  5. Werkzeuge wie Cursor, Claude Code, Codex und Windsurf lesen die AGENTS.md automatisch im Projekt-Root ein.
  6. Wichtige Einschränkung: Die strikte Regel gegen Abwärtskompatibilität eignet sich primär für Nebenprojekte und Prototypen; in Produktionsumgebungen droht sonst unkontrollierter Datenverlust.

Warum das relevant ist

KI-Agenten neigen dazu, einfache Aufgaben durch komplexe Abstraktionsschichten und unnötige Bibliotheken aufzublähen. Dies treibt die Token-Kosten in die Höhe und erfordert zeitintensive Nachbesserungen. Eine präzise Vorgabe im Projekt-Root verhindert Fehlentwicklungen bereits vor der Code-Generierung.

Einordnung

Der Ansatz setzt an der Wurzel von Token-Ineffizienzen an. Während LLMs standardmäßig aus Sicherheitsbedenken oft defensive Kompatibilitätsschichten einbauen, reduziert das bewusste Streichen dieser Schichten den generierten Code massiv. Allerdings zeigt der Warnhinweis des Autors auch die inhärente Gefahr autonomer KI-Entwicklung: Ohne Schutzgeländer und menschliche Kontrolle kann der radikale Verzicht auf Rückwärtskompatibilität verheerende Schäden an Produktionsdaten anrichten.

Original-Post

AYi

@AYi_AInotes · 4. August 2026

简直就是省Token焚决！！！ Vercel Next.js团队的老哥，烧了大约60B tokens，总结出一份AGENTS.md，核心就8条规则。 60B tokens什么概念？大概六位数美元。 这8条规则的本质就一句话：让你的AI编程Agent别像个实习生什么都想自己造，要像个干了十年的老油条一样写代码。 直接上规则： 1. t.co/xMZNDQuCjt t.co/IReVC0tw4J

2853 Likes52 Antworten4974 Lesezeichen403.309 Aufrufe

Auf X ansehen
Ausgewählte Antworten (2)
  • @lliu54827 @AYi_AInotes 这8条我读完第一条就想笑，我天天用Claude处理东西最大的教训就是它default会加兼容层，不是模型笨，是它猜更安全的路径就是保留旧代码。 我CLAUDE.md里加了一条不留向后兼容，少写至少三成废代码。 但生产环境那条警告是真的，我自己也差点让它动了不该动的配置文件。
  • @JaxsonZhang2293 @AYi_AInotes 最打动我的是第2条和第5条：宁可先用最简单实现，也别预防性抽象。延伸一点：规则写进 AGENTS.md 只是开始，定期回头删掉过时规则同样重要，不然文件本身又变成新包袱。已收藏。

Erwähnte Links

Zusammenfassung von KI erstellt (Gemini 3.8 Flash, 27. September 2026). Sie kann Fehler enthalten – maßgeblich ist die Originalquelle.

Ähnliche Einträge

Inhaltlich ähnlich, ermittelt über die KI-Suche.

  • Repository:DietrichGebert/ponytail

    Ponytail: Agent-Regeln gegen Over-Engineering beim KI-gestützten Coden

    Ponytail ist ein Open-Source-Tool und Agent-Skill, das KI-Assistenten dazu bringt, minimalistischen Code nach dem YAGNI-Prinzip zu schreiben. Es soll unnötigen Code reduzieren und die Entwicklung mit Coding-Agenten wie Claude Code oder Cursor beschleunigen und verbilligen.

    127.097SterneJavaScript

    KI & AI· Tool

  • Link:DietrichGebert

    ponytail: Minimalistisches Regelwerk für KI-Coding-Agenten

    ponytail ist ein Regelwerk und Plugin für KI-Coding-Agenten, das Modelle dazu anhält, möglichst wenig neuen Code zu schreiben. Durch Standardbibliotheken, native Plattform-Features und vorhandene Abhängigkeiten wird Over-Engineering reduziert.

    KI & AI· Tool

  • X-Post:Miles Cranmer

    Ponytail: Agenten-Skill gegen überkomplexen Code

    Miles Cranmer empfiehlt das Open-Source-Projekt »ponytail« als effektives Prompting-Tool gegen überdimensionierten Code von KI-Agenten. Das System bringt Coding-Agenten dazu, minimale Lösungen wie native Plattformfunktionen zu bevorzugen, anstatt unnötige Bibliotheken und Wrapper zu erzeugen.

    1523Lesezeichen47.467Aufrufe

    KI & AI· Tool

  • Repository:GonChen/real-engineering-prompt

    Real Engineering Prompt: Minimalistische Verhaltensregeln für Coding-Agents

    Das Open-Source-Projekt stellt eine schlanke Instruktionsvorlage (AGENTS.md) bereit, die moderne Coding-Agents auf pragmatische Engineering-Prinzipien wie minimale Komplexität, isolierte Änderungen und evidenzbasierte Verifikation ausrichtet.

    4Sterne

    KI & AI· Sammlung

  • Repository:multica-ai/andrej-karpathy-skills

    CLAUDE.md-Regelsatz basierend auf Andrej Karpathys Beobachtungen zu Coding-LLMs

    Das Repository stellt eine einzelne Konfigurationsdatei (CLAUDE.md) für das Tool Claude Code bereit. Sie leitet sich aus Kritikpunkten von Andrej Karpathy an typischen Fehlern von Programmier-LLMs ab und soll Fehlannahmen, unnötige Code-Komplexität sowie unerwünschte Nebeneffekte verhindern.

    210.262Sterne

    KI & AI· Sammlung

Zurück zur Wissensbasis

Lassen Sie uns über Ihr Projekt sprechen

Kontakt aufnehmen

Standorte

  • Mattersburg
    Johann Nepomuk Bergerstraße 7/2/14
    7210 Mattersburg, Austria
  • Wien
    Ungargasse 64-66/3/404
    1030 Wien, Austria

Dieser Inhalt wurde teilweise mithilfe von KI erstellt.