Geliştiriciler ve yapay zeka ajanları için Deep Work Plan

Skill ile planlayın ve yürütün

Yukarıdaki API, bir ajanın bu siteyi okumasını sağlar. DWP skill'i ise bir ajanın metodolojiyi çalıştırmasını sağlayan şeydir — bir depoya bir kez kurulur ve bir yönlendirici ile dokuz alt skill getirir; bunlar eğik çizgi komutları olarak çağrılır (ya da isimle, eğik çizgiyi yakalayan ajanlar için — çoğu bunun yerine # kullanır, örn. #dwp-execute).

İki bağımsız seçim: biçim ve ne kadar inceleme istediğiniz

Her plan her eksenden bir değer seçer. Bunlar birbirinden bağımsızdır — bir Lite plan trust modunda çalışabilir, bir Full plan guided modunda çalışabilir ve her ikisi de biçimi değiştirmeden sonradan modu değiştirebilir.

Dokuz alt skill

Her alt skill, skill'i kuran deponun içinde bir eğik çizgi komutu olarak çağrılır — bu web sitesine karşı değil. Her biri için tam referans kit kataloğunda yer alır.

Onu çalıştırmanın iki yolu

Aynı skill, aynı dokuz komut — biçim ve inceleme modu işin büyüklüğü ve riskiyle değişir, araçla değil.

# A small, bounded fix: skip the review round, run it directly.
/dwp-create fix the flaky checkout test trust
/dwp-execute

# Long-horizon work with real stakes: review before anything runs.
/dwp-create migrate the billing service to the new payments API
# ...review the proposed plan, then:
/dwp-execute
# ...interrupted? pick up again, even in a fresh session:
/dwp-resume

Her planın çıktısı — manifesto, ilerleme günlüğü, görev kayıtları, kapı kanıtı — deponun kendi içinde gitignore edilmiş bir .dwp/ dizininde yaşar. Hiçbir şey deepworkplan.com'a gönderilmez ya da orada saklanmaz; skill hiçbir ağ çağrısı yapmaz.

Uç noktalar

Ajan API'sinin temel uç noktaları. Eksiksiz ve türlendirilmiş spesifikasyon — her işlem, parametre ve yanıt şeması — OpenAPI belgesinde yer alır.

Bilinmeyen /api/* yolları, çözüm ipucu içeren yapılandırılmış bir JSON hatası döndürür; asla bir HTML hata sayfası döndürmez.

Sürümleme ve kullanımdan kaldırma

Sürümlü JSON ailesi /api/v1/ altında yaşar — index, sections, pages ve health — ve sürümsüz kanonik yollar (/llms.txt, /{page}.md, /api/mcp) aynı v1 sözleşmesine aittir. Yıkıcı değişiklikler yalnızca yeni bir /api/v{N+1}/ ailesinde yayımlanır, asla v1 içinde olmaz. Bir uç nokta kullanımdan kaldırıldığında yanıtları Deprecation: true taşır ve kaldırılmadan en az 180 gün önce bir Sunset tarihi içerir; bir Link başlığı halefi gösterir.

İstek limitleri

/api/* yanıtları RFC 9331 istek limiti başlıklarını taşır — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset ve RateLimit-Policy — böylece ajanlar kendilerini gerçek zamanlı yavaşlatabilir; bir 429 yanıtı Retry-After ekler. Uygulama uçta elden geldiğince (best-effort) yapılır (ziyaretçi başına 60 saniyede 120 istek) ve erişim anonim kalır: anahtar yok, kayıt yok, kademe yok.

MCP sunucusu

Streamable HTTP üzerinden durumsuz bir Model Context Protocol sunucusu. Üç salt okunur araç: get_init_prompt, list_site_sections ve read_page. 2025-03-26 ve 2025-06-18 protokol sürümleri desteklenir; oturum gerekmez.

# 1. Initialize (no session needed — the server is stateless)
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

# 2. Discover the tools
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. Call one — read any page as source Markdown
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"read_page","arguments":{"path":"/init"}}}'

MCP manifestosu /.well-known/mcp.json adresinde, sunucu kartı ise /.well-known/mcp/server-card.json adresindedir. Claude, ChatGPT ve herhangi bir MCP istemcisi bu araçları doğal olarak çağırabilir.

Ajanlar için Markdown

İşlenen her sayfa, yerel kaynak Markdown olarak yayımlanır — bir HTML dönüşümü değildir. Markdown'ı herhangi bir sayfada URL son ekiyle açıkça ya da HTTP içerik müzakeresi yoluyla isteyin.

# Ask for Markdown on any URL (content negotiation)
curl -s https://deepworkplan.com/methodology \
  -H 'Accept: text/markdown'

# Or fetch the .md mirror directly — every page has one, in every language
curl -s https://deepworkplan.com/es/developers.md

İçerik müzakeresi, sitenin işlediği kaynağın aynısı olan kaynak Markdown'ı, istekte bulunduğunuz URL'nin dilinde döndürür.

Kit'i kurun

Deep Work Plan skill'i için resmî kurulum yolu — /init uç noktasının ajanlara verdiği komutla aynıdır. Skills uyumlu herhangi bir kodlama ajanıyla çalışır (Claude Code, Cursor, Codex, Gemini ve diğerleri).

# 1. Install the DWP skill — same command the /init endpoint gives agents
npx skills add DailybotHQ/deepworkplan-skill@latest

# 2. Official CLI — zero-dependency client over this API (Node >= 18),
#    prepared in the site repo's cli/ directory pending npm publication
deepworkplan init
deepworkplan read /es/developers

Skill, deponuzun içindeki .agents/skills/deepworkplan/ klasörüne yerleştirilir; böylece depoya dokunan her ajan aynı metodolojiyi paylaşır. Resmî deepworkplan CLI — aynı API üzerinde sıfır bağımlılıklı bir istemci (init, sections, read, open, mcp) — npm için hazırlandı ve yayımlanana kadar site deposunun cli/ dizininde durur.

Makine tarafından okunabilir kaynaklar

• ▸ OpenAPI spesifikasyonu (/openapi.json)
• ▸ Ajan erişimi ve kimlik doğrulama bildirimi (/auth.md)
• ▸ API kataloğu, RFC 9727 (/.well-known/api-catalog)
• ▸ MCP manifestosu (/.well-known/mcp.json)
• ▸ Güvenlik iletişim adresi (/.well-known/security.txt)
• ▸ Site depo tanımlayıcısı (/.well-known/dwp.json)

Bir ajanı yönlendirin

En hızlı yol hâlâ tek satırdır: herhangi bir kodlama ajanına /init istemini verin; skill'i kurar, deponuzu ajanlar için hazırlar ve derin işi bitirmeye koyulur.