Spezifikationen geben Kontext
Spezifikationen halten Absichten fest. Nutze sie, um Aufgaben zu formulieren, Kontext auszuwählen und die entstehenden Änderungen zu prüfen.
Dieser Artikel beschreibt die Arbeitsweise hinter Agent Studio: Umfang, Prüfungen und menschliche Entscheidungen bleiben neben den Spezifikationen sichtbar. Er ist keine Funktionsprüfung eines anderen Produkts.
Absichten auffindbar festhalten
Eine Spezifikation beschreibt, was ein System tun soll oder warum eine Entscheidung getroffen wurde. Sie kann als Architekturentscheidung, Aufgabenbeschreibung, Betriebsanleitung oder Test vorliegen.
Diese Unterlagen beantworten unterschiedliche Fragen. Ein Test beschreibt das erwartete Verhalten in einem bestimmten Fall. Eine Architekturentscheidung erläutert eine Abwägung. Eine Aufgabe legt die nächste Änderung fest. Verknüpfe die Unterlagen, die für die aktuelle Arbeit relevant sind.
Produktentscheidungen ausdrücklich treffen
Ein Modell kann aus einer Spezifikation einen Plan vorschlagen. Ein Mensch muss weiterhin entscheiden, welche Arbeit beginnt, welche Vorgaben gelten und welches Ergebnis angenommen wird.
Halte diese Entscheidungen in Roadmap und Aufgaben fest. Entdeckt das Modell eine Lücke, kann es eine Klärung oder Folgeaufgabe mit Quellen vorschlagen. Prüfe den Vorschlag, bevor du den vereinbarten Umfang änderst.
Einen überprüfbaren Teil wählen
Eine umfassende Spezifikation kann eine ganze Funktion beschreiben, während die nächste Aufgabe nur einen Teil umsetzt. Wähle einen Teil mit beobachtbarem Ergebnis und einer klaren Prüfung.
Beginne zum Beispiel mit der Validierung eines Eingabepfads, bevor du alle Formulare änderst. Prüfe Verhalten und Schnittstelle und nutze das Ergebnis für die nächste Aufgabe. Auch ein kleiner Diff braucht passende Tests; seine Größe allein belegt keine Korrektheit.
Spezifikation und Review verbinden
Füge vor dem Lauf die relevanten Anforderungen und Entscheidungen zum Aufgabenkontext hinzu. Vergleiche im Review die gelieferten Änderungen und Prüfungen mit diesen Anforderungen. Halte Abweichungen als konkrete Befunde fest.
- Verlinke den zutreffenden Teil der Spezifikation.
- Beschreibe, was die Aufgabe ändern soll und was außerhalb ihres Umfangs liegt.
- Wähle Tests und weitere Prüfungen, die das erwartete Verhalten abdecken.
- Aktualisiere Aufgabe oder Dokument, wenn das Review eine falsche Annahme zeigt.
Mit der Roadmap die nächste Aufgabe wählen
Eine Roadmap hält Richtung und Prioritäten fest. Forme einen gewählten Punkt zu einer Aufgabe, sobald Zeitpunkt, Umfang und Abhängigkeiten ausreichend geklärt sind.
Agenten können fehlenden Kontext erkennen, kleinere Aufgaben vorschlagen und Risiken untersuchen. Solche Vorschläge bereiten eine Entscheidung vor; sie legen nicht von sich aus eine neue Produktpriorität fest.
Den vollständigen Aufgabenablauf prüfen
Wenn du einen spezifikationsorientierten Editor oder ein anderes Coding-Werkzeug erwägst, erprobe deinen tatsächlichen Ablauf: Änderung vorbereiten, ausführen, Prüfungen ansehen und Annahme festhalten. Prüfe, an welcher Stelle Agent Studio eine hilfreiche Dokumentation oder Übergabe ergänzt.
Dieser Artikel belegt keine Funktionslücken bei Kiro oder einem anderen Produkt. Anbieterfunktionen ändern sich und brauchen eine eigene datierte Prüfung. Hier geht es darum, welche Arbeitsweise du nutzen möchtest.
Eine Anforderung mit einer prüfbaren Änderung verbinden
Wähle eine Anforderung aus einer vorhandenen Spezifikation. Erstelle eine abgegrenzte Aufgabe, verlinke den relevanten Kontext und benenne die Prüfungen. Halte nach dem Lauf fest, ob das Ergebnis die Anforderung erfüllt und was als Nächstes passieren soll.