AI & Machine Learning

Spec-Driven Development: Tulis Spesifikasi Dulu, Biarkan AI Agent Mengeksekusi

Setelah euforia vibe coding, tim mulai beralih ke spec-driven development: spesifikasi tertulis menjadi sumber kebenaran, AI agent menjadi eksekutor. Begini praktiknya.

NP
novan putra 29 Oktober 2026 · 3 mnt baca · 1.901 dilihat
Spec-Driven Development: Tulis Spesifikasi Dulu, Biarkan AI Agent Mengeksekusi

Awal 2026 kita membahas vibe coding — menulis software dengan mengikuti "vibe" bersama AI. Menjelang akhir tahun, banyak tim menemukan batasnya: prompt yang tersebar di chat tidak bisa di-review, sulit diulang, dan cepat dilupakan. Jawabannya adalah pendekatan yang makin populer: spec-driven development (SDD). Spesifikasi tertulis menjadi sumber kebenaran, dan AI agent menjadi eksekutornya.

Ide Dasarnya

Dalam SDD, kamu tidak langsung meminta agent "buatkan fitur X". Kamu menulis dokumen yang bisa dibaca manusia dan mesin:

  1. Spesifikasi — apa yang dibangun dan kenapa (tanpa detail teknis).
  2. Rencana — bagaimana membangunnya: arsitektur, data, batasan teknis.
  3. Tugas — pecahan kecil yang bisa dikerjakan dan diverifikasi satu per satu.

Ketiganya disimpan di repository, ikut di-review lewat pull request, dan menjadi konteks tetap bagi agent. Tools seperti GitHub Spec Kit dan IDE berbasis agent mempopulerkan alur ini.

Alur spec-driven development
Spesifikasi menjadi kontrak: manusia menyetujuinya, agent mengeksekusinya, test membuktikannya.

Contoh: Fitur "Simpan Artikel" di Blog

1. Spesifikasi

<!-- specs/simpan-artikel/spec.md -->
# Fitur: Simpan Artikel untuk Dibaca Nanti

## Masalah
Pembaca ingin menyimpan artikel panjang untuk dibaca nanti tanpa membuat akun.

## Cerita pengguna
- Sebagai pembaca, saya bisa menekan tombol "Simpan" di halaman artikel.
- Sebagai pembaca, saya bisa melihat daftar artikel tersimpan di /tersimpan.
- Sebagai pembaca, saya bisa menghapus artikel dari daftar.

## Kriteria diterima
- Data tersimpan di perangkat pembaca (tanpa login, tanpa server).
- Maksimal 50 artikel; yang tertua dihapus otomatis.
- Halaman tetap berfungsi normal jika penyimpanan browser diblokir.

## Di luar cakupan
- Sinkronisasi antar perangkat.

2. Rencana Teknis

<!-- specs/simpan-artikel/plan.md -->
## Pendekatan
- localStorage key `tersimpan`: array {slug, judul, waktu}
- Tombol di post.php (data-slug, data-judul), logika di assets/js/app.js
- Halaman /tersimpan: route baru di index.php, render daftar via JS

## Batasan
- Tanpa library baru. Semua akses localStorage dibungkus try/catch.
- Ikuti gaya CSS yang ada (variabel di :root).

3. Daftar Tugas

<!-- specs/simpan-artikel/tasks.md -->
- [ ] T1: Fungsi JS simpan/hapus/daftar + batas 50 item (dengan unit test)
- [ ] T2: Tombol "Simpan" di post.php, status berubah jadi "Tersimpan"
- [ ] T3: Route /tersimpan + halaman daftar dan tombol hapus
- [ ] T4: Uji manual: mode privat (storage diblokir) tidak error

4. Eksekusi dengan Agent

claude -p "Baca specs/simpan-artikel/*.md. Kerjakan HANYA tugas T1.
Tulis test dulu, jalankan, lalu implementasi sampai test lulus.
Centang T1 di tasks.md setelah selesai."

Satu tugas per sesi membuat setiap perubahan kecil, mudah di-review, dan mudah dibatalkan.

Kenapa Pendekatan Ini Bekerja?

Masalah vibe coding Solusi SDD
Prompt hilang di riwayat chat Spesifikasi tersimpan di repo
Agent menebak maksud Kriteria diterima tertulis jelas
Perubahan besar sekaligus Tugas kecil yang bisa diverifikasi
Sulit di-review tim Spec ikut di-review lewat PR

Tips Menulis Spesifikasi untuk Agent

  • Pisahkan "apa" dan "bagaimana" — spesifikasi untuk produk, rencana untuk teknis.
  • Tulis yang di luar cakupan — agent cenderung "membantu" berlebihan.
  • Kriteria yang bisa diuji — "cepat" itu ambigu; "di bawah 200 ms" bisa diuji.
  • Perbarui spec saat kebutuhan berubah — jangan hanya mengubah kode.

Kapan Tidak Perlu?

Untuk perbaikan typo, bug satu baris, atau eksperimen kilat, SDD terasa berlebihan. Gunakan untuk fitur yang melibatkan beberapa file, keputusan desain, atau akan dikerjakan bersama tim.

Penutup

Spec-driven development mengembalikan disiplin rekayasa perangkat lunak ke era AI: berpikir dulu, menulis kesepakatan, baru mengeksekusi. Agent menjadi jauh lebih bisa diandalkan ketika ia tahu persis apa yang dianggap "selesai". Coba untuk satu fitur berikutnya — mulai dari satu file spec.md.

NP
Ditulis oleh

novan putra

Penulis utama blog ini.

0 Komentar

Komentar ditinjau dulu sebelum tampil.