Mengenal Spec Driven Development: Cara Membuat Software dengan Rencana yang Lebih Jelas

Mengenal Spec Driven Development atau SDD, pendekatan pengembangan software yang menjadikan spesifikasi sebagai panduan utama sebelum mulai menulis kode.

Pernahkah Anda meminta seseorang membuat sesuatu, tetapi hasil akhirnya berbeda dengan yang Anda bayangkan? Masalah seperti ini juga sangat sering terjadi dalam pengembangan software. Developer merasa sudah membuat fitur dengan benar, tetapi ternyata hasilnya tidak sesuai dengan kebutuhan pengguna.

Salah satu pendekatan yang mencoba mengurangi masalah tersebut adalah Spec Driven Development atau SDD. Sederhananya, SDD adalah cara mengembangkan software dengan membuat spesifikasi yang jelas terlebih dahulu sebelum proses coding dilakukan.

Apa Itu Spec Driven Development? #

Spec Driven Development adalah pendekatan pengembangan software yang menjadikan spesifikasi sebagai sumber utama dalam menentukan bagaimana sebuah fitur harus dibuat.

Spesifikasi tersebut dapat berisi tujuan fitur, kebutuhan pengguna, aturan bisnis, alur proses, format data, sampai kondisi-kondisi khusus yang harus ditangani oleh sistem.

Dalam SDD, kita berusaha menjelaskan apa yang harus dibuat sebelum memikirkan bagaimana cara menulis kodenya.

Analogi Sederhana: Membangun Rumah #

Bayangkan Anda ingin membangun rumah. Anda tentu tidak langsung membeli semen kemudian mulai memasang batu bata secara acak.

Biasanya akan dibuat terlebih dahulu sebuah rancangan. Berapa jumlah kamar, di mana posisi dapur, berapa ukuran bangunan, di mana pintu utama, dan bagaimana kebutuhan listrik maupun air.

Dalam pengembangan software, spesifikasi memiliki fungsi yang mirip dengan rancangan rumah tersebut. Coding adalah proses membangunnya, sedangkan specification atau spec adalah rancangan yang menjadi acuan.

Apa yang Terjadi Jika Langsung Coding? #

Langsung menulis kode memang terasa lebih cepat. Namun untuk proyek yang semakin besar, pendekatan tersebut sering menimbulkan masalah karena setiap orang dapat memiliki pemahaman yang berbeda terhadap fitur yang sedang dibuat.

• Developer salah memahami kebutuhan pengguna.
• Fitur harus dibuat ulang karena requirement berubah atau tidak jelas.
• Developer yang berbeda menghasilkan implementasi yang berbeda.
• Testing menjadi sulit karena tidak ada acuan hasil yang benar.
• Dokumentasi tertinggal jauh dari kode.
• AI coding assistant dapat menghasilkan kode yang terlihat benar tetapi sebenarnya tidak sesuai kebutuhan bisnis.

Bagaimana Cara Kerja SDD? #

Dalam bentuk paling sederhana, proses Spec Driven Development dapat dibagi menjadi beberapa tahap.

• Menentukan masalah yang ingin diselesaikan.
• Menentukan kebutuhan pengguna.
• Menuliskan aturan dan perilaku sistem dalam sebuah spesifikasi.
• Memeriksa apakah spesifikasi sudah cukup jelas.
• Mengimplementasikan software berdasarkan spesifikasi tersebut.
• Menguji hasil implementasi terhadap spesifikasi.
• Memperbarui spesifikasi ketika kebutuhan berubah.

Contoh Sederhana #

Misalnya sebuah toko ingin membuat fitur diskon untuk pelanggan.

Tanpa spesifikasi yang jelas, developer hanya mendapatkan permintaan seperti: Buat diskon 10 persen untuk pelanggan.

Permintaan tersebut terlihat sederhana, tetapi sebenarnya masih memiliki banyak pertanyaan. Apakah semua pelanggan mendapatkan diskon? Apakah ada minimal transaksi? Apakah diskon berlaku untuk semua produk? Apakah diskon boleh digabungkan dengan promo lainnya?

Dalam pendekatan SDD, kebutuhan tersebut akan diperjelas terlebih dahulu.

feature: Customer Discount

description: >
  Member mendapatkan diskon ketika melakukan transaksi
  dengan nilai tertentu.

rules:
  - Pelanggan harus memiliki status Member
  - Minimal transaksi Rp500.000
  - Diskon sebesar 10 persen
  - Maksimal diskon Rp100.000
  - Tidak dapat digabungkan dengan promo lain

Sekarang developer memiliki panduan yang jauh lebih jelas mengenai fitur yang harus dibuat.

Spec Bukan Sekadar Dokumentasi #

Dokumentasi tradisional sering dibuat setelah software selesai. Akibatnya dokumentasi kadang sudah tidak sesuai dengan kondisi aplikasi.

Dalam Spec Driven Development, specification justru dibuat sebelum atau bersamaan dengan proses pengembangan. Spec menjadi bagian aktif dari proses pembangunan software, bukan hanya catatan tambahan.

Mengapa SDD Menjadi Menarik di Era AI? #

Kemunculan AI coding assistant membuat developer dapat menghasilkan kode jauh lebih cepat. Namun kemampuan menghasilkan kode dengan cepat tidak otomatis berarti software yang dihasilkan sesuai dengan kebutuhan.

AI akan memberikan hasil yang jauh lebih terarah ketika mendapatkan konteks, aturan, batasan, dan tujuan yang jelas. Karena itu konsep Spec Driven Development menjadi semakin relevan ketika pengembangan software melibatkan AI.

Semakin cepat kita dapat menghasilkan kode, semakin penting kita memastikan kode yang dibuat adalah kode yang benar-benar dibutuhkan.

Prompt Biasa vs Spec yang Jelas #

Misalnya kita meminta AI membuat fitur login.

Buatkan fitur login.

AI memang dapat membuat kode dari perintah tersebut. Namun AI harus menebak banyak hal seperti metode autentikasi, aturan password, perilaku ketika login gagal, session, keamanan, dan berbagai detail lainnya.

Bandingkan dengan permintaan yang lebih terstruktur.

feature: User Login

requirements:
  - Login menggunakan email dan password
  - Email wajib terdaftar
  - Password minimal 8 karakter
  - Setelah 5 kali login gagal, akun dikunci selama 15 menit
  - Login berhasil mengarahkan user ke dashboard
  - Session berlaku selama 24 jam

error_cases:
  - Email tidak ditemukan
  - Password salah
  - Akun sedang dikunci

Dengan informasi seperti ini, AI maupun developer manusia memiliki pemahaman yang lebih jelas mengenai perilaku aplikasi yang diharapkan.

Apa Manfaat Spec Driven Development? #

• Requirement menjadi lebih jelas sebelum coding dimulai.
• Mengurangi kesalahpahaman antara user, product owner, dan developer.
• Developer memiliki acuan yang sama ketika mengembangkan fitur.
• Testing menjadi lebih mudah karena hasil yang diharapkan sudah didefinisikan.
• AI coding assistant mendapatkan konteks yang lebih baik.
• Perubahan requirement menjadi lebih mudah dilacak.
• Project lebih mudah dipahami oleh developer baru.
• Mengurangi kemungkinan membuat fitur yang sebenarnya tidak dibutuhkan.

Apakah Spec Harus Panjang dan Rumit? #

Tidak. Salah satu kesalahan yang mudah terjadi adalah menganggap specification harus berupa dokumen puluhan halaman.

Spec yang baik bukan spec yang paling panjang, melainkan spec yang cukup jelas sehingga orang lain dapat memahami apa yang harus dibuat tanpa terlalu banyak menebak.

Untuk fitur sederhana, sebuah specification bahkan dapat terdiri dari beberapa paragraf, beberapa aturan bisnis, dan beberapa acceptance criteria.

Format Spec Sederhana untuk Memulai #

# Nama Fitur

## Tujuan
Jelaskan masalah yang ingin diselesaikan.

## User
Siapa yang menggunakan fitur ini?

## Requirements
- Sistem harus...
- User dapat...
- Sistem tidak boleh...

## Business Rules
- Aturan 1
- Aturan 2

## Acceptance Criteria
- Jika kondisi A terjadi, hasilnya harus B
- Jika kondisi C terjadi, sistem harus menampilkan D

## Edge Cases
- Apa yang terjadi jika data kosong?
- Apa yang terjadi jika koneksi gagal?
- Apa yang terjadi jika user tidak memiliki permission?

SDD Bukan Pengganti Developer #

Spec Driven Development tidak menghilangkan kebutuhan terhadap developer yang memahami arsitektur, database, keamanan, performa, testing, dan berbagai aspek teknis lainnya.

SDD membantu memisahkan dua pertanyaan penting dalam pengembangan software: apa yang sebenarnya ingin kita bangun dan bagaimana cara terbaik untuk membangunnya.

Kapan SDD Sebaiknya Digunakan? #

SDD dapat digunakan pada hampir semua jenis proyek software, tetapi manfaatnya akan semakin terasa ketika aplikasi mulai memiliki banyak aturan bisnis, banyak developer, atau menggunakan AI untuk membantu menghasilkan kode.

• Aplikasi bisnis dengan banyak aturan.
• ERP dan sistem internal perusahaan.
• REST API dan integrasi antar sistem.
• Aplikasi SaaS.
• Project dengan banyak developer.
• Project yang menggunakan AI coding assistant.
• Fitur yang memiliki banyak kondisi dan edge case.

Bagaimana Cara Mulai Menggunakan SDD? #

Anda tidak perlu langsung mengubah seluruh cara kerja tim. Mulailah dari satu fitur kecil.

• Pilih satu fitur yang ingin dibuat.
• Tuliskan tujuan fitur tersebut.
• Tuliskan siapa penggunanya.
• Tuliskan aturan bisnisnya.
• Tuliskan kondisi ketika fitur dianggap berhasil.
• Tuliskan kemungkinan kondisi gagal atau edge case.
• Setelah spec cukup jelas, barulah mulai coding atau meminta AI membantu membuat implementasinya.

Kesimpulan #

Spec Driven Development sebenarnya memiliki ide yang sederhana: pahami dan jelaskan apa yang ingin dibuat sebelum terburu-buru menulis kode.

Dengan spesifikasi yang jelas, developer, stakeholder, tester, dan AI dapat bekerja berdasarkan pemahaman yang sama. Hasilnya bukan hanya proses pengembangan yang lebih terstruktur, tetapi juga peluang yang lebih besar untuk menghasilkan software yang benar-benar menyelesaikan masalah pengguna.

Coding yang cepat memang berguna. Tetapi mengetahui dengan jelas apa yang harus dibuat jauh lebih penting.