Verwende diese Fähigkeit, wenn eine Aufgabe in einen Plan umgewandelt werden muss, bevor jemand mit der Umsetzung beginnt. Sie ist der vorgelagerte Partner von apw-implement und der nachgelagerte Abnehmer von apw-research / apw-brainstorm: Sie nimmt eine vage Aufgabenbeschreibung (sowie etwaige Dokumente oder vorhandene Artefakte) und erstellt langlebige Planungsdokumente, die für die Implementierung verbindlich sind. Sie existiert, um zwei Fehlern entgegenzuwirken: dem direkten Einstieg in den Code mit einem nur im flüchtigen Kontext gehaltenen Plan – wodurch Schritte übersprungen werden und die Arbeit von der ursprünglichen Anforderung abweicht – und der Erstellung eines Plans, der den Bezug zu den Anforderungen verliert, die er erfüllen sollte. Befolge die untenstehenden Schritte strikt und in der angegebenen Reihenfolge.
Ausgabestil
Wenn diese Fähigkeit nach einem Plan, Bericht, einer Zusammenfassung, einem Statusupdate oder einer anderen chat-orientierten Ausgabe fragt, bevorzuge Aufzählungspunkte oder nummerierte Listen gegenüber einfachen Absätzen. Halte jeden Punkt prägnant und aussagekräftig. Vermeide Formulierungen, die nur den Ton glätten, Kontext wiederholen oder „sprachliche Füllmittel“ hinzufügen, ohne die Bedeutung zu verändern.
Schritt 1 – Die Eingaben aufnehmen
Bevor du einen Plan erstellst, lies alles, was die Aufgabe definiert:
- Die Aufgabenbeschreibung – die Aufgabenbeschreibung, der Ticket oder die Anfrage, wie gegeben.
- Bereitgestelltes Material – alle Dokumente, Spezifikationen, Entwürfe oder Referenzen, die damit eingereicht wurden.
- Vorhandene Artefakte – wenn dein Arbeitspaket
research.md- oderbrainstorm.md-Artefakte enthält (sieheapw-work-with-work-item-artifactsfür deren Speicherort), baut der Plan darauf auf, er wiederholt deren Arbeit nicht. - Die Codebasis – die Dateien, Module und Konventionen, die die Arbeit berührt, damit der Plan zur Realität passt und nicht zu einer vorgestellten Architektur.
Überspringe diesen Schritt nicht, selbst wenn die Aufgabe klein erscheint. Ein Plan ist nur so gut wie das Bild, das dahintersteht.
Schritt 2 – Dein Verständnis darlegen, fragen und die Tiefe wählen
Formuliere zunächst eine prägnante Aussage darüber, was deiner Meinung nach getan werden muss – das Ziel, den von dir verstandenen Umfang und die Hauptaufgaben. Dies gibt dem Benutzer etwas Konkretes, das er korrigieren kann, bevor ein Dokument geschrieben wird.
Formuliere dann in derselben Runde:
- Stelle bis zu 5 Hauptfragen – nur echte Unklarheiten, die den Plan verändern würden. Überspringe Fragen, die du bereits aus Schritt 1 beantworten kannst. Frage nicht um des Fragens willen.
- Frage, welche Dokumenttiefe erstellt werden soll (verwende das AskUserQuestion-Tool):
- VOLLSTÄNDIG –
requirements.md+design.md+plan.md. Für größere oder folgenreichere Arbeiten, bei denen sowohl das Was als auch das Wie vor jedem Code festgelegt werden sollten. - MITTEL –
design.md+plan.md. Wenn die Anforderungen bereits klar sind (oder vorgelagert erfasst wurden), aber der technische/UI-Ansatz noch entschieden werden muss. - PLAN –
plan.mdnur. Für gut verstandene Arbeiten, die nur in geordnete, überprüfbare Schritte zerlegt werden müssen.
- VOLLSTÄNDIG –
Warte auf die Antworten des Benutzers und seine Wahl der Tiefe, bevor du etwas erstellst.
Schritt 3 – Die Artefakte erstellen und bestätigen, eines nach dem anderen
Schreibe die Dokumente (requirements.md, design.md, plan.md) in den Artefaktordner deines Arbeitspakets – siehe apw-work-with-work-item-artifacts für den Speicherort der Arbeitspaket-Artefakte.
Erstelle die Dokumente nacheinander, in der Reihenfolge ihrer Abhängigkeiten – niemals alle auf einmal. Halte nach dem Schreiben jedes Artefakts inne: Teile dem Benutzer mit, dass es bereit ist (mit seinem Pfad) und füge eine ein- bis zweizeilige Zusammenfassung seines Inhalts hinzu. Warte dann auf die Überprüfung durch den Benutzer. Der Benutzer:
- stimmt zu → fahre mit dem nächsten Artefakt fort, oder
- fordert Änderungen an → überarbeite dieses Artefakt und präsentiere es erneut, wiederhole dies, bis der Benutzer zustimmt.
Baue das nächste Artefakt nur auf einem bestätigten vorherigen auf – das Design darf erst geschrieben werden, wenn die Anforderungen genehmigt sind, und der Plan darf erst geschrieben werden, wenn das Design (und die Anforderungen) genehmigt sind. Diese Reihenfolge ist der Kern: Spätere Dokumente verweisen auf die IDs der früheren, sodass jede Hürde verhindert, dass das nächste Dokument auf etwas aufbaut, das der Benutzer gerade ändern wollte.
Die Reihenfolge hängt von der in Schritt 2 gewählten Tiefe ab:
- VOLLSTÄNDIG →
requirements.md→ Überprüfung →design.md→ Überprüfung →plan.md→ Überprüfung - MITTEL →
design.md→ Überprüfung →plan.md→ Überprüfung - PLAN →
plan.md→ Überprüfung
Jedes Dokument unter Verwendung der Vorlagen in diesem Fähigkeitenordner:
requirements.md(nur VOLLSTÄNDIG) –REQUIREMENTS_TEMPLATE.md. Gib jeder Anforderung eine stabile ID (R1, R2, …), damit das Design und der Plan darauf verweisen können. IDs dürfen sich nach der Vergabe nicht ändern.design.md(VOLLSTÄNDIG und MITTEL) –DESIGN_TEMPLATE.md. Deckt technisches Design (die wichtigsten technischen Entscheidungen, wie die Teile zusammenpassen, was verworfen wurde) und – nur wenn die Aufgabe eine benutzerseitige Oberfläche hat – UI-Design als ASCII-Mockups ab. Gib jeder Designentscheidung eine stabile ID (D1, D2, …) und verknüpfe sie mit der/den Anforderung(en), die sie erfüllt. Lösche den UI-Abschnitt, wenn es keine UI gibt.plan.md(alle Tiefen) –PLAN_TEMPLATE.md. Die geordnete Liste der Teilaufgaben. Regeln:- Jede Teilaufgabe ist ein Kontrollkästchen:
- [ ], bleibt ungeprüft. Das Kästchen ist für den implementierenden Agenten, um es abzuhaken (- [x]), während er diese Aufgabe erledigt – es ist der Übergabemechanismus anapw-implement. - In VOLLSTÄNDIG/MITTEL benennt jede Aufgabe, was sie implementiert –
(implementiert: R2, D1). Ein Plan, der nicht auf die Anforderungen/das Design zurückverfolgt werden kann, aus denen er entstanden ist, ist genau die Art von Abweichung, die diese Fähigkeit verhindern soll. In der PLAN-Tiefe gibt es keine vorgelagerten Dokumente, also lass die Verweise weg und halte jede Aufgabe in sich abgeschlossen. - Jede Aufgabe ist konkret und unabhängig überprüfbar, mit einem „erledigt, wenn“-Abnahmevermerk.
- Ordne Aufgaben so an, dass Abhängigkeiten zuerst kommen; gruppiere sie in Phasen, wenn die Arbeit umfangreich ist.
- Jede Teilaufgabe ist ein Kontrollkästchen:
Schritt 4 – Konflikte aufdecken
Wenn du während der Planung feststellst, dass die Eingaben einander widersprechen, eine Anforderung unmöglich ist, wie angegeben, oder der Umfang wesentlich größer ist als die Aufgabenbeschreibung vermuten ließ – halte inne und teile dies dem Benutzer mit. Formuliere die Aufgabe gemeinsam neu, anstatt einen selbstbewussten, gut strukturierten Plan für das falsche Problem zu schreiben.
Schritt 5 – Prägnante Zusammenfassung
Jedes Artefakt wurde bereits in Schritt 3 einzeln überprüft und genehmigt, daher ist dies eine kurze abschließende Zusammenfassung, nicht die erste Gelegenheit, Einwände zu erheben. Halte den Chat kurz – die Details leben in den Artefakten. Berichte nur:
- Die gewählte Tiefe und die Pfade zu allen geschriebenen Dokumenten.
- Die Form des Plans in ein bis zwei Zeilen – Phasenanzahl, Aufgabenzahl, die Grundstruktur des Vorgehens.
Bestätige dann, dass der Plan bereit ist, an apw-implement übergeben zu werden, und biete einen letzten Blick an, falls sich im Gesamtset noch etwas ändern sollte, jetzt wo alles zusammen sichtbar ist.