- Spec-Driven Development: pendekatan yang berupaya mengangkat spesifikasi (Spec), yang dalam pengembangan tradisional hanya menjadi sarana pendukung, menjadi spesifikasi yang dapat dieksekusi, lalu langsung menghasilkan implementasi yang berfungsi dari spesifikasi tersebut
- Menggeser praktik yang berpusat pada kode, dengan menekankan pengembangan berbasis niat yang terlebih dahulu mendefinisikan apa dan mengapa, lalu merinci bagaimana setelahnya
- Gagasan utamanya adalah membuat hasil yang konsisten melalui spesifikasi, serta mengotomatiskan pekerjaan berulang agar pengembang bisa fokus pada masalah produk
- Spec Kit adalah kumpulan alat yang membantu mengotomatiskan implementasi dengan mengubah spesifikasi menjadi artefak yang dapat dieksekusi dengan cara ini
- Setelah instalasi, gunakan
/specify untuk menjelaskan apa/mengapa, /plan untuk mendeklarasikan stack/arsitektur, dan /tasks untuk membuat unit kerja
- Tujuannya adalah membantu organisasi lepas dari penulisan kode umum yang tidak terdiferensiasi dan fokus pada skenario produk, sebagai kerangka kerja eksperimental yang ingin meningkatkan kualitas dan kecepatan sekaligus melalui pendekatan berbasis spesifikasi
Filosofi inti: Core philosophy
- Pola pikir spec-first dengan pengembangan berbasis niat yang mendahulukan apa dan merinci bagaimana kemudian
- Menulis spesifikasi yang kaya dengan guardrail dan prinsip organisasi, serta melalui proses penyempurnaan bertahap alih-alih sekali jadi lewat pembuatan kode
- Berorientasi pada cara memanfaatkan kemampuan interpretasi model AI canggih secara aktif untuk mengubah spesifikasi menjadi hasil yang dapat dieksekusi
Proses berbasis spesifikasi dengan Spec Kit
- Spec Kit menempatkan spesifikasi sebagai pusat proses rekayasa, mendorong implementasi, checklist, dan pemecahan tugas, sementara pengembang terutama berperan sebagai pengarah
- Agen coding menangani sebagian besar pekerjaan penulisan
- Prosesnya terdiri dari 4 tahap, masing-masing memiliki checkpoint yang jelas, dan tidak berlanjut ke tahap berikutnya sampai pekerjaan saat ini tervalidasi sepenuhnya
- Tahap Specify: jika diberikan deskripsi tingkat tinggi, agen coding akan membuat spesifikasi terperinci yang berfokus pada perjalanan pengguna, pengalaman, dan metrik keberhasilan, bukan pada stack teknis
- Memetakan siapa penggunanya, masalah apa yang diselesaikan, bagaimana cara berinteraksi, dan hasil penting apa yang diharapkan
- Ini berbentuk artefak hidup yang berkembang seiring pembelajaran tentang pengguna
- Tahap Plan: jika diberikan stack, arsitektur, dan batasan yang diinginkan, agen coding akan menghasilkan rencana teknis yang komprehensif
- Mencakup teknologi standar perusahaan, integrasi sistem legacy, kepatuhan, target performa, dan lain-lain
- Bisa meminta beberapa variasi rencana untuk dibandingkan, dan jika dokumen internal disediakan, pola arsitektur dapat diintegrasikan secara langsung
- Tahap Tasks: berdasarkan spesifikasi dan rencana, agen coding memecah pekerjaan menjadi bagian-bagian kecil yang dapat ditinjau
- Setiap tugas dapat diimplementasikan dan diuji secara independen, serta dirancang agar AI dapat memvalidasi dan melacaknya
- Misalnya, alih-alih "membangun autentikasi", menjadi "membuat endpoint pendaftaran pengguna dengan validasi format email" yang lebih spesifik
- Tahap Implement: agen coding mengerjakan tugas satu per satu atau secara paralel, sementara pengembang meninjau perubahan yang terfokus
- Spesifikasi memberi tahu apa yang akan dibangun, rencana menjelaskan bagaimana membangunnya, dan tugas menunjukkan apa yang harus dikerjakan
- Di setiap tahap, pengembang melakukan peran validasi dengan merefleksikan dan menyempurnakan, memeriksa apakah spesifikasi menangkap niat dengan tepat, apakah rencana mempertimbangkan batasan nyata, serta apakah ada kekurangan atau edge case
Cara menggunakan Spec Kit dalam workflow agentic
- Spec Kit bekerja dengan agen coding seperti GitHub Copilot, Claude Code, Gemini CLI dan mengarahkan agen serta menghasilkan artefak melalui serangkaian perintah sederhana
- Ini mengubah prompt yang ambigu menjadi niat yang jelas agar dapat dieksekusi dengan andal
- Setelah inisialisasi proyek, berikan prompt tingkat tinggi dengan perintah /specify, lalu agen coding akan membuat spesifikasi lengkap yang berfokus pada "apa" dan "mengapa" proyek
- Dengan perintah /plan, berikan arah teknis tingkat tinggi, lalu agen coding akan membuat rencana detail yang menghormati arsitektur dan batasan
- Dengan perintah /tasks, spesifikasi dan rencana dipecah menjadi daftar tugas yang dapat dijalankan, dan agen coding mengimplementasikan kebutuhan proyek berdasarkan daftar tersebut
Tahap pengembangan: Development phases
- Tahap 0-to-1 (greenfield): mendukung alur pembuatan spesifikasi → penyusunan rencana → pembuatan aplikasi tingkat produksi berdasarkan kebutuhan tingkat tinggi
- Tahap eksplorasi kreatif: menekankan proses bereksperimen dengan berbagai stack/arsitektur dan pola UX melalui implementasi paralel
- Tahap perbaikan bertahap (brownfield): pengembangan evolusioner yang berulang untuk menambah fitur, memodernisasi legacy, dan menyesuaikan proses
3 skenario di mana pendekatan ini bekerja dengan baik
- Greenfield (zero-to-one): saat memulai proyek baru, alih-alih langsung menulis kode, spesifikasi dan rencana dibuat lebih dulu untuk memastikan AI membangun hal yang dimaksud, serta menghasilkan hasil yang disesuaikan alih-alih solusi generik berbasis pola umum
- Pekerjaan fitur pada sistem yang sudah ada (N-to-N+1): saat menambahkan fitur ke codebase yang kompleks, spesifikasi memperjelas interaksi fitur baru dengan sistem yang ada, dan rencana mengenkode batasan arsitektur sehingga kode yang dihasilkan terasa native
- Ini membuat pengembangan berkelanjutan lebih cepat dan aman, meski mungkin memerlukan teknik context engineering tingkat lanjut
- Modernisasi legacy: saat membangun ulang sistem legacy ketika niat aslinya sudah hilang, proses Spec Kit menangkap logika bisnis esensial ke dalam spesifikasi modern dan merencanakan arsitektur baru sehingga AI dapat membangunnya ulang tanpa utang teknis
Prasyarat
- Memerlukan Linux/macOS atau WSL2 di Windows
- Pilih salah satu dari Claude Code, GitHub Copilot, Gemini CLI, Cursor sebagai agen AI
Belum ada komentar.