Perangkap Umum: Menspesifikasikan Solusi, Bukan Masalah

Satu mode kegagalan layak disebutkan secara khusus, karena sangat mudah terjebak di dalamnya. Ketika kamu duduk untuk menulis spek, godaannya adalah mendeskripsikan solusi yang sudah kamu bayangkan — "sidebar dengan tab-tab," "modal yang muncul," "tabel Postgres." Tapi spek yang penuh solusi secara diam-diam mengunci keputusan yang belum kamu pantas ambil.

Bandingkan dua baris ini:

Bad:  Add a left sidebar with collapsible sections for each book status.
Good: Let me see my books grouped by status without losing the full list.

Kalimat pertama sudah memilih sidebar, bagian yang bisa dilipat, dan sebuah tata letak — sebelum siapa pun mengonfirmasi bahwa itu keputusan yang tepat. Kalimat kedua menyatakan pekerjaan yang perlu dilakukan dan membiarkan AI (dan dirimu) bebas menemukan hal paling sederhana yang memenuhinya, yang mungkin saja hanya tiga tombol filter. Deskripsikan hasil yang kamu inginkan; biarkan implementasi tetap bisa dinegosiasikan selama mungkin. Solusi murah untuk diubah dalam spek dan mahal untuk diubah dalam kode.