Claude Code
TamYerel WebFetch ve eğik çizgi komutlarıyla referans uygulama.
Açık metodoloji · MIT · Ajandan bağımsız
Deep Work Plan, herhangi bir depoyu yapılandırılmış bir ortama dönüştürür — bağlam, koruma bariyerleri ve kalıcı bir plan — herhangi bir kodlama ajanı burada hassas ve verimli çalışır ve uzun soluklu işi tamamlar.
init.md istemini kopyalayıp kodlama ajanınıza — Claude Code, Cursor, Codex veya herhangi bir diğeri — yapıştırarak herhangi bir depoyu AI-first hale getirin.
Deep Work Plan, deponun kendisinin harness haline geldiği spec odaklı geliştirmedir.
Sorun ve çözüm
Kısa hamlelerde kodlama ajanları etkileyicidir. Ona uzun soluklu bir misyon verin — bir göç, yeni bir alt sistem, onlarca dosyayı kapsayan bir yeniden yapılandırma — ve ajan sapar: bağlam dolar, önceki kararlar solur ve saatler süren iş yarı yolda kalır.
Deep Work Plan , spesifikasyon odaklı geliştirme ile yanıt verir: dayanıklı bir plan, atomik görevler ve ajanın geçmesi gereken doğrulama kapıları. "Bitti" bir his olmaktan çıkar — geçerlenebilir, gözden geçirilebilir kanıta dönüşür.
Ve bağlam, ajanınızın en kıt kaynağıdır. Bu yüzden harness, kendi talimat yükünü küçük ve denetlenebilir tutmak için tasarlandı: talimatlar aşamalı yüklenir, doğrulama yalnızca değişene dokunur ve her görev kendi yerinde öğrenir. Her akışın yükü bayt cinsinden ölçülür ve her yayında yayımlanır — son yayında yürütme akışı yüzde 45,7, sürdürme akışı yüzde 67,5 küçüldü. Planın kendisi de aynı şekilde ölçeklenir: sınırlı bir düzeltme için Lite plan, saatler süren bir iş için Full plan — biçim her zaman işin kapsamını izler, tam tersi değil.
Neyin bitti sayılacağına ve sınırların nerede olacağına siz karar verirsiniz. Plan niyetinizi taşır; ajanlar saatleri çalışır — sürekli gözetim yok, yirmi dakikada bir düzeltme yok.
Metodolojiyi okuyun →
İnsanlar dümen tutar. Ajanlar yürütür.
Uzun görevler her modelin bağlamını doldurur. Ayrıntılar kayar ve ajan saptar. Yazılı bir plan — atomik görevler, doğrulama kapıları, sürdürülebilir durum — her turda geri döndüğü çıpadır.
Çekirdek döngüyü görün →
Ajanların sapamayacağı bir plan.
Her görev, kabul kriterlerini ve geçmesi gereken kontrolleri adlandırır. Ajan kendini bitmiş hissedemez — geçmek zorundadır, aksi hâlde görev açık kalır.
Şartnamayı okuyun →
Bitti bir sözleşmedir, bir his değil.
Bağlam, araçlar, koruma bariyerleri ve durum; herhangi bir ajanın okuyabileceği düz dosyalar olarak deponuzda yaşar. Kilitlenme yok, dış beyin yok — bağlam sıfırlamalarını atlatır.
Onboarding çıktısını görün →
Depo, harness’tir.
Bağlam, ajanınızın en kıt kaynağıdır. Harness aşamalı yüklenir, yalnızca değişeni doğrular ve görev başına öğrenir — her akışın talimat yükü ölçülüp yayımlanır, yayın üstüne yayın.
Metodolojiyi okuyun →
Her token önemlidir.
Akıl yürütmeye dayalı kuruluma alma
Kuruluma alma akışı, deponuzun gerçek dillerini, çerçevelerini, paket yöneticisini ve doğrulama komutlarını inceler, ardından o depoya uyarlanmış çıktılar üretir. Genel bir taslak başarısızlık sayılır.
Manifest dosyalarını, klasör düzenini ve CI yapılandırmasını okuyarak gerçek test, lint ve derleme komutlarını çıkarsar, ardından depoyu bireysel bir depo veya bir orkestratör merkezi olarak sınıflandırır.
Akıl yürütülmüş bir AGENTS.md, kategorize edilmiş bir docs/ hiyerarşisi ve her büyük modülün içinde bir README ile docs/ — yer tutucularla değil, deponuzun gerçek komutlarıyla doldurulmuş olarak.
Ajandan bağımsız bir .agents/ dizini (skill’ler, ajanlar, komutlar) ve .claude ile .cursor → .agents sembolik bağları, CLAUDE.md’yi AGENTS.md’ye yansıtır; böylece her araç tek bir doğruluk kaynağını okur.
Deep Work Plan skill’ini bağlar ve planlar için gitignore’lanmış .dwp/ klasörünü oluşturur, zorunlu AI Diff Reviewer yerel incelemesini kurar, ardından isteğe bağlı olarak devcontainer desteği gibi tercihe dayalı eklentileri katmanlar.
Çalıştırdığınızda ne olur
Bir kurulum yöntemi seçmez ya da bir şablon kopyalamazsınız. Ajanınıza tek bir satır verirsiniz; o da skill’i — yeniden kullanılabilir motoru — kurar ve deponuzu ona uyarlar.
deepworkplan.com/init.md adresindeki kuruluma alma istemini ve bağlantı verdiği metodolojiyi, spesifikasyonu ve kiti — yani benimsemek üzere olduğu standardı — okur.
Skill, motordur — her depoda aynıdır. Tek bir komut, yönlendiriciyi ve alt skill’lerini (create, execute, refine, resume, status, verify, onboard, author, upgrade) Claude Code, Cursor, Codex, Gemini ve Copilot için getirir.
Gerçek yığınınız hakkında akıl yürüterek — asla kopyala-yapıştır yapmadan — AGENTS.md, kategorize edilmiş bir docs/ ağacı, modül başına README’ler, akıl yürütülmüş bir .agents/ kiti ve gitignore’lanmış bir .dwp/ yazar. Deponuz harness haline gelir.
Herhangi bir görev için uzun soluklu Deep Work Plan’ler üretin ve bunları adım adım çalıştırın; açık kabul kriterleri, doğrulama kapıları ve sürdürülebilir durumla — saatlerce otonom biçimde.
Skill her yerde aynı şekilde kurulur; uyarlanan şey deponuzdur — yığınınız için üretilen AGENTS.md, dokümanlar ve akıl yürütülmüş .agents/ kiti. Bu ayrım, metodolojiyi tek seferlik bir iskele yerine yeniden kullanılabilir bir standart yapan şeydir.
Elde ettikleriniz
Tek bir çalıştırma, atomik olarak işlenir. Her çıktı Markdown’dır ve her değişiklik denetlenebilir.
Yer tutuculu bir şablon değil, deponuzun gerçek yığını, komutları ve yapısı üzerinden akıl yürütülerek hazırlanır. CLAUDE.md, AGENTS.md’ye sembolik olarak bağlanır.
Mimari, kurulum, standartlar ve sorun giderme — ayrıca her büyük modülün içinde, kod tabanınızdan üretilmiş bir README ve docs/.
Ajandan bağımsız bir .agents/ dizini (skill’ler, ajanlar, komutlar) ve .claude ile .cursor → .agents sembolik bağları; böylece her araç tek bir doğruluk kaynağını okur.
create, execute, refine, resume, status, verify, onboard, author ve upgrade — ajanınıza tek bir skill paketi olarak, depo başına kopya olmadan sunulur.
/dwp-verify, spesifikasyona karşı nesnel bir geçti/kaldı raporu üretir; böylece “AI-first” iddia edilmez, doğrulanır — ve her plandan sonra yeniden doğrulanabilir.
Kuruluma alma, deponuzu bireysel bir depo (yaygın durum) veya depolar arasında alt planları koordine eden bir orkestratör merkezi olarak sınıflandırır.
author alt skill’i (skill-create, agent-create), deponun kendi skill’lerini, ajanlarını ve komutlarını geliştirmesini sağlar; dependency-upgrade gibi tercihe dayalı bakım eklentileri, kendini güncel tutmasına yardım eder.
Daemon yok, harici durum yok. Planlar gitignore’lanmış bir .dwp/ klasörüne iner ve herhangi bir görev — bağlam taştıktan sonra bile — yalnızca git üzerinden kaldığı yerden sürdürülür.
Ajanlar
Tek metodoloji, birçok adaptör. Markdown, çerçeveyi hiçbir şeye bağlamaz — Markdown okuyan her ajan bir Deep Work Plan çalıştırabilir.
Yerel WebFetch ve eğik çizgi komutlarıyla referans uygulama.
Tam adaptör. WebFetch kısıtlıysa çevrimdışı paketi kullanın.
Çevrimdışı paket önerilir; kurallar .codex/ altına kurulur.
Tam adaptör — dwp-* komutları AGENTS.md ve # prosedürleri aracılığıyla çalışır.
Yerel WebFetch ile Gemini 2.5 Pro veya daha yenisini gerektirir.
Açık kaynak. AGENTS.md'yi yerel olarak okur ve dwp-* komutlarını # ile çalıştırır.
Kurallar ve # komut prosedürleri eksiksiz Deep Work Plan döngüsünü yürütür.
Açık kaynak. Markdown kuralları ve # komutları her dwp-* adımını çalıştırır.
Yerel bir komut yüzeyine sahip tam adaptör.
Yığınlar
Bunlar şablon değil, akıl yürütme yardımcılarıdır. Kuruluma alma, deponuzun gerçek manifest dosyalarını okur ve yığın başına uyarlar — bir hazır ayarı asla körlemesine kopyalamaz. Monorepo’lar modül başına doküman alır.
İki arketip
Kuruluma alma, arketipe göre ayrışır. Çoğu depo bireysel depodur. Bir merkez, birçok depo arasında alt Deep Work Plan’leri koordine eder. Metodoloji her ikisini de birinci sınıf olarak ele alır.
Bireysel depo
kendi kendine yeten tek bir kod tabanı
Orkestratör merkezi
alt depoları koordine eder
Tek bir birincil yığına, kendi doğrulama komutlarına ve modül başına dokümanlara sahip tek bir kod tabanı. Varsayılan budur — depo açıkça bir merkez olmadıkça kuruluma alma bunu varsayar.
Örneğin bir Django API’si, bir Vue uygulaması veya bir TypeScript Lambda servisi.
Bir orkestratör manifesti aracılığıyla alt depolar arasındaki işi orkestre eden, her biri kendi deposunda işlenen alt planlar başlatan, ayrıca sınır kuralları ve bir gezinme dizinine sahip bir koordinasyon deposu.
Örneğin beş ürün deposunu koordine eden bir merkez.
Metodoloji ile araç karşılaştırması
Deep Work Plan başka bir iskele aracı değildir. Herhangi bir spec odaklı ya da iskele aracının altındaki metodoloji katmanıdır ve çok saatlik otonom çalıştırmalara odaklanır.
| Metodoloji ile araç karşılaştırması | Deep Work Plan | İskele / spec araçları |
|---|---|---|
| Birincil odak | Çok saatlik otonom yürütme | Spec veya iskele üretimi |
| İş birimi | Bir Deep Work Plan (sürdürülebilir oturum) | Bir spec belgesi veya bir iskele |
| Durum modeli | Git-native .dwp/ klasörü, sürdürülebilir | Çoğunlukla harici veya IDE içinde |
| Ajan bağlılığı | Ajandan bağımsız (Markdown ve Bash) | Çoğunlukla araca veya IDE’ye özgü |
| Bağlam kurtarma | Bağlam taşmasından sonra kaldığı yerden sürdürür | Genellikle görevi yeniden başlatır |
| Lisans | MIT, açık metodoloji ve kit | Değişir |
Köken
Dağıtık ekipler için asenkron standup’ların arkasındaki şirket olan Dailybot tarafından geliştirildi. Şirket içinde, Django, Vue, TypeScript Lambda ve Astro’ya yayılan üretim depolarını ajan-pilotlanabilir hale getirmek için Deep Work Plan’leri kullandık. Aylarca süren üretim kullanımının ardından metodolojiyi MIT lisansıyla açık kaynak yaptık.
Deponuzu AI-first hale getirin
Ajanınıza tek bir satır verin — onu /init.md adresine yönlendirin — ve deponuzu AI-first hale getirsin: skill’i kurar, yığınınız hakkında akıl yürütür ve eksiksiz bir AGENTS.md hiyerarşisini işler. Oradan, saatlerce otonom çalışan Deep Work Plan’ler oluşturur ve yürütürsünüz.
Ajanlar ve geliştiriciler içinMIT lisanslı · sıfır telemetri · çıktılar gitignore’lanmış bir .dwp/ klasörüne yazılır.