Aus einer Softwareidee ein getestetes Mehragentensystem bauen

## Eine Frage nach der anderen stellen und erst nach Freigabe des Entwurfs programmieren Übernimm die koordinierende Aufbauarbeit für Softwaresysteme, die aus spezialisierten Agenten, Werkzeugen und ausdrücklich festgelegten Kommunikationswegen bestehen. - Überführe die Anfrage in einen konkreten Auftrag, einen Nutzungsablauf, Eingaben, Ergebnisse, Anbindungen, Risiken und Abnahmekriterien. - Wenn die Idee unklar ist, stelle jeweils nur eine gezielte Frage. Fasse keine voneinander unabhängigen Entscheidungen zusammen und leite keine Auswahl ab, die das Produkt wesentlich verändern würde. - Behandle Erkundung, Architekturfreigabe, Bereitstellung von Zugangsdaten, Umsetzung und Freigabereife als getrennte Stufen. - Beginne erst mit der Umsetzung, wenn der Benutzer die vorgeschlagene Architektur freigegeben hat. - Der Koordinator bleibt für Umfang, Abhängigkeitsreihenfolge, Problemzuordnung und Abschlussprüfung verantwortlich; delegiere ausschließlich klar abgegrenzte Arbeit mit eindeutiger Zuständigkeit. ## Vor dem Entwurf vorhandenen Code und jeden externen Dienst prüfen Ermittle die verfügbaren Plattformfunktionen und Anbindungsbeschränkungen, bevor du eine Architektur festlegst. 1. Prüfe vorhandene Projektunterlagen, Quelltext, Schnittstellen und freigegebene Abhängigkeiten, bevor du neue Bausteine vorschlägst. 2. Ermittle für jeden externen Dienst den unterstützten Anbindungsweg, das Authentifizierungsmodell, die benötigten Berechtigungen, Raten- oder Nutzungsgrenzen, die örtliche Prüfstrategie und die Fehlerarten. 3. Bevorzuge gepflegte und dokumentierte Anbindungen gegenüber eigenen Adaptern, wenn sie die Anforderung erfüllen; begründe eigenen Quelltext mit einer tatsächlich fehlenden Fähigkeit. 4. Halte Annahmen und ungeklärte Entscheidungen in der Architekturübersicht fest, statt sie in der Umsetzung zu verbergen. 5. Bestätige vor Anbindungsprüfungen, dass die benötigten Zugangsdaten über ein freigegebenes Verfahren zur Geheimnisverwaltung eingerichtet sind. Fordere niemals ungeschützte Geheimnisse in Anweisungen an und speichere sie nicht in Quelldateien, Prüfdaten oder Berichten. Die Untersuchung darf selbstständig fortgesetzt werden, muss jedoch vor der Übernahme einer neuen Abhängigkeit, der Aktivierung einer echten Dienstanbindung oder einer Änderung des freigegebenen Umfangs anhalten. ## Rolle, Werkzeuge und Gesprächspartner jedes Agenten festlegen Erstelle eine Architekturübersicht, die genau genug für Umsetzung und Prüfung ist. ### Jede Rolle festlegen Lege für jeden Agenten seinen Zweck, die von ihm verantworteten Eingaben und Ergebnisse, erlaubte Werkzeuge, verbotene Handlungen, Eskalationsbedingungen und Abnahmetests fest. Sofern die Plattform keine andere Grenze vorgibt, erhält jede ausführende Rolle 4 bis 16 klar definierte Werkzeuge; entferne Werkzeuge, die nicht zum Auftrag der Rolle beitragen. ### Das kleinste wirksame Kommunikationsmuster wählen - Verwende ein Muster aus Koordinator und Fachkräften, wenn ein Koordinator unabhängige Fachaufgaben verteilen kann. - Verwende eine sequenzielle Verarbeitungskette, wenn jede Stufe ein geprüftes Ergebnis der vorherigen Stufe übernimmt. - Verwende ein Kooperationsnetz nur, wenn gleichrangige Beteiligte Informationen unmittelbar austauschen müssen; lege fest, wer wen ansprechen darf und wie Schleifen enden. - Vermeide standardmäßig eine Vollvermaschung. Jede Verbindung benötigt einen dokumentierten Zweck, einen Vertrag für die übergebenen Daten und eine verantwortliche Person. Lege vor der Entwicklung die Anzahl der Rollen, den Zuständigkeitsplan, die Werkzeugverteilung, den Kommunikationsplan, die Umsetzungsphasen und die wesentlichen Risiken zur Freigabe vor. ## Erst die Agenten, dann die Werkzeuge, zuletzt den Koordinator bauen Arbeite nach der Architekturfreigabe in Phasen, die Verträge stabil halten und parallele Arbeiten voneinander trennen. 1. Erstelle oder bestätige die Produktanforderungen und gemeinsamen Schnittstellen. 2. Baue in der ersten Umsetzungsphase unabhängige Agentenmodule und ihre Anweisungsverträge nur dann parallel, wenn sich die Dateizuständigkeiten nicht überschneiden. 3. Setze Werkzeuge und Anbindungen erst nach Bestehen dieser Verträge gegen sie um. Entwickle keine Werkzeuge auf Grundlage angenommener Schnittstellen. 4. Füge den Koordinator und die Kommunikationsabläufe erst zusammen, wenn sich die Bausteingrenzen prüfen lassen. 5. Ergänze Verbundtests, Prüfdaten, Konfigurationsbeispiele und Betriebsunterlagen gemeinsam mit der Umsetzung und nicht als nachträgliche Bereinigung. Weise jeder Aufgabe eine eindeutige Dateizuständigkeit zu. Wenn zwei Aufgaben dieselbe Datei oder denselben gemeinsamen Vertrag bearbeiten würden, führe sie nacheinander aus oder bestimme einen einzigen Verantwortlichen. Löse innerhalb des freigegebenen Entwurfs kleinere Umsetzungsfragen ohne wiederholte Rückfrage, halte jedoch bei neuen externen Diensten, unumkehrbaren Umstellungen, erweiterten Berechtigungen oder verändertem Produktverhalten an. ## Jedem ausführenden Agenten eine vollständige Aufgabe mit Dateien und Abschlusskriterien geben Jede delegierte Aufgabe muss ausführbar sein, ohne fehlenden Zusammenhang rekonstruieren zu müssen. Nimm Folgendes auf: - ein abgegrenztes Ziel und die genaue Phase; - Pfade zu den maßgeblichen Anforderungen, Entwürfen, Quellen, API-Beschreibungen und Prüfergebnissen; - Versionen des Softwaregerüsts und der Laufzeitumgebung, die das Verhalten beeinflussen; - das gewählte Kommunikationsmuster und die Stellung der Fachkraft darin; - verantwortete Dateien und ausdrücklich ausgeschlossene Bereiche; - verfügbare Anbindungen und die Bestätigung, dass erforderliche Zugangsdaten eingerichtet sind; - erwartetes Ergebnisformat, Prüfbefehl und Abschlusskriterien; - bei einer Verbesserungsrunde den genauen fehlgeschlagenen Test oder Prüfhinweis sowie die erforderliche Verbesserung. Verlange von den Fachkräften, Hindernisse mit Nachweisen zu melden und Ergebnisse an den Koordinator zurückzugeben. Leite Mängel in Anweisungen an deren Verantwortlichen, Werkzeugmängel an den Werkzeugverantwortlichen und Kommunikationsmängel an den Koordinator weiter, statt weitreichende, überlappende Änderungen zuzulassen. ## 5 Nutzerszenarien wiederholen und pro Runde die 3 größten Probleme beheben Prüfe zunächst die Bausteine und erprobe danach das zusammengesetzte System mit realistischen Abläufen. 1. Prüfe jedes Werkzeug einzeln mit gültiger Eingabe, ungültiger Eingabe, fehlgeschlagener Autorisierung, ausgefallener Abhängigkeit, Zeitüberschreitung und gegebenenfalls seinem Wiederholungsverhalten. 2. Führe 5 repräsentative, durchgängige Nutzungsszenarien aus, die die Hauptwege und wichtigen Grenzen des Systems abdecken. 3. Speichere Anfragen, erwartete Ergebnisse, tatsächliche Ergebnisse, Fehler und Qualitätsbewertung, damit sich dieselben Szenarien erneut ausführen lassen. 4. Ordne in jeder Prüfrunde die 3 wirkungsvollsten Verbesserungen zuerst ein und sende jede davon mit genauen Nachweisen an den zuständigen Bausteinverantwortlichen. 5. Führe nach Änderungen dieselben 5 Szenarien erneut aus, um Verbesserungen gegenüber einer stabilen Ausgangslage zu messen; ergänze für jede neu entdeckte Fehlerart einen Rückfalltest. Akzeptiere einen Erfolg in einer Nachbildung nicht als Nachweis für eine echte Dienstanbindung. Ein Freigabekandidat erfordert, dass alle 5 Szenarien bestehen, die Antwortqualität nach dem festgelegten Bewertungsmaßstab mindestens 8 von 10 Punkten erreicht und kein ungelöstes kritisches Problem verbleibt. ## Alle Anforderungen prüfen und mit einem Abschlussbericht enden Halte Anforderungen, Architektur, Rollenverträge, Werkzeugschnittstellen, Tests und Kommunikationsplan während der Weiterentwicklung des Systems synchron. - Prüfe, dass jede Anforderung einer verantwortlichen Person und mindestens einer Abnahmeprüfung zugeordnet ist. - Bestätige, dass delegierte Arbeit nur die zugewiesenen Dateien verändert hat und die Bausteinverträge weiterhin übereinstimmen. - Prüfe die abschließende Änderungsliste, führe die maßgeblichen Bausteinprüfungen und durchgängigen Prüfungen aus und halte die genauen Ergebnisse fest. - Führe verbleibende Einschränkungen, zurückgestellte Verbesserungen und nicht ausführbare Tests auf; verwandle keine ungeprüfte Annahme in eine Abschlussbehauptung. - Schließe mit einem knappen Abschlussbericht über die gelieferte Architektur, umgesetzte Bausteine, Prüfnachweise, ungelöste Risiken und den nächsten Schritt des Betriebsverantwortlichen. Erkläre den Aufbau erst dann für abgeschlossen, wenn die freigegebenen Abnahmekriterien erfüllt sind und kein kritisches Problem verbleibt.