Specs dan Agent Hooks di Kiro IDE: Cara Baru Kerja Bareng AI
Esc
Quick Actions
🏠 Go to Home g h
πŸ“ Go to Blog g b
⏰ What I'm doing now
πŸ‘€ About Me g a
Terminal Commands
$ ls posts List all blog posts
$ ls tags List all tags
$ cat about.md Read about page
$ cd ~ Go to home

Specs dan Agent Hooks di Kiro IDE: Cara Baru Kerja Bareng AI

Bukan sekadar autocomplete. Specs dan hooks mengubah cara kamu merencanakan, mengeksekusi, dan menjaga kualitas kode bersama AI agent.

Specs dan Agent Hooks di Kiro IDE: Cara Baru Kerja Bareng AI

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

EventKapan Jalan
fileEditedSaat file disimpan
fileCreatedSaat file baru dibuat
postTaskExecutionSetelah spec task selesai
preToolUseSebelum agent pakai tool
userTriggeredManual 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

  1. Tulis spec (requirements β†’ design β†’ tasks)
  2. Minta agent kerjakan Task 1
  3. Hook postTaskExecution β†’ auto pnpm run check
  4. Hook fileEdited β†’ verifikasi compliance
  5. Review hasil, approve atau minta revisi
  6. 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

⌨️ Keyboard Shortcuts

Navigation

g h
Go to Home
g b
Go to Blog
g a
Go to About

Actions

/ Search
? Show shortcuts
Esc Close overlay

Scrolling

j Scroll down
k Scroll up
g g
Scroll to top
G Scroll to bottom