Communitygithub.com

APW-Plan (AgenticPW/AgenticPW)

Eine praktische Sammlung agentischer Praktiken und Workflows, einschließlich wiederverwendbarer Fähigkeiten, Befehle, Referenznotizen und grundlegender Wissensdokumente.

Was ist AgenticPW)?

Diese Fähigkeit (APW-Plan) ist der zentrale Baustein des AgenticPW-Workflows, der eine vage Aufgabenbeschreibung in präzise, umsetzbare Planungsdokumente umwandelt – bevor auch nur eine Zeile Code geschrieben wird. Sie dient als Gegenpol zu zwei typischen Fehlern: dem direkten Einstieg in den Code mit einem flüchtigen Plan, der schnell übersehene Schritte und ein Abdriften von der ursprünglichen Anforderung verursacht, sowie der Erstellung eines Plans, der den roten Faden der Ausgangsanforderungen verliert. Der Prozess ist streng sequenziell: Zuerst werden alle Eingaben (Aufgabenbeschreibung, bereitgestellte Materialien, bereits vorhandene Artefakte aus `apw-research` oder `apw-brainstorm` und der Codebase) aufgenommen. Dann formuliert die Fähigkeit ein Verständnis der Aufgabe, stellt gezielte Rückfragen und bietet dem Benutzer die Wahl zwischen drei Planungstiefen: FULL (Anforderungen + Design + Plan), MEDIUM (Design + Plan) oder PLAN (nur eine Aufgabenliste). Jedes Dokument wird nacheinander gemäß der gewählten Tiefe erstellt und erst nach expliziter Benutzerfreigabe weitergearbeitet. Die verwendeten Vorlagen (in den Ressourcen dieser Fähigkeit) gewährleisten, dass Anforderungen und Designentscheidungen stabile IDs erhalten, auf die der Plan explizit verweist. Konflikte oder unrealistische Anforderungen werden sofort gemeldet. Die Ausgabe ist für ein Tool wie Claude Code optimiert, das in Entwicklungsumgebungen arbeitet und Artefakte direkt in bestimmte Ordner schreiben kann.

Funktioniert mit~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add AgenticPW/AgenticPW

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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- oder brainstorm.md-Artefakte enthält (siehe apw-work-with-work-item-artifacts fü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.md nur. Für gut verstandene Arbeiten, die nur in geordnete, überprüfbare Schritte zerlegt werden müssen.

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 an apw-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.

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.

Verwandte Skills