HUMAN-INTENT.md

Masalahnya

Jujur saja: kita tidak mau lagi membaca kode. Kita tidak mau memeriksa semua yang dilakukan agen, atau menyimpan setiap detail teknis proyek di kepala.

Namun jika tidak ada yang mengendalikan para agen, mereka akan mengubah proyek apa pun menjadi kekacauan yang mustahil dipelihara — yang tak bisa diurai baik oleh manusia maupun agen. Hanya soal waktu.

Idenya

HUMAN-INTENT.md adalah satu berkas di akar repositori Anda. Ia memuat niat Anda: arsitektur proyek, aturan pengembangan, dan keputusan produk.

Ini bukan dokumentasi kode. Ini hukum yang harus dipatuhi oleh kode.

Aturan

• Ditulis oleh Anda — dan hanya Anda

  Agen tidak pernah menyunting berkas ini. Setiap barisnya adalah keputusan yang diambil manusia.

• Instruksinya adalah hukum bagi agen

  Apa yang tertulis di HUMAN-INTENT.md mengalahkan segalanya. Jika kode bertentangan dengan berkas ini, kodelah yang salah.

• Ia menetapkan arsitektur, aturan, dan produk

  Niat, bukan resep. Agen sudah tahu semua pola; tugas Anda menetapkan apa yang harus berlaku — dan mengapa.

Mengapa ini berhasil

Mustahil mengimbangi agen: kode bertambah lebih cepat daripada yang mau dibaca siapa pun. Mengontrol setiap baris sia-sia. Mengontrol niat — bisa.

HUMAN-INTENT.md mengangkat kendali satu tingkat lebih tinggi: Anda mengawasi satu berkas berisi keputusan Anda, bukan ribuan baris kode. Selama berkas itu menjadi hukum, proyek berkembang sesuai niat Anda — meski tak ada yang membaca kodenya.

Cara memulai

1. Buat HUMAN-INTENT.md di akar repositori Anda.
2. Tuliskan keputusan yang sudah Anda ambil: arsitektur, aturan pengembangan, produk.
3. Minta agen Anda membaca berkas ini dan memperlakukannya sebagai hukum — rujuk dari AGENTS.md atau CLAUDE.md.
4. Setiap kali mengambil keputusan baru, tambahkan ke berkas. Jangan pernah biarkan agen menulis di dalamnya.
5. Tinjau berkas ini, bukan kodenya.