Skip to content
← Semua dokumen spesifikasi

Conformance

Versi 1.1. Status: Stabil. Dokumen ini mendefinisikan apa artinya sebuah repositori menjadi konforman terhadap Deep Work Plan — yaitu, AI-first dan dapat dikemudikan agent. Kata kunci MUST, MUST NOT, SHOULD, SHOULD NOT, dan MAY harus ditafsirkan sebagaimana dijelaskan dalam RFC 2119.

Konformansi ada agar “AI-first” menjadi properti yang objektif dan dapat diperiksa, bukan sekadar kesan. Sebuah repositori entah memenuhi kriteria di bawah atau tidak. Sub-skill verify (/dwp-verify) memeriksanya secara mekanis.

Sebuah repositori yang konforman

Sebuah repositori konforman DWP MUST memenuhi semua hal berikut. Setiap artefak MUST dipikirkan untuk repositori — disesuaikan dengan bahasa, framework, dan perintahnya yang nyata. Sebuah stub generik, sebuah placeholder, atau konten yang disalin dari repositori lain tidak memenuhi sebuah kriteria.

  1. AGENTS.md di akar. Repositori MUST berisi sebuah AGENTS.md di akar yang mencakup (a) sebuah indeks dokumentasi, (b) aturan-aturan wajib untuk repositori, dan (c) sebuah blok Quick Commands yang perintah-perintahnya nyata dan dapat dijalankan di repositori ini. Perintah placeholder (misalnya, npm test di repositori yang tidak memakai npm) MUST NOT muncul.
  2. CLAUDE.md me-resolve ke AGENTS.md. Sebuah CLAUDE.md MUST ada dan me-resolve ke AGENTS.md (sebuah symlink, atau padanan yang menjamin satu sumber kebenaran). Keduanya MUST NOT menyimpang.
  3. Sebuah hierarki docs/. Repositori MUST berisi sebuah direktori docs/ yang mencakup kategori-kategori standar (arsitektur, standar, pengujian, perintah pengembangan, keamanan, dan onboarding agent) dengan konten nyata yang spesifik repositori. Modul kompleks SHOULD membawa README.md-nya sendiri. Panduan pengujian MUST mendefinisikan toolchain test, lint, dan type-check yang nyata — atau, untuk sebuah repositori yang tidak memiliki satu pun, sebuah penyiapan konkret yang diusulkan dari stack selama onboarding. Sebuah panduan pengujian yang kosong atau “tanpa test” tidak memenuhi kriteria ini: tanpa cara yang terdefinisi untuk memvalidasi perilaku, sebuah rencana tidak memiliki validation gate yang objektif.
  4. Sebuah rumah .agents/. Repositori MUST berisi sebuah direktori .agents/ dengan agents/, commands/, dan skills/, ditambah sebuah katalog di bawah .agents/docs/ yang sesuai dengan apa yang ada di disk. Command dwp-* MUST menjadi delegator tipis ke skill yang terpasang. Sebuah path .claude MUST me-resolve ke .agents.
  5. Sebuah ruang kerja .dwp/ yang di-gitignore. Repositori MUST berisi sebuah direktori .dwp/ dengan plans/ dan drafts/, dan .dwp/ MUST di-gitignore. Sebuah ruang scratch tmp/ SHOULD ada dan SHOULD di-gitignore.
  6. Skill metodologi dapat di-resolve. Skill Deep Work Plan MUST terpasang atau dirujuk sedemikian rupa sehingga sebuah agent di repositori dapat memanggil sub-skill-nya.

Sebuah repositori sepenuhnya konforman dengan nol addon. Addon (devcontainer, Dailybot, dependency-upgrade, design-system) bersifat opt-in dan MUST NOT diwajibkan untuk konformansi.

Sebuah rencana yang terbentuk baik

Sebuah Deep Work Plan di .dwp/plans/ terbentuk baik ketika:

  1. Setiap tugas MUST mendeklarasikan lingkup, acceptance criteria, dan setidaknya satu validation gate (sebuah perintah atau pemeriksaan yang secara objektif lulus atau gagal) yang eksplisit.
  2. Setiap tugas yang menambahkan fungsionalitas inti baru atau mengubah perilaku produk MUST menyertakan cakupan test otomatis untuk perilaku itu dalam acceptance criteria-nya, dan MUST menjalankan test repositori bersama dengan pemeriksaan lint dan type-check-nya dalam validation gate-nya — bukan build saja. Test yang ada MUST tetap hijau; sebuah perubahan perilaku MUST memperbarui test yang dirusaknya alih-alih menghapus atau melewatinya. Tugas dokumentasi-murni, konfigurasi, atau riset dikecualikan dari pembuatan test tetapi tetap menjalankan gate repositori.
  3. Setiap tugas yang menyentuh autentikasi, penanganan input, secret atau konfigurasi, permukaan jaringan, atau dependensi MUST membawa ekspektasi keamanan dari perubahan itu dalam acceptance criteria-nya, dan setiap commit MUST bebas dari materi secret.
  4. Rencana MUST mempersistenkan kemajuan sehingga pekerjaan bertahan dari interupsi dan dapat dilanjutkan oleh agent yang berbeda.
  5. Rencana MUST menyertakan tiga tugas akhir wajib — Security Review, Skills & Agents Discovery, dan Executive Report. Sebuah temuan keamanan kritis memblokir penyelesaian sampai diperbaiki atau diterima secara eksplisit.
  6. Tugas SHOULD berlabuh kembali ke tujuan rencana sebelum mengeksekusi, untuk mencegah penyimpangan sepanjang rentang yang panjang.

Memverifikasi konformansi

Konformansi SHOULD diverifikasi secara mekanis ketimbang dengan inspeksi. Menjalankan /dwp-verify menghasilkan laporan lulus/gagal terhadap kriteria di atas: keberadaan dan kenyataan-konten AGENTS.md, resolusi CLAUDE.md, kategori-kategori docs/, kecocokan katalog-versus-disk .agents/, status gitignore .dwp/ dan tmp/, dan — untuk sebuah rencana — bahwa setiap tugas membawa acceptance criteria dan sebuah validation gate, dengan cakupan test untuk tugas yang mengubah perilaku dan ketiga tugas akhir wajib hadir, termasuk Security Review.

Sebuah repositori SHOULD diverifikasi ulang setelah onboarding dan setelah setiap rencana yang selesai, sehingga konformansi dipelihara ketimbang ditegaskan sekali saja.