Specs dan Agent Hooks di Kiro IDE: Cara Baru Kerja Bareng AI
Kalau kamu sudah coba Kiro IDE, mungkin kamu langsung fokus ke fitur chat-nya. Wajar. Tapi ada dua fitur yang justru bikin Kiro berbeda dari AI coding tools lain: Specs dan Agent Hooks.
Masalah dengan AI Coding Tools Biasa
Skenario yang familiar: kamu minta AI untuk βbuatkan fitur notifikasiβ. AI langsung nulis kode, tapi hasilnya tidak sesuai arsitektur, lupa handle edge case, tidak konsisten dengan design system.
Masalahnya bukan AI-nya bodoh. Masalahnya adalah tidak ada kontrak yang jelas antara kamu dan AI tentang apa yang harus dibangun, bagaimana caranya, dan standar apa yang harus dipenuhi.
Specs dan hooks adalah jawaban Kiro untuk masalah ini.
Specs: Kontrak Tertulis antara Kamu dan AI
Spec adalah dokumen terstruktur yang mendefinisikan sebuah fitur sebelum satu baris kode pun ditulis. Strukturnya tiga file:
.kiro/specs/nama-fitur/
βββ requirements.md # Apa yang harus dibangun
βββ design.md # Bagaimana arsitekturnya
βββ tasks.md # Checklist implementasi
requirements.md β Kontrak Fungsional
Tulis apa yang harus bisa dilakukan fitur ini dalam bahasa kebutuhan, bukan teknis:
## R1 β Real-time Notifications
- R1.1: Notifikasi muncul tanpa page refresh via SSE
- R1.2: Badge count terupdate otomatis
- R1.3: Toast popup untuk notifikasi penting
Setiap requirement punya ID (R1.1, R1.2) supaya bisa direferensikan di tasks. AI agent tahu persis requirement mana yang sedang dikerjakan.
design.md β Kontrak Teknis
Definisikan arsitektur: file apa yang dibuat, data flow-nya bagaimana, interface TypeScript-nya seperti apa. AI membaca ini sebelum mulai coding β hasilnya langsung sesuai arsitektur yang kamu inginkan.
tasks.md β Kontrak Eksekusi
Ini yang paling powerful. Tasks adalah checklist yang dikerjakan agent satu per satu:
## Task 1 β SSE Endpoint
- [ ] Buat src/routes/api/notifications/stream/+server.ts
- [ ] Implementasi ReadableStream dengan heartbeat 30 detik
- [ ] Auth guard: redirect jika tidak login
- [ ] Jalankan pnpm run check
Kamu bilang βkerjakan Task 1β. Agent tahu persis scope-nya. Selesai, kamu review, baru lanjut Task 2.
Tanpa spec, AI bekerja seperti kontraktor tanpa blueprint. Dengan spec, kamu punya kontrol granular, konteks persisten, dan acceptance criteria yang jelas.
Agent Hooks: Guardrails Otomatis
Hooks adalah automation yang jalan sendiri saat event tertentu terjadi. Formatnya file .kiro.hook:
{
"enabled": true,
"name": "Type Check on Save",
"version": "1",
"when": {
"type": "fileEdited",
"patterns": ["src/**/*.svelte", "src/**/*.ts"]
},
"then": {
"type": "runCommand",
"command": "pnpm run check"
}
}
Setiap kali file .svelte disimpan, pnpm run check jalan otomatis.
Dua Jenis Action
runCommand β jalankan shell command langsung.
askAgent β minta AI agent melakukan sesuatu, misalnya verifikasi keamanan:
{
"enabled": true,
"name": "Payment Security Guard",
"version": "1",
"when": {
"type": "fileEdited",
"patterns": ["src/routes/api/payments/**"]
},
"then": {
"type": "askAgent",
"prompt": "File payment diedit. Verifikasi signature verification masih intact dan tidak ada security check yang dihapus."
}
}
Event Triggers
| Event | Kapan Jalan |
|---|---|
| fileEdited | Saat file disimpan |
| fileCreated | Saat file baru dibuat |
| postTaskExecution | Setelah spec task selesai |
| preToolUse | Sebelum agent pakai tool |
| userTriggered | Manual trigger |
Hooks sebagai Institutional Knowledge
Ini yang sering terlewat: hooks bukan hanya automation, tapi cara mengkodifikasi aturan tim ke dalam sistem. Aturan yang biasanya hidup di dokumen yang jarang dibaca, sekarang di-enforce otomatis.
Workflow Lengkap
- Tulis spec (requirements β design β tasks)
- Minta agent kerjakan Task 1
- Hook postTaskExecution β auto pnpm run check
- Hook fileEdited β verifikasi compliance
- Review hasil, approve atau minta revisi
- Lanjut Task 2
Kamu tetap yang memimpin. AI yang mengeksekusi. Hooks yang menjaga kualitas.
Coba Mulai dari Sini
Coba mulai dari satu spec kecil dan dua atau tiga hooks yang paling relevan dengan pain point tim kamu. Rasakan bedanya ketika AI tidak lagi mengarang sendiri arsitektur dan aturan, tapi membaca blueprint yang kamu kasih.
Karena yang lebih menarik lagi, Kiro punya dua wajah: IDE dan CLI. Kapan pakai yang mana? Yuk, kita bedah di artikel berikutnya.
Comments