Skip to content
← Semua bab

Bab 02

The core loop

DWP mendefinisikan serangkaian operasi yang menggerakkan rencana dari tujuan hingga penyelesaian: create → execute → refine → resume → status → verify, didukung oleh pembantu siklus hidup onboard dan upgrade serta sub-skill author (total sembilan sub-skill). Bersama-sama mereka membentuk loop yang diikuti agent sepanjang masa rencana. Agent mengeksekusi satu tugas pada satu waktu, memvalidasi setiap langkah sebelum melanjutkan.

Loop ini adalah bentuk operasional dari spec-driven development. Rencana adalah spesifikasi yang menjadi acuan eksekusi agent, setiap tugas membawa acceptance criteria yang eksplisit, dan langkah validasi adalah gate yang mengubah klaim penyelesaian menjadi bukti penyelesaian. Karena rencana dan log kemajuannya berada di dalam repositori, loop ini dapat dilanjutkan lintas sesi dan agent.

Operasi-operasinya

  • create — Menghasilkan rencana baru dari sebuah tujuan. Agent menganalisis tujuan, menguraikannya menjadi tugas-tugas berurutan, dan menulis berkas rencana. Ia sebaiknya mengajukan pertanyaan klarifikasi sebelum menulis ketika tujuannya ambigu. Dalam mode guided, agent langsung melakukan materialisasi sebuah rencana Lite — sebuah proposal yang kompak dan sudah dapat dieksekusi — dan pengembang memilih untuk mempertahankannya, mempromosikannya menjadi rencana Full berbasis berkas tugas, mengeditnya, atau berhenti; dalam mode trust, agent langsung melakukan materialisasi representasi yang dipilih (Lite atau Full) tanpa langkah peninjauan. Lihat spesifikasi untuk kedua representasi tersebut. Analisis kebutuhan dan pemeriksaan kualitas rencana tetap berjalan pada kedua mode.
  • execute — Menjalankan rencana tugas demi tugas. Agent memperbarui log kemajuan setelah setiap tugas dan menandai status penyelesaian tugas. Ia tidak boleh melewati tugas tanpa mencatat alasannya.
  • refine — Memodifikasi rencana yang ada. Agent boleh menambah, menghapus, atau menyusun ulang tugas, tetapi ia harus mempertahankan pekerjaan yang selesai dan memperbarui tabel tugas.
  • resume — Melanjutkan rencana yang terhenti. Agent membaca log kemajuan dan berkas tugas untuk merekonstruksi status, lalu melanjutkan dari tugas pertama yang belum selesai.
  • status — Melaporkan kemajuan tanpa mengeksekusi. Agent merangkum tugas yang selesai, sedang berjalan, dan tertunda serta tidak mengubah apa pun.
  • verify — Memeriksa konformansi tanpa mengubah apa pun. Agent melaporkan apakah repositori memenuhi standar dan apakah sebuah rencana terbentuk dengan baik — setiap tugas membawa acceptance criteria dan sebuah validation gate. Lihat dokumen Konformansi spesifikasi.
  • onboard — Mengorientasikan agent ke repositori berbasis penalaran, membuat AGENTS.md, panduan di docs/, dan struktur .agents/.
  • upgrade — Memperbarui harness repositori atau rencana yang ada ke versi standar DWP yang lebih baru.
  • author — Menulis skill, agent, atau command baru yang sesuai dengan konvensi repositori, menjaga katalog dokumentasi tetap sinkron.

Direktori keluaran .dwp/

Semua artefak DWP berada di bawah direktori .dwp/ yang di-gitignore di akar repositori. Menjaga ruang kerja di luar kendali versi berarti status kerja sebuah rencana tidak pernah mencemari riwayat proyek.

.dwp/
├── plans/
│   └── PLAN_001_<slug>/
│       ├── manifest.json
│       ├── contract.json
│       ├── journal.ndjson
│       ├── state.json
│       ├── README.md
│       ├── PROGRESS.md
│       ├── 1.task_<slug>.md
│       ├── 2.task_<slug>.md
│       └── analysis_results/
└── config.json

Anatomi tugas sepuluh bagian

Sepuluh bagian dari diagram di atas mendefinisikan struktur anatomis setiap berkas tugas dalam rencana Full. Urutan ini memastikan setiap unit kerja mandiri, tidak ambigu, dan dapat diaudit secara independen:

  1. Goal — satu paragraf yang menyatakan apa yang dicapai tugas.
  2. Context — latar belakang, tautan, dan mengapa tugas ini ada.
  3. Touched Surface — apa yang diubah tugas dan kelas risiko yang memilih validasinya.
  4. Steps — tindakan konkret yang berurutan untuk dilakukan.
  5. Acceptance Criteria — daftar periksa kondisi yang mendefinisikan selesai.
  6. Validation — perintah atau pengujian untuk memverifikasi pekerjaan.
  7. Files — path yang diperkirakan akan dibuat atau diubah.
  8. Dependencies — tugas lain atau prasyarat eksternal.
  9. Risks — apa yang bisa salah, dan mitigasinya.
  10. Completion & Log — penanda status ditambah catatan kronologis.

Validasi, penyelesaian, dan pelanjutan

Validasi adalah bagian dari tugas, bukan renungan belakangan: setiap tugas menyebutkan perintah atau test yang membuktikannya selesai, dan agent menjalankannya sebelum menandai penyelesaian. Test bersifat kelas satu di sini — sebuah tugas yang menambahkan fungsionalitas baru atau mengubah perilaku harus menambahkan atau memperbarui test otomatis untuk perilaku itu dan menjalankan pemeriksaan kualitas kode lengkap repositori (test ditambah lint dan type-check), bukan sekadar memastikan bahwa build berhasil; test yang ada harus tetap hijau, diperbarui ke perilaku yang dimaksudkan alih-alih dilewati. Keamanan bersifat kelas satu dengan cara yang sama — setiap tugas yang menyentuh autentikasi, penanganan input, secrets, permukaan jaringan, atau dependensi membawa ekspektasi keamanan dari perubahan itu dalam acceptance criteria-nya dan menjaga setiap commit bebas dari secrets, dan setiap rencana ditutup dengan Final Review — pemeriksaan keamanan atas seluruh kumpulan perubahan, validasi lengkap pada status akhir, dan rekonsiliasi keputusan skills. Penyelesaian dicatat dengan penanda status yang eksplisit ([ ] belum dimulai, [~] sedang berjalan, [x] selesai, [!] terhambat) di bagian Completion & Log. Pelanjutan bersandar pada penanda ini dan log kemajuan — sebuah agent dapat merekonstruksi persis di mana rencana berhenti dan melanjutkan dari tugas pertama yang belum selesai tanpa mengulang pekerjaan yang telah rampung.

v6 dan v7: metodologi yang sama, struktur lebih ketat

Standar DWP saat ini adalah 7.0.0, diimplementasikan oleh lini skill 7.x. Paket tersebut menggunakan v7 untuk setiap rencana baru secara default; permintaan v6 yang eksplisit tetap menghasilkan rencana v6. Rencana v1, v2, v5, dan v6 yang ada mempertahankan generasi yang tercatat dan tidak pernah dimigrasikan secara diam-diam; memindahkan rencana v5 ke v6 memerlukan permintaan migrasi eksplisit.

v6 mempertahankan metodologi rencana → tugas → gerbang validasi → penyelesaian, perintah slash, dan lokasi .dwp/plans/ yang sama. Struktur rekayasanya diperketat dengan kontrak, jurnal, manifest konteks per tugas, penjadwal, dan penolakan daftar izin kosong. v7 mempertahankan lapisan catatan tersebut dan menambahkan penanda tugas parallel_safe opsional, peristiwa jurnal delegation untuk pekerjaan terbatas yang diserahkan ke agen lain, serta registri addon .dwp/config.json; tanpa addon delegasi yang diaktifkan, setiap rencana tetap berjalan secara berurutan di sesi saat ini. Keputusan arsitektur adalah GO; non-inferioritas empiris hasil agen belum diukur.