17.1 Dari Prompt Pendek ke Brief Kerja

Seorang engineer duduk di depan layar. Ia mengetik: “buatkan REST API untuk user registration.” Dalam hitungan detik, AI mengeluarkan kode lengkap dengan controller, service, repository, dan entity. Semua terlihat rapi. Ia copy-paste ke project, lalu lanjut ke tugas berikutnya.

Dua minggu kemudian, tim menemukan bahwa endpoint registration tidak memeriksa domain email. Pengguna bisa mendaftar dengan alamat dari domain mana pun, padahal aplikasi ini hanya untuk pegawai internal. Tidak ada validasi. Tidak ada pengecekan terhadap corporate directory. Kode yang dihasilkan AI memang benar secara sintaks, tetapi salah secara konteks.

Apa yang sebenarnya terjadi?

Engineer itu memberi AI prompt pendek. Ia meminta AI menulis kode, bukan menyelesaikan masalah. Prompt pendek seperti “buatkan kode untuk ini” hanya memberi AI dua hal: subjek teknis dan format output. AI tidak tahu siapa pengguna akhirnya, constraint apa yang berlaku, batasan sistem mana yang tidak boleh dilanggar, atau apa yang terjadi jika ada skenario di luar jalur normal.

Prompt pendek mengubah AI menjadi mesin pengetik cepat. Outputnya terlihat meyakinkan karena rapi dan lengkap, tetapi tidak bisa dipertanggungjawabkan karena tidak ada kriteria yang bisa dipakai untuk menilainya.

Inilah perbedaan mendasar yang harus dipahami: prompt pendek adalah perintah. Brief kerja adalah instruksi yang mengandung konteks keputusan.

Perhatikan perbedaan nyata antara kedua pendekatan berikut.

# PROMPT PENDEK (kurang konteks)
Buatkan REST API untuk user registration.

# BRIEF KERJA (lengkap dengan konteks)
Role: Backend engineer untuk aplikasi internal perusahaan.
Context: Aplikasi ini hanya untuk pegawai internal, domain email @company.com.
Objective: Buat endpoint POST /api/register yang menerima email dan password.
Constraint:
- Validasi domain email harus @company.com.
- Cek email ke corporate directory sebelum registrasi.
- Password minimal 8 karakter, hash dengan bcrypt.
- Jangan simpan password plaintext.
- Semua error return format JSON: { "error": "message" }.
Verification plan:
- Test registrasi dengan email @company.com -> sukses.
- Test registrasi dengan email @gmail.com -> tolak dengan error.
- Test registrasi dengan email tidak terdaftar di directory -> tolak.

Diagram berikut memperlihatkan dua jalur paralel yang membandingkan prompt pendek dengan brief kerja.

flowchart TD A[Mulai] --> B{Pilih pendekatan} B --> C[Prompt pendek] B --> D[Brief kerja] C --> E[Input: perintah singkat] E --> F[AI sebagai mesin ketik] F --> G[Output rapi, tanpa konteks] G --> H[Risiko: asumsi salah, error] D --> I[Input: konteks + constraint + objective] I --> J[AI sebagai rekan kerja] J --> K[Output sesuai konteks] K --> L[Dapat diverifikasi]

Ketika seorang arsitek memberi brief ke engineer manusia, ia tidak bilang “buatkan modul payment.” Ia menjelaskan: modul ini dipakai oleh customer service untuk refund, harus terintegrasi dengan gateway X, maksimal latency dua detik, tidak boleh menyentuh tabel transaksi secara langsung, dan harus mencatat semua perubahan ke audit log. Engineer yang menerima brief seperti ini tahu apa yang harus dilakukan dan apa yang harus dihindari.

AI juga perlu diperlakukan sama. Bedanya, AI tidak akan bertanya balik jika ada yang kurang jelas. Ia akan mengisi sendiri bagian yang hilang dengan asumsi. Dan asumsi itulah yang sering menjadi sumber masalah.

Brief kerja mengubah hubungan dengan AI. Anda tidak lagi memerintah AI untuk menulis sesuatu. Anda memberi AI sebuah tugas dengan konteks, batasan, dan kriteria. AI menjadi pelaksana yang bekerja dalam kerangka yang sudah ditentukan. Anda tetap menjadi penentu keputusan.

Cara termudah untuk memulai adalah dengan membiasakan diri menambahkan tiga hal sebelum meminta AI bekerja: apa yang ingin dicapai, apa yang tidak boleh dilakukan, dan bagaimana hasilnya akan dinilai. Tiga hal ini sudah cukup untuk mengubah prompt dangkal menjadi brief kerja yang usable.

Di subbab berikutnya, kita akan membedah anatomi brief kerja yang lebih lengkap. Anda akan melihat bahwa brief kerja bukan sekadar prompt panjang, tetapi struktur yang bisa diulang dan diperbaiki setiap kali berinteraksi dengan AI.