Agentic Engineering: Spec-Driven Berbasis Risiko

Masalahnya

Bekerja dengan agen coding tanpa proses berarti dua ekstrem yang sama buruknya: semua perubahan lewat birokrasi spesifikasi penuh, atau semua perubahan langsung “vibe” tanpa jejak. Dan hampir semua pipeline yang ada merutekan pekerjaan berdasarkan ukuran — padahal ukuran adalah proksi yang buruk untuk risiko. Perubahan satu baris pada aturan pembulatan di billing berisiko tinggi; refactor 400 baris yang hanya menyentuh tes tidak.

Yang kami bangun

Plugin Claude Code untuk spec-driven development, diport dari pipeline internal yang sudah teruji pakai. /sdd adalah pintu depannya: deskripsikan pekerjaan dalam bahasa sehari-hari, dan plugin mengklasifikasikannya — bug, ide yang perlu discovery, atau perubahan yang sudah diputuskan — lalu men-skor empat sinyal (kesenjangan intent, ireversibilitas, footprint, delta perilaku) dan menetapkan tier:

• T0 — langsung dikerjakan; pesan commit membawa alasannya.
• T1 — micro-spec inline, diimplementasikan sesi itu juga.
• T2 — rencana dulu; setiap pertanyaan terbuka disetujui sebelum kode.
• T3/T4 — PRD → epic → story → implementasi test-first → review → penutupan.

Dua aturan membuat tier nol-proses itu aman: sinyal ireversibilitas apa pun memaksa minimal T2, berapa pun ukurannya, dan klasifikasinya ditulis ke file sehingga bisa di-override alih-alih diperdebatkan dengan proses.

Keputusan rekayasa

Loop yang menumpuk, bukan log yang dilupakan. Setiap story yang selesai mencatat jebakan yang tidak ditangkap test suite yang hijau, dan story berikutnya di permukaan yang sama diberi tahu. /story-close menanyakan satu hal per story: apa yang tadi dikerjakan manual yang seharusnya dikerjakan skrip atau tes — maksimal satu perbaikan, dan “tidak ada” adalah jawaban yang valid.

Kejujuran sebagai aturan, di mana-mana. Scan yang dilewati dilaporkan berbeda dari scan yang bersih. Verdict bug otomatis turun ke partial bila repro aslinya tidak pernah benar-benar dijalankan. “Tidak ada temuan” adalah hasil yang sah.

Lintas harness lewat adapter yang digenerasi. Skill-nya byte-identical di delapan harness lain — Cursor, Codex, Copilot, opencode, Cline, dan lainnya — digenerasi dari satu sumber oleh build-adapters.mjs (tidak pernah diedit tangan), dan setiap adapter membawa CAVEATS.md yang menyebut apa yang tidak bisa ditegakkan harness itu. Pipeline yang terlihat identik tapi diam-diam menjatuhkan satu gate lebih buruk daripada yang mengakuinya.

Menjalankan dan memverifikasinya

Tidak ada UI; artefaknya adalah praktik. Plugin dipasang lewat /plugin marketplace add dari repo GitHub privatnya, lalu /sdd-init sekali per repo. Verifikasinya tidak butuh layanan eksternal apa pun: claude plugin validate memeriksa manifest, node --test menjalankan suite helper CLI, dan CI menjalankan empat guard anti-drift — termasuk yang menggagalkan build bila sebuah skill menyebut tool spesifik (janji stack-agnostic bisa membusuk diam-diam) atau pohon adapters/ basi.