Standards Pack untuk AI Coding Agent: Agar Konvensi Proyek Tidak Hilang di Setiap Sesi

Masalah AI coding sering bukan karena agent tidak bisa menulis kode. Masalahnya, ia memulai sesi baru tanpa mengetahui keputusan yang dulu sudah disepakati: framework yang dipakai, pola autentikasi, cara menulis test, struktur folder, atau layanan yang dilarang. Jika aturan itu hanya hidup di kepala satu orang atau tersebar di chat lama, setiap task berubah menjadi kesempatan baru bagi agent untuk menebak.

Standards Pack di Skematik adalah profil konvensi proyek yang dapat dipakai ulang saat membuat atau menyempurnakan PRD. Ia bukan pengganti kebutuhan produk. Ia menyimpan hal-hal yang relatif stabil lintas proyek atau lintas iterasi: pilihan stack, aturan keamanan, pola kualitas, serta batas dependensi. PRD kemudian fokus pada keputusan unik untuk aplikasi yang sedang dibuat.

Pisahkan standar teknis dari kebutuhan produk

Kebutuhan produk menjawab “apa yang dibangun”: pengguna siapa, alur apa yang dibutuhkan, data apa yang disimpan, dan hasil apa yang dianggap berhasil. Standar teknis menjawab “bagaimana tim biasanya membangunnya”: misalnya gunakan TypeScript, validasi input di batas API, tulis test untuk rumus penting, atau jangan menaruh rahasia pada variabel yang diekspos ke browser.

Jika dua jenis keputusan ini dicampur ke setiap PRD secara manual, dokumen mudah saling tidak konsisten. Satu PRD mungkin menyebut nama folder lama, yang lain memasang library yang dilarang. Dengan profil standar, aturan yang berulang disuntikkan ke proses perencanaan tanpa membuat setiap PRD berubah menjadi buku pedoman raksasa.

Isi Standards Pack dengan aturan yang bisa dibuktikan

• Stack atau library utama yang memang disetujui tim.
• Pola autentikasi dan batas data per peran bila berlaku di banyak proyek.
• Aturan validasi, error handling, dan pengujian yang wajib.
• Konvensi struktur folder atau nama yang tidak boleh diubah sembarangan.
• Layanan, dependensi, atau pola yang dilarang beserta alasan singkatnya.

Hindari aturan abstrak seperti “kode harus bagus”. Agent tidak dapat mengujinya. Ganti dengan keputusan yang dapat diperiksa, seperti “semua endpoint mutasi memvalidasi input di server” atau “jangan tambahkan dependency untuk kebutuhan yang dapat dipenuhi utilitas yang sudah ada”. Aturan yang bisa dibuktikan lebih mudah dijaga saat hasil kerja direview.

Standar yang baik mengurangi pilihan yang tidak perlu. Ia tidak membatasi kreativitas produk; ia mencegah agent mengulang keputusan dasar yang sudah selesai.

Gunakan profil yang tepat untuk konteks yang tepat

Satu profil tidak harus melayani seluruh pekerjaan. Tim bisa memiliki standar berbeda untuk aplikasi web, Google Apps Script, atau proyek yang memiliki data sensitif. Pilih profil yang benar saat membuat PRD, lalu periksa apakah aturan tersebut benar-benar relevan. Memaksakan standar aplikasi SaaS ke web app sederhana justru menambah kompleksitas yang tidak dibutuhkan.

Ketika PRD diperbaiki, Skematik menjaga konteks standar yang dipilih agar revisi tidak diam-diam menjauh dari konvensi awal. Ini sangat membantu ketika perubahan dilakukan beberapa minggu kemudian, saat orang yang membuat keputusan pertama mungkin sudah tidak mengingat detailnya.

Turunkan standar ke handoff agent

Setelah PRD siap, ekspor aturan dan rencana ke format yang dibaca agent, seperti CLAUDE.md, AGENTS.md, atau aturan Cursor sesuai alur kerja tim. Jangan salin tempel semuanya tanpa membaca. Handoff yang baik memberi agent cukup konteks untuk mengikuti konvensi, sambil tetap menyisakan PRD sebagai sumber keputusan produk dan task sebagai pekerjaan yang dapat dieksekusi.

Tinjau Standards Pack setelah proyek selesai atau setelah bug berulang ditemukan. Bila sebuah pelajaran selalu berlaku, tambahkan ke profil. Bila hanya berlaku pada satu aplikasi, taruh di PRD aplikasi itu saja. Pemisahan ini menjaga profil tetap pendek dan berguna.

Mulai dengan versi kecil

1. Kumpulkan lima keputusan teknis yang paling sering diulang tim.
2. Tulis dalam kalimat imperatif yang bisa diuji saat review.
3. Buat profil terpisah bila dua jenis proyek memiliki kebutuhan yang berbeda.
4. Pakai saat membuat satu PRD baru dan lihat apakah agent lebih konsisten.
5. Tambahkan pelajaran baru hanya setelah terbukti relevan di lebih dari satu task.