Skip to content
← 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_001_<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üncel 7.x paketi varsayılan olarak v7 planları oluşturur. Mevcut planlar kayıtlı nesillerini korur; geçiş açık bir istek gerektirir. Yeni planlara en az üç basamaklı, monoton artan sayısal kimlikler verilir (örneğin PLAN_001_add_payment_webhooks/). Dondurulmuş v5 şemaları sayısal kimliği bir sözcük saydığı için v5 slug’ları 2–4, v7 slug’ları ise v6’daki gibi 2–5 sözcük içerir. Mevcut numarasız PLAN_<slug>/ klasörleri okunabilir kalır ve hiçbir zaman yeniden adlandırılmaz. Numaralı planlar varsa latest, sayısal kimliği en yüksek olan planı gösterir.

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.