Skip to content
Deep Work Plan jest dziś na Product Hunt Zagłosuj
← Wszystkie rozdziały

Rozdział 03

Szablony planu i zadań

Deep Work Plan to katalog plików Markdown. Kształt tego katalogu — i każdego pliku w nim — to właśnie to, co czyni plan podatnym na przegląd zarówno przez ludzi, jak i agentów.

Struktura planu

Plan to katalog w .dwp/plans/ o nazwie PLAN_<slug>/. Zawiera:

  • README.md — przegląd planu: cel, materiały źródłowe, tabelę zadań i status.
  • Jeden plik na zadanie, o nazwie <n>.task_<slug>.md.
  • PROGRESS.md — bieżący dziennik realizacji.

Struktura pliku zadania

Każdy plik zadania nosi nazwę <n>.task_<slug>.md i podąża za dziesięciosekcyjną anatomią: Cel, Kontekst, Powierzchnia dotknięta, Kroki, Kryteria akceptacji, Walidacja, Pliki, Zależności, Ryzyka oraz Ukończenie i dziennik. Sekcje zawsze pojawiają się w tej kolejności, więc każdy czytelnik wie, gdzie szukać. Każde zadanie ponownie zakotwicza się w celu planu, zanim zacznie działać, co chroni agenta przed dryfem na długim, wielogodzinnym dystansie.

Final Review

Każdy plan musi kończyć się dokładnie jednym obowiązkowym zadaniem: Final Review. Zamyka on plan w trzech uporządkowanych przebiegach — nic w przeglądzie bezpieczeństwa nie zostaje złagodzone:

  1. Przegląd bezpieczeństwa — przeprowadź audyt wszystkiego, co plan zmienił, pod kątem sekretów, ryzyk iniekcji i nowej powierzchni ataku, oraz utrzymuj docs/SECURITY.md w aktualności. Bezpieczeństwo nie jest osobnym strumieniem pracy doklejanym na końcu: każdy plan pozostawia własne zmiany poddane audytowi, a krytyczne znalezisko blokuje ukończenie.
  2. Walidacja stanu końcowego — pełna walidacja repozytorium uruchamia się i przechodzi na ostatnim istotnym stanie, po ostatniej poprawce.
  3. Uzgodnienie decyzji dotyczących skilli — każde zadanie zapisało własne rozstrzygnięcie dotyczące skilli, gdy dowody były świeże; przegląd uzgadnia ten rejestr. Raport wykonawczy pozostaje dostępny na życzenie.

Konwencje README i PROGRESS

Plik README.md planu musi zawierać tytuł (# Deep Work Plan: <name>), prozą zapisane sformułowanie celu, opcjonalną sekcję materiałów źródłowych, tabelę zadań (numer, nazwa zadania, pole statusu) oraz linię statusu planu w postaci <n>/<total> tasks complete.

PROGRESS.md to dziennik realizacji wyłącznie dopisywany. Każdy wpis zapisuje znacznik czasu ISO 8601, numer i nazwę zadania, co zostało zrobione oraz wszelkie odstępstwa lub powody pominięcia. Ponieważ wyłącznie rośnie, jest wiarygodną historią tego, jak plan faktycznie się rozwijał.

Nagłówki i odsyłacze

Wszystkie nagłówki używają zapisu zdaniowego, a dokumenty unikają języka marketingowego i wykrzykników. Konwencje te utrzymują spójność planów między agentami i w czasie.