Archetypes
Versi 1.1. DWP mengenali tiga arketipe. Arketipe menentukan cara sebuah agent meng-onboard, cara rencana ditetapkan lingkupnya, dan apakah lapisan status yang dapat dibaca mesin diwajibkan.
Tambahan di v1.1. Ruang kerja agent (§3) bergabung sebagai arketipe ketiga: rumah long-lived dari sebuah agent otonom. Git menjadi RECOMMENDED daripada diasumsikan. Dua arketipe v1.0 tidak berubah.
Repositori individual
Sebuah basis kode yang mandiri — sebuah aplikasi, sebuah pustaka, atau sebuah layanan. Rencana beroperasi langsung pada kode.
Karakteristik:
- Satu basis kode yang koheren.
- Rencana memodifikasi berkas di repositori ini.
- Ruang kerja
.dwp/di akar repositori.
Orchestrator hub
Sebuah repositori koordinasi yang mengelola beberapa repositori turunan. Rencana dapat memunculkan rencana turunan di sub-repositori.
Karakteristik:
- Mengoordinasikan beberapa sub-repositori.
- Rencana dapat mendelegasikan ke rencana turunan.
- Memelihara sebuah registri repositori yang dikelola.
- Ruang kerja
.dwp/di akar hub melacak status lintas repositori.
Ruang kerja agent
Sebuah ruang kerja agent adalah rumah kerja long-lived dari sebuah agent otonom — ruang kerja OpenClaw, direktori layanan Hermes, direktori data daemon asisten pribadi, atau volume persisten cloud agent. Ini adalah ruang kerja, tidak harus sebuah repositori git, dan produk utamanya adalah pekerjaan berkelanjutan agent daripada satu basis kode.
Wawasan yang membuat arketipe ini mungkin: harness adalah sebuah ruang kerja, bukan khususnya sebuah repositori. Setiap elemen harness yang didefinisikan metodologi untuk repositori memiliki padanan ruang kerja langsung:
| Elemen harness (repositori) | Padanan ruang kerja agent |
|---|---|
AGENTS.md (aturan, perintah cepat) |
Konteks berdiri ruang kerja — AGENTS.md itu sendiri, atau berkas standing-orders platform |
docs/ (pengetahuan tahan lama) |
Berkas pengetahuan ruang kerja dan dokumen memori |
.agents/ (skill, agent, command) |
Direktori skill platform — OpenClaw secara native memindai <workspace>/.agents/skills/ |
.dwp/ (rencana, draf) |
.dwp/ di akar ruang kerja — tidak berubah |
| log git (status, dapat dilanjutkan) | state.json per rencana (Status rencana), REQUIRED di sini |
Sebuah ruang kerja agent MUST menyediakan AGENTS.md, .agents/, dan .dwp/ di akar ruang kerja.
Git RECOMMENDED, tidak REQUIRED. Di mana git tidak ada, setiap rencana MUST membawa lapisan status yang dapat dibaca mesin: checkpoint state.json, catatan gate, dan timestamp per-tugas membawa informasi pemulihan yang dibawa log git di sebuah repositori.
Rencana di ruang kerja agent biasanya berjalan tanpa pengawasan: giliran heartbeat atau cron terjadwal melanjutkan rencana terbuka melalui Protokol Resume DWP, mengeksekusi tugas atomik berikutnya, memperbarui lapisan status, dan yield. Rencana — bukan sesi — adalah unit kontinuitas.
Heuristik klasifikasi
Individual repository
- single codebase
- plans modify local files
- .dwp/ at repo root
Orchestrator hub
- coordinates sub-repos
- plans delegate to child plans
- cross-repo .dwp/ state
Klasifikasikan sebagai ruang kerja agent terlebih dahulu, ketika target adalah direktori kerja platform agent otonom — sinyal: berkas identitas platform (seperti SOUL.md atau HEARTBEAT.md milik OpenClaw), tidak ada stack aplikasi utama, dan konten yang didominasi status milik agent itu sendiri. Satu sinyal platform yang kuat sudah cukup.
Jika tidak, klasifikasikan sebagai orchestrator hub ketika mayoritas jelas dari hal berikut berlaku: beberapa repositori git bersarang atau submodule; sebuah registri atau manifes repositori yang dikelola; konfigurasi yang menunjuk ke repositori eksternal. Klasifikasikan sebagai repositori individual jika tidak — itu adalah nilai default yang aman.
Ketika sinyal ambigu, agent MUST menyajikan penilaian dan buktinya kepada pengguna dan meminta konfirmasi sebelum melanjutkan.
Perbedaan onboarding
| Aspek | Individual | Orchestrator | Ruang kerja agent |
|---|---|---|---|
| Lingkup | Repositori ini | Beberapa repositori | Ruang kerja dan rencananya |
| Onboarding | Struktur repositori | Registri hub | Berkas platform + konvensi ruang kerja |
| Target rencana | Berkas lokal | Rencana turunan | Repositori lokal atau eksternal |
| Status | .dwp/ lokal |
.dwp/ lintas repositori |
.dwp/ + state.json (REQUIRED tanpa git) |
| Git | Required | Required | RECOMMENDED |
| Lapisan status | RECOMMENDED | RECOMMENDED | REQUIRED tanpa git; REQUIRED untuk jalannya tanpa pengawasan |