Bulut ajanları adaptörü

Bulut ve arka plan ajanları — Claude Code uzak görevleri, OpenAI Codex cloud, Jules-class ajanlar ve benzer asenkron yürütme ortamları — tasarım gereği geçicidir: bir oturum başlar, sınırlı bir süre çalışır ve sona erer. DWP, kalıcı yapıyı oturum değil plan yaparak bu kısıtlamayı bir avantaja dönüştürür.

Temel kavrayış

Deponun .dwp/ dizini, kalıcı spec ve durum katmanıdır. Bulut oturumları ise geçici yürütücülerdir. Plan, yürütücüye ne yapılacağını söyler; state.json nereden devam edeceğini söyler. Oturum herhangi bir şey olabilir — farklı bir model, farklı bir sağlayıcı, yeni bir konteyner — ve plan tam kaldığı yerden devam eder.

Destek düzeyi

Tam (Belgelenmiş) — bulut ajan platformları AGENTS.md veya yerel talimatları okur ve komutları terminal veya konteyner ortamları üzerinden yürütür.

Uyan-devam et-ver döngüsü

Her bulut ajanı dönüşü şu kalıbı izler:

Uyan — oturum başlar (bir cron zamanlaması, bir CI olayı veya kullanıcı eylemi tarafından tetiklenir).
DWP Sürdürme Protokolünü Çalıştırın — plan README dosyasını okuyun, kontrol noktasını bulun, journal.ndjson dosyasından ledger.py project aracılığıyla durumu yeniden oluşturun, dikişi inceleyin, duman testi çalıştırın. Bkz. DWP belirtimi.
Engellenmiş durumu kontrol et — state.json.blocked ayarlıysa, nedeni raporla ve yürütmeden ver.
Sonraki atomik görevi yürüt — bir görev, tam doğrulama kapısını geçerek.
Günlüğe kaydedin — ledger.py eylemleri (start, gate, complete) aracılığıyla journal.ndjson dosyasına olayları ekleyin; ledger.py project türetilmiş state.json anlık görüntü projeksiyonunu atomik olarak günceller. Eski v5 planlarında doğrudan durum dosyası güncellemesi korunur.
Ver — oturum temiz bir şekilde sona erer; sonraki dönüş güncellenmiş durumdan devam eder.

Gereksinimler

Plan, makine tarafından okunabilir durum katmanını (manifest.json + state.json) TAŞIMAK ZORUNDADIR. Onsuz, geçici bir oturumun devam pozisyonunu güvenilir biçimde belirleyecek yolu yoktur. Bkz. Plan durumu.
Plan, herhangi bir gözetimsiz bulut dönüşünden önce bir insan tarafından onaylanmış OLMALIDIR. Plan onayı, kontrol noktasıdır.
Ajan sınırlı yetki altında çalışır: kapsamı GENİŞLETMEMELİ, planın açıkça yetkilendirmediği yıkıcı işlemler GERÇEKLEŞTİRMEMELİ ve mevcut görevin talimatlarının ötesinde DOĞAÇLAMA YAPMAMALIDIR. Bkz. Ajan protokolü.

Notlar

Bulut ajanı oturumları, gözetimsiz yürütme profilinin aşırı durumudur: sıfır oturum sürekliliği, maksimum plan kalıcılığı. DWP’nin .dwp/ dizini özellikle bunu çalıştırmak için tasarlanmıştır — bir ajanın taze bir checkout’tan bir çalışma grubunu başlatmak, sürdürmek ve tamamlamak için ihtiyaç duyduğu tüm durum, herhangi bir oturumun okuyabileceği düz Markdown ve JSON dosyalarında yaşar.