Skip to content
Deep Work Plan ist heute auf Product Hunt Jetzt upvoten
← Alle Kapitel

Kapitel 03

Plan- und Aufgabenvorlagen

Ein Deep Work Plan ist ein Verzeichnis von Markdown-Dateien. Die Form dieses Verzeichnisses — und jeder Datei darin — ist das, was einen Plan sowohl für Menschen als auch für Agenten prüfbar macht.

Planstruktur

Ein Plan ist ein Verzeichnis unter .dwp/plans/ mit dem Namen PLAN_<slug>/. Es enthält:

  • README.md — die Planübersicht: Ziel, Quellmaterial, Aufgabentabelle und Status.
  • Eine Datei je Aufgabe, benannt <n>.task_<slug>.md.
  • PROGRESS.md — ein laufendes Protokoll der Ausführung.

Struktur der Aufgabendatei

Jede Aufgabendatei trägt den Namen <n>.task_<slug>.md und folgt der zehnteiligen Anatomie: Goal, Context, Touched Surface, Steps, Acceptance criteria, Validation, Files, Dependencies, Risks und Completion & Log. Die Abschnitte erscheinen stets in dieser Reihenfolge, sodass jeder Leser weiß, wo er nachschauen muss. Jede Aufgabe verankert sich vor dem Handeln erneut am Ziel des Plans, was einen Agenten daran hindert, über einen langen, mehrstündigen Horizont abzudriften.

Das Final Review

Jeder Plan muss mit genau einer verpflichtenden Aufgabe enden: dem Final Review. Es schließt den Plan in drei geordneten Durchgängen — nichts am Sicherheitstest wird abgeschwächt:

  1. Sicherheitstest — alles, was der Plan geändert hat, auf Geheimnisse, Injection-Risiken und neue Angriffsfläche prüfen und docs/SECURITY.md aktuell halten. Sicherheit ist kein separater Arbeitsstrang, der am Ende angeflanscht wird: Jeder Plan hinterlässt seine eigenen Änderungen auditiert, und ein kritischer Befund blockiert den Abschluss.
  2. Validierung des Endzustands — die vollständige Validierung des Repositorys läuft auf dem letzten relevanten Zustand und besteht, nach der finalen Korrektur.
  3. Abgleich der Skills — jede Aufgabe hat ihre eigene Skills-Disposition aufgezeichnet, während ihre Beweise frisch waren; das Review gleicht das Ledger ab. Der Executive Report bleibt auf Anfrage verfügbar.

README- und PROGRESS-Konventionen

Die Plan-README.md muss einen Titel (# Deep Work Plan: <name>), eine prosaische Zielformulierung, einen optionalen Abschnitt zum Quellmaterial, eine Aufgabentabelle (Nummer, Aufgabenname, Status-Checkbox) und eine Planstatus-Zeile in der Form <n>/<total> tasks complete enthalten.

PROGRESS.md ist ein reines Anhänge-Ausführungsprotokoll. Jeder Eintrag hält einen ISO-8601-Zeitstempel, die Aufgabennummer und den Aufgabennamen, was getan wurde sowie etwaige Abweichungen oder Übersprung-Gründe fest. Weil es nur jemals wächst, ist es eine zuverlässige Historie dessen, wie der Plan sich tatsächlich entfaltet hat.

Überschriften und Querverweise

Alle Überschriften verwenden Satzschreibweise (sentence case), und Dokumente vermeiden Marketing-Sprache und Ausrufezeichen. Diese Konventionen halten Pläne über Agenten hinweg und über die Zeit konsistent.