Mengadopsi DEV-WEB

Apa yang sudah ada hari ini, apa yang masih rencana, dan bagaimana sebuah adopsi dimulai.

Ringkas dulu

Apa ini?
Langkah nyata untuk mulai memakai DEV-WEB, dipisahkan tegas dari yang masih rencana.
Mengapa penting?
Mencampur yang sudah ada dengan yang direncanakan adalah bentuk klaim berlebih yang paling umum.
Bagaimana cara kerjanya?
Adopsi dimulai dengan memahami, bukan mengubah. Empat tahap pertama tidak menyentuh situs.
Contoh konkretnya?
Hari ini tersedia kontrak, skema, validator, adapter rujukan, dan satu kit adopsi yang menyiapkan berkas awal DEV-WEB di repositori Anda. Kit itu menyiapkan, bukan menyetujui.
Berikutnya baca apa?
"Mengadopsi situs yang sudah ada", untuk urutan tahapnya secara lengkap.

Yang sudah ada hari ini

Yang ada sekarang adalah kernel beserta permukaan yang bisa diverifikasi:

  • Kontrak inti yang netral terhadap framework, mencakup siklus hidup, kelas perubahan, harapan verifikasi, dan semantik rilis.
  • Kontrak alur adopsi yang menjelaskan tahap berurutan untuk mengambil alih repositori yang sudah ada.
  • Kontrak perutean kapabilitas yang memisahkan memilih pendekatan dari mengaktifkan alat.
  • Skema dan validator deterministik yang membuat kesesuaian bisa diperiksa, bukan diperdebatkan.
  • Adapter rujukan untuk Astro, sebagai contoh yang dikerjakan.
  • Situs edukasi ini, yang dihasilkan dari arsitektur informasi yang sudah diterima.
  • Kit adopsi dengan profil commercial-website, yang menyiapkan berkas awal DEV-WEB di sebuah repositori baru maupun yang sudah berjalan.
  • Template starter seo-geo.json (skema 0.2.0) untuk repositori baru yang mengadopsi DEV-WEB: semua bidang wajib sudah bernama, assessment_state sudah tersedia, dan catatan kelanjutan ada tempatnya — tidak ada yang harus ditebak dari nol.
  • Tier Playbook tiga tingkat (Tier 1→3 → Grand Goal) untuk situs web komersial satu pemilik: dari lantai kepatuhan teknis ke distribusi dan sinyal eksternal yang terverifikasi, dengan pemisahan tegas antara yang dikerjakan di repositori dan yang dikerjakan pemilik di luar.
  • Panduan adopsi Google Merchant Center dan template feed TSV — diturunkan dari pengalaman adopsi rujukan, menyertakan langkah upload, konfigurasi return policy, reinstatement, dan aturan pemeliharaan yang harus dilakukan setelah feed disetujui.

Secara bawaan kit itu tidak menulis apa pun. Ia menghitung dulu berkas apa saja yang akan dibuat lalu berhenti, dan penulisan baru terjadi kalau Anda memintanya secara terpisah. Sebuah generator yang menulis dulu dan menjelaskan belakangan tidak bisa diperiksa sebelum bertindak.

Sisanya sengaja dibuat penakut. Kit berhenti kalau ada berkas berbeda di jalur yang akan ia tulis, kalau salah satu bagian jalur ternyata tautan simbolik, kalau jalurnya keluar dari direktori tujuan, kalau profilnya tidak dikenal, atau kalau baseline yang Anda berikan bukan rujukan persis. Penolakan yang terjadi sebelum penulisan dimulai tidak meninggalkan apa pun, karena memang belum ada yang ditulis.

Kalau kegagalan baru muncul setelah penulisan dimulai, kit menarik kembali berkas yang baru saja ia buat sendiri. Satu pengecualian dinyatakan terbuka: bila sebuah berkas ternyata sudah berubah sehingga kit tidak lagi bisa membuktikan berkas itu buatannya, ia memilih membiarkannya dan melaporkan pembersihan yang tidak tuntas. Meninggalkan satu berkas lebih baik daripada menghapus sesuatu yang mungkin milik Anda.

Hasilnya adalah usulan, bukan persetujuan. Berkas yang ditulisnya menyatakan adopsi masih menunggu ratifikasi, membiarkan baseline kosong selama Anda belum memberi rujukan persis, membiarkan gerbang wewenang belum ditetapkan, dan menyatakan seluruh kategori aktivasi bernilai false. Meratifikasi adopsi, mencatat baseline, menetapkan gerbang, dan menyalakan alat tetap keputusan Anda sendiri.

Contoh konkret

Dijalankan pada repositori yang sudah berisi berkas lain, kit hanya menambah satu folder dan tidak mengubah satu byte pun dari berkas yang sudah ada. Dijalankan lagi dengan masukan yang sama, ia tidak menulis apa-apa dan melaporkan bahwa semuanya memang sudah sama.

Yang masih rencana

Bagian ini adalah rencana. Ditulis sebagai rencana dengan sengaja. Belum ada satu pun di antaranya yang bisa Anda pakai hari ini.

  • Profil adopsi selain commercial-website direncanakan menyusul, mengikuti kebutuhan nyata yang muncul, bukan sekadar melengkapi daftar.
  • Pekerjaan discoverability yang lebih luas dan operasi pascarilis direncanakan untuk tahap berikutnya.
  • Rilis situs ini ke alamatnya sendiri masih rencana dan belum pernah dikerjakan.

Kalau sebuah kemampuan tidak ada di daftar "Yang sudah ada hari ini", ia belum ada.

Bagaimana sebuah adopsi dimulai

Adopsi dimulai dengan memahami, bukan mengubah. Dalam praktiknya, empat tahap pertama tidak menghasilkan perubahan apa pun pada situs.

  1. InspectPeriksa: pahami repositori ini sebenarnya apa.
  2. AuthorityOtoritas: temukan siapa yang berwenang menyetujui perubahan.
  3. BaselineBaseline: catat satu titik persis yang diketahui baik.
  4. InvariantsInvarian: tuliskan apa yang wajib tetap benar.

Setelah repositori diperiksa, otoritasnya ditemukan, baseline yang persis dicatat, dan invariannya dinyatakan, barulah pekerjaan menjelaskan perubahan yang dibatasi. Setelah itu menyusul klasifikasi risiko dan pemilihan jalur, lalu verifikasi, lalu keputusan bukti rilis.

Yang tidak akan DEV-WEB lakukan untuk Anda

Menyebut ini secara terbuka lebih berguna daripada terdengar menyemangati:

  • Ia tidak akan membangun atau mendesain situs Anda.
  • Ia tidak akan memilihkan framework, host, atau vendor Anda.
  • Ia tidak akan melakukan deploy atas nama Anda, dan tidak menyimpan kredensial Anda.
  • Ia tidak akan menjanjikan peringkat, trafik, prospek, konversi, atau kutipan AI.
  • Ia tidak akan membuat pemeriksaan yang tidak tersedia dilaporkan sebagai lulus.

Yang ia tawarkan adalah cara memutuskan, mengukur, memverifikasi, dan merilis pekerjaan situs sehingga hasilnya bisa dipercaya dan, kalau perlu, dibatalkan.

Sumber kanonik yang dijelaskan halaman ini

Halaman ini menjelaskan berkas-berkas berikut. Kalau isinya berbeda, berkas itu yang berlaku — bukan tulisan di sini.

  • docs/milestones/2026-08-30-DEV-WEB-MILESTONE-ROADMAP.md
  • docs/product/DEV-WEB-PRODUCT-REQUIREMENTS.md
  • docs/roadmap/2026-08-31-DEV-WEB-NORTH-STAR-AND-STRATEGIC-GOALS.md
  • kernel/core/adopter-workflow.contract.json

Lanjutkan ke