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:

  • manifest.json — planın kimliği ve etkin sözleşmesine yönelik işaretçi, somutlaştırmada ilk yazılan.
  • contract.json — resmi yürütme sözleşmesi.
  • journal.ndjson — değişmez olay günlüğü.
  • state.json — journal üzerinden yansıtılan bir anlık görüntü, asla elle düzenlenmez.
  • README.md — plan genel görünümü: hedef, kaynak materyal, görev tablosu ve durum.
  • Görev dosyaları, <n>.task_<slug>.md olarak adlandırılır.
  • PROGRESS.md — yalnızca ekleme yapılan yürütme günlüğü.
  • analysis_results/ — analiz çıktıları, denetim raporları ve kanıtlar.

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 Çekirdek döngü içinde ayrıntıları verilen on bölümlü anatomiyi izler. Bölümler her zaman aynı sırada görünür; böylece okuyucu nereye bakacağını hemen bilir. Her görev, harekete geçmeden önce planın hedefine yeniden bağlanır; bu da ajanın uzun bir ufukta sapmasını önler.

Final Review

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

  1. Gerekli yerel incelemeyle güvenlik geçişi — planın değiştirdiği her şeyi sırlar, enjeksiyon riskleri ve yeni saldırı yüzeyi açısından denetleyin, docs/SECURITY.md dosyasını güncel tutun ve planın tüm kapsamı üzerinde gerekli yerel AI Diff Reviewer incelemesini çalıştırın (eksik bir incelemeci sessizce atlanmaz, local reviewer not installed bulgusu olarak kaydedilir). Kritik bir bulgu tamamlamayı engeller.
  2. Son durum doğrulaması — deponun tam test, linter ve tip denetim paketleri, son düzeltmeden sonra son durum üzerinde çalışır ve geçer.
  3. Yetenek kararlarının uzlaştırılması — her görevin yerel bir yetenek kararı kaydettiğini doğrular ve analysis_results/SKILLS_CANDIDATES.md içindeki adayları uzlaştırır.
  4. Belgelendirme uzlaştırması — davranış değiştiren her görevin dokunduğu yüzeyi belgeleyen kılavuzlarla (docs/TESTING_GUIDE.md, mimari, AGENTS.md) eşleştirir.
  5. Tamamlama — plan kayıtları birbiriyle uyumludur (görev listesi, ilerleme günlüğü ve v6 ile v7 planlarında journal türevli anlık görüntü ve makbuz); teslimatları, kanıtları ve sınırlamaları bildirin ve Executive Report’u bir kez sunun.

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.