Skip to content
Deep Work Plan bugün Product Hunt’ta Oy ver
← Tüm bölümler

Bölüm 03

Plan ve görev şablonları

Bir Deep Work Plan, Markdown dosyalarından oluşan bir dizindir. O dizinin — ve içindeki her dosyanın — biçimi, bir planı hem insanlar hem de ajanlar tarafından gözden geçirilebilir kılan şeydir.

Plan yapısı

Bir plan, .dwp/plans/ altında PLAN_<slug>/ olarak adlandırılmış bir dizindir. Şunları içerir:

  • README.md — plan genel görünümü: hedef, kaynak materyal, görev tablosu ve durum.
  • Görev başına bir dosya, <n>.task_<slug>.md olarak adlandırılır.
  • PROGRESS.md — yürütmenin çalışan bir günlüğü.

Görev dosyası yapısı

Her görev dosyası <n>.task_<slug>.md olarak adlandırılır ve on bölümlü anatomiyi izler: Hedef, Bağlam, Dokunulan Yüzey, Adımlar, Kabul kriterleri, Doğrulama, Dosyalar, Bağımlılıklar, Riskler ve Tamamlama ve Günlük. Bölümler her zaman bu sırayla görünür; böylece her okuyucu nereye bakacağını bilir. Her görev, harekete geçmeden önce planın hedefine yeniden bağlanır; bu da bir ajanın uzun, çok saatlik bir ufukta yönünü kaybetmesini önler.

Final Review

Her plan, tam olarak tek bir zorunlu görevle bitmelidir: Final Review. Planı üç sıralı geçişle kapatır — güvenlik incelemesinde hiçbir şey gevşetilmez:

  1. Güvenlik incelemesi — planın değiştirdiği her şeyi sırlar, enjeksiyon riskleri ve yeni saldırı yüzeyi açısından denetler ve docs/SECURITY.md dosyasını güncel tutar. Güvenlik, sona iliştirilen ayrı bir iş kolu değildir: her plan kendi değişikliklerini denetlenmiş bırakır ve kritik bir bulgu tamamlanmayı engeller.
  2. Son-durum doğrulaması — deponun eksiksiz doğrulaması, son düzeltmeden sonra, son ilgili durum üzerinde çalışır ve geçer.
  3. Skill uzlaştırması — her görev, kendi skill kararını kanıtı tazeyken kaydetti; inceleme defteri uzlaştırır. Executive Report talep üzerine kullanılabilir kalır.

README ve PROGRESS kuralları

Plan README.md dosyası bir başlık (# Deep Work Plan: <name>), düzyazı bir hedef bildirimi, isteğe bağlı bir kaynak materyal bölümü, bir görev tablosu (numara, görev adı, durum onay kutusu) ve <n>/<total> tasks complete biçiminde bir plan-durum satırı içermelidir.

PROGRESS.md, yalnızca ekleme yapılan bir yürütme günlüğüdür. Her giriş, bir ISO 8601 zaman damgasını, görev numarasını ve adını, ne yapıldığını ve varsa sapmaları veya atlama nedenlerini kaydeder. Yalnızca büyüdüğü için, planın gerçekte nasıl ilerlediğine dair güvenilir bir geçmiştir.

Başlıklar ve çapraz referanslar

Tüm başlıklar cümle düzeninde yazılır ve belgeler pazarlama dilinden ve ünlem işaretlerinden kaçınır. Bu kurallar, planları ajanlar arasında ve zaman içinde tutarlı tutar.