AntwortenVeröffentlicht9 Quellen
Warum KI-Coding-Agenten klare Regeln für Tests und Dateien brauchen
Der Entwurf will Projektnavigation, fachliche Spezifikationen, Architekturentscheidungen und Arbeitspläne klarer voneinander trennen. Dauerhafte Regressionstests sollen erhalten bleiben; temporäre Prüfergebnisse und Testcode werden unterschiedlich behandelt.
Veröffentlicht vonBilder erstellt mit GPT Image 2
Forschungsantwort
Wichtige Erkenntnisse
- Der Entwurf will Projektnavigation, fachliche Spezifikationen, Architekturentscheidungen und Arbeitspläne klarer voneinander trennen.
- Dauerhafte Regressionstests sollen erhalten bleiben; temporäre Prüfergebnisse und Testcode werden unterschiedlich behandelt.
- Die Vorschläge sind noch nicht umgesetzt: Der ADR Entwurf hat den Status „PROPOSED“, und eine ältere Aufgabe bleibt blockiert.
- Cline beschreibt Plan als Modus für Analyse und Planung und Act als Modus zur Umsetzung.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/nzMhQ6wEefYpIEeZmiHsW3GCRyJ2/images/4DFBA6B6FA669F650613/F3119D0DD1A7DF6D3258.png)
KI-Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"apply diff","arguments":{"path":" bmad output/analysis/ANALYSIS 20261022 document test governance.md","diff":"<<<<<<< SEARCH\n:start line:66\n \n项目事实文件本轮保持不写入；不将未经本次读取核实的格式或陈旧信息声明登记为事实。文件缺失、权限拒绝、磁盘错误和. Topic tags: general web, ai, workflow, code, python. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with
KI-Coding-Agenten können Dateien lesen, Code verändern und Tests ausführen. Damit solche Werkzeuge in einem Projekt verlässlich eingesetzt werden, reicht es jedoch nicht, ihnen möglichst viele Aufgaben zu übertragen. Genauso wichtig ist eine klare Antwort auf Fragen wie: Welche Dokumentation gilt? Welche Tests müssen erhalten bleiben? Und wann darf ein Agent tatsächlich Änderungen vornehmen?
Ein am 22. Oktober 2026 datierter Governance-Entwurf schlägt dafür eine schrittweise Ordnung vor. Er ist ausdrücklich noch kein Umsetzungsbeschluss: Der neue Architekturentscheid (ADR) steht auf „PROPOSED“, während eine ältere, damit verbundene Aufgabe weiterhin als blockiert geführt wird.
Dokumentation nach Zweck ordnen
Der Vorschlag setzt nicht auf möglichst wenige Dateien, sondern auf klar abgegrenzte Aufgaben. Eine Projekt-Einstiegsseite soll zu wichtigen Informationen und Prüfabläufen führen, ohne den laufenden Arbeitsfortschritt jeder einzelnen Aufgabe mitzuschreiben. Fachliche Spezifikationen sollen aktuelle Anforderungen, Schnittstellen und Abnahmekriterien bündeln. Architekturentscheidungen wiederum sollen festhalten, welche Alternativen abgewogen wurden und warum eine Richtung gewählt wurde.
Arbeitspläne sollen ihre eigenen Ziele, Voraussetzungen und Prüfkriterien behalten. Der Entwurf warnt davor, eine ältere, noch offene Aufgabe einfach durch einen neuen Plan zu ersetzen oder deren Speicherort zu übernehmen. Auch abgeschlossene und eingefrorene Aufgaben sollen unterscheidbar bleiben: Ein eingefrorener Plan ist nicht automatisch erledigt.
Regressionstests sind kein Wegwerfmaterial
Ein zentraler Punkt ist die Unterscheidung zwischen langfristigen Tests und kurzfristigen Prüfungen. Regressionstests, die bereits gefundene Fehler oder wichtige Projektanforderungen absichern, sollen nicht allein deshalb verschwinden, weil sie mit einem einzelnen Auftrag entstanden sind. Temporäre Sonden und ihre Ausgaben sind dagegen nicht automatisch dauerhafte Projektbestandteile.
Vor dem Entfernen von Tests oder Prüfergebnissen sollen Teams prüfen, ob andere Dateien darauf verweisen und ob ein Ergebnis die einzige belastbare Aufzeichnung eines Laufs ist. Ein zusammenfassender Bericht ersetzt nicht zwingend einen ungekürzten Originalnachweis. Ebenso sollen Tests nicht aus einer Sprache oder einem Paket herausgelöst werden, wenn sie dafür interne, nicht öffentlich zugängliche Bestandteile benötigen: Der Entwurf lehnt Änderungen ab, die nur dazu dienen, solche Interna nach außen freizugeben oder Testaussagen abzuschwächen.
Was „Plan“ und „Act“ aussagen – und was nicht
Bei Cline trennt die Produktdokumentation Plan und Act: Plan dient der Erkundung und Planung, Act der Umsetzung des Plans. 2 Eine weitere Dokumentationsseite nennt getrennte Ablageorte für Regeln und wiederverwendbare Skills.
3 Daraus folgt aber nicht automatisch, dass jede Installation Regeln gleich lädt oder in jedem Kontext dieselben Ausführungsrechte hat. Der Entwurf fordert deshalb, Version, tatsächliche Schnittstellen und Berechtigungen in der konkreten Entwicklungsumgebung zu prüfen.
Auch ein Wechsel in einen Umsetzungsmodus soll nicht als pauschale Freigabe gelten. Vorgesehen ist, Änderungen an einen genehmigten Plan, eine klar begrenzte Arbeitsphase und einen konkreten Schreibumfang zu binden. Ob und wie sich das technisch zuverlässig durchsetzen lässt, bleibt Teil einer späteren Prüfung.
Eine Methode aus der Migration nicht verallgemeinern
Der Entwurf grenzt sich außerdem gegen die Idee ab, bestehende Tests grundsätzlich in Spezifikationen umzuwandeln und dadurch laufende Regressionstests entbehrlich zu machen. Geoffrey Huntley beschreibt eine solche Verdichtung im Zusammenhang mit der Portierung von Software zwischen Programmiersprachen. 7 Der Governance-Vorschlag behandelt das als Ansatz für diesen speziellen Kontext – nicht als allgemeine Empfehlung, alltägliche Tests zu löschen.
Noch keine Migration beschlossen
Vorgesehen ist ein stufenweises Vorgehen: erst Berechtigungen, betroffene Dateien, Verweise und den Wert vorhandener Prüfnachweise klären; danach gegebenenfalls Teile übernehmen und ihre Einbindung prüfen. Wenn dabei Tests verloren gehen, Verweise brechen oder eine Entwicklungsumgebung die nötigen Regeln nicht lädt, soll die jeweilige Änderung gestoppt werden, statt die Abnahmekriterien abzusenken.
Das ist vorerst eine Leitlinie, kein Bericht über eine abgeschlossene Umstellung. Der Entwurf hält ausdrücklich fest, dass in dieser Runde nichts migriert, getestet, angenommen oder archiviert wurde. Bevor die Umsetzung beginnt, sollen ein unabhängiger Arbeitsplan und die tatsächlich verfügbaren Berechtigungen geklärt werden.
Studio Global AI
Setzen Sie Ihre Recherche fort
Diese Seite enthält eine quellengestützte Antwort, die Sie in Studio Global fortsetzen können.
Die Leute fragen auch
Wie lautet die kurze Antwort auf „Warum KI-Coding-Agenten klare Regeln für Tests und Dateien brauchen“?
Der Entwurf will Projektnavigation, fachliche Spezifikationen, Architekturentscheidungen und Arbeitspläne klarer voneinander trennen.
Was sind die wichtigsten Punkte, die zuerst validiert werden müssen?
Der Entwurf will Projektnavigation, fachliche Spezifikationen, Architekturentscheidungen und Arbeitspläne klarer voneinander trennen. Dauerhafte Regressionstests sollen erhalten bleiben; temporäre Prüfergebnisse und Testcode werden unterschiedlich behandelt.
Was soll ich als nächstes in der Praxis tun?
Die Vorschläge sind noch nicht umgesetzt: Der ADR Entwurf hat den Status „PROPOSED“, und eine ältere Aufgabe bleibt blockiert.