Skip to content
Deep Work Plan hadir di Product Hunt hari ini Dukung kami
← Semua bab

Bab 03

Plan and task templates

Sebuah Deep Work Plan adalah sebuah direktori berkas Markdown. Bentuk direktori itu — dan setiap berkas di dalamnya — adalah yang membuat rencana dapat ditinjau baik oleh manusia maupun agent.

Struktur rencana

Sebuah rencana adalah sebuah direktori di bawah .dwp/plans/ bernama PLAN_<slug>/. Ia berisi:

  • README.md — ikhtisar rencana: tujuan, materi sumber, tabel tugas, dan status.
  • Satu berkas per tugas, bernama <n>.task_<slug>.md.
  • PROGRESS.md — log eksekusi yang berjalan.

Struktur berkas tugas

Setiap berkas tugas bernama <n>.task_<slug>.md dan mengikuti anatomi sepuluh bagian: Goal, Context, Touched Surface, Steps, Acceptance criteria, Validation, Files, Dependencies, Risks, dan Completion & Log. Bagian-bagian itu selalu muncul dalam urutan tersebut sehingga setiap pembaca tahu di mana harus mencari. Setiap tugas berlabuh kembali ke tujuan rencana sebelum ia bertindak, yang mencegah agent menyimpang sepanjang rentang panjang yang berjam-jam.

Final Review

Setiap rencana harus diakhiri dengan tepat satu tugas wajib: Final Review. Ia menutup rencana dalam tiga tahap berurutan — tidak ada bagian dari pemeriksaan keamanan yang dilonggarkan:

  1. Pemeriksaan keamanan — mengaudit segala sesuatu yang diubah rencana untuk secret, risiko injeksi, dan permukaan serangan baru, serta menjaga docs/SECURITY.md tetap mutakhir. Keamanan bukanlah alur kerja terpisah yang ditempelkan di akhir: setiap rencana meninggalkan perubahannya sendiri dalam keadaan teraudit, dan sebuah temuan kritis memblokir penyelesaian.
  2. Validasi status akhir — validasi penuh repositori berjalan dan lulus pada status relevan terakhir, setelah perbaikan final.
  3. Rekonsiliasi skills — setiap tugas telah mencatat disposisi skills-nya sendiri selagi buktinya masih segar; tinjauan ini merekonsiliasi catatannya. Executive Report tetap tersedia atas permintaan.

Konvensi README dan PROGRESS

README.md rencana harus berisi sebuah judul (# Deep Work Plan: <name>), pernyataan tujuan dalam prosa, bagian materi sumber yang opsional, tabel tugas (nomor, nama tugas, kotak centang status), dan baris status rencana dalam bentuk <n>/<total> tasks complete.

PROGRESS.md adalah log eksekusi yang hanya bisa ditambahi (append-only). Setiap entri mencatat stempel waktu ISO 8601, nomor dan nama tugas, apa yang dilakukan, serta penyimpangan atau alasan pelewatan apa pun. Karena ia hanya pernah bertambah, ia adalah riwayat yang andal tentang bagaimana rencana sebenarnya terbentang.

Judul dan rujukan silang

Semua judul menggunakan sentence case, dan dokumen menghindari bahasa pemasaran dan tanda seru. Konvensi ini menjaga rencana tetap konsisten lintas agent dan dari waktu ke waktu.