Tutorial Kanban di Hermes Agent

Apa Itu Kanban di Hermes?

Kanban di Hermes bukan sekadar "papan tugas" biasa. Ini adalah system antar-agent yang memungkinkan beberapa Hermes agent (disebut profile) saling berbagi dan mengerjakan task secara bersamaan.

Bayangkan kamu punya 3 orang asisten:

• Agent A - spesialis riset
• Agent B - spesialis coding
• Agent C - spesialis review

Kanban adalah "meja kerja bersama" tempat mereka semua bisa melihat task, mengambil pekerjaan, melaporkan progress, dan menyerahkan hasil.

Cara Kerja Sederhana

Dua "Pintu Masuk" ke Board

Ada dua cara mengakses kanban board yang sama:

Kedua akses ini terhubung ke database yang sama (~/.hermes/kanban.db), jadi datanya selalu konsisten.

Kanban vs delegate_task: Kapan Pakai yang Mana?

Hermes punya dua cara untuk mendelegasikan kerja. Pahami bedanya supaya tidak salah pilih:

Contoh nyata: delegate_task = "tolong carikan harga tiket pesawat". Kanban = "bangun fitur auth dari awal sampai deploy, dengan riset, coding, dan review terpisah".

Setup Awal (3 Langkah)

bashhermes kanban init

bashhermes dashboard

bashhermes kanban create "Tulis artikel tentang AI" \
  --assignee writer-agent \
  --body "Buat artikel 1000 kata tentang tren AI 2026"

7 Status Task (Lifecycle)

Setiap task di Kanban punya status. Pahami alurnya supaya tahu task ada di tahap mana:

Command CLI Lengkap

Semua command dimulai dengan hermes kanban. Ini cheat sheet yang bisa kamu copy-paste:

Task Management

membuat task# Task sederhana
hermes kanban create "Judul task" --assignee nama-profile

# Task dengan detail lengkap
hermes kanban create "Bangun API auth" \
  --assignee backend-dev \
  --body "Buat endpoint POST /login, POST /register" \
  --priority 2 \
  --tenant project-alpha

# Task dengan dependency (parent-child)
hermes kanban create "Tulis unit test" \
  --assignee tester \
  --parent <id-task-parent>

# Hasil: JSON (untuk scripting)
hermes kanban create "Task" --assignee x --json | jq -r .id

Melihat Task

inspeksi# List semua task
hermes kanban list

# Filter berdasarkan status
hermes kanban list --status blocked
hermes kanban list --status running

# Filter berdasarkan assignee
hermes kanban list --assignee backend-dev

# Detail satu task (termasuk komentar)
hermes kanban show <id>

Mengubah Status

status changes# Selesai
hermes kanban complete <id>

# Block (butuh input manusia)
hermes kanban block <id> --reason "Butuh API key untuk lanjut"

# Unblock
hermes kanban unblock <id>

# Arsip
hermes kanban archive <id>

Kolaborasi

komentar dan link# Tambah komentar
hermes kanban comment <id> "Kode sudah di-push ke branch feature/auth"

# Link task (parent-child dependency)
hermes kanban link <parent-id> <child-id>

# Hapus link
hermes kanban unlink <parent-id> <child-id>

Debug dan Monitoring

observability# Lihat statistik board
hermes kanban stats

# Lihat log worker terakhir
hermes kanban log <id>

# Tail semua aktivitas (real-time)
hermes kanban tail

# Lihat run history
hermes kanban runs <id>

3 Contoh Workflow Nyata

Ini tiga skenario dari yang paling sederhana sampai yang kompleks. Pilih sesuai kebutuhanmu.

1. Solo Dev (Paling Sederhana)

Kamu sendiri yang bekerja, tapi pakai Kanban untuk mengorganisir dan memastikan tidak ada yang terlewat.

bash - buat 3 task berurutan# Buat task induk
SCHEMA=$(hermes kanban create "Desain schema database" \
  --assignee default \
  --priority 2 \
  --body "Buat schema untuk tabel users, sessions, tokens" \
  --json | jq -r .id)

# Task anak: bergantung pada schema
API=$(hermes kanban create "Implementasi API endpoint" \
  --assignee default \
  --parent $SCHEMA \
  --body "POST /register, POST /login, POST /refresh" \
  --json | jq -r .id)

# Task cucu: bergantung pada API
hermes kanban create "Tulis integration test" \
  --assignee default \
  --parent $API \
  --body "Test semua endpoint dengan pytest"

Alur otomatisnya: Task API baru jadi ready setelah Schema selesai. Task Test baru jadi ready setelah API selesai. Kamu tinggal kerjakan satu per satu.

2. Team Pipeline (Multi-Role)

Beberapa agent dengan peran berbeda mengerjakan task secara berurutan.

bash - pipeline 3 agent# Step 1: Riset oleh researcher
hermes kanban create "Riset tren AI 2026" \
  --assignee researcher \
  --priority 3

# Step 2: Tulis oleh writer (nanti di-link)
hermes kanban create "Tulis artikel berdasarkan riset" \
  --assignee writer \
  --priority 2

# Step 3: Review oleh editor
hermes kanban create "Review dan edit artikel" \
  --assignee editor \
  --priority 1

# Link semua: researcher -> writer -> editor
hermes kanban link <riset-id> <writer-id>
hermes kanban link <writer-id> <editor-id>

Dispatcher otomatis menjalankan researcher duluan. Setelah selesai, writer jalan. Setelah writer selesai, editor jalan. Semua otomatis.

3. Fleet Farming (Satu Spesialis, Banyak Target)

Satu agent type mengelola banyak instance. Cocok untuk: monitoring banyak server, manage banyak akun, proses banyak data.

bash - fleet contoh# Satu "fleet manager" dengan banyak task sejenis
for server in server-1 server-2 server-3 server-4 server-5; do
  hermes kanban create "Check health $server" \
    --assignee monitor \
    --tenant $server \
    --body "Cek CPU, RAM, disk, restart service jika perlu"
done

Tenant memisahkan data setiap server. Satu agent profile "monitor" mengerjakan semuanya, tapi data per server tetap terisolasi.

Cara Agent (Worker) Berinteraksi dengan Board

Agent yang di-spawn oleh dispatcher punya toolset khusus untuk berinteraksi dengan kanban. Ini yang mereka bisa lakukan:

Contoh Alur Worker

worker tool calls (apa yang agent lakukan)# 1. Agent di-spawn oleh dispatcher
# 2. Agent baca task-nya:
kanban_show(id="abc123")

# 3. Agent mulai kerja, laporkan progress:
kanban_comment(id="abc123", body="Mulai riset, target 5 sumber")

# 4. Selesai, tandai done:
kanban_complete(id="abc123", summary="Artikel 1200 kata, 5 referensi")

# ATAU kalau ada masalah:
kanban_block(id="abc123", reason="Butuh API key OpenAI untuk lanjut")

Multi-Board (Proyek Terpisah)

Kalau kamu punya beberapa proyek yang tidak saling berhubungan, kamu bisa buat board terpisah untuk masing-masing.

bash - mengelola board# Lihat semua board
hermes kanban boards list

# Buat board baru
hermes kanban boards create web-project \
  --name "Web Development" \
  --description "Proyek website klien" \
  --icon "web" \
  --switch  # langsung jadi board aktif

# Operasi di board spesifik tanpa switch
hermes kanban --board web-project create "Deploy staging" \
  --assignee devops

# Ganti board aktif
hermes kanban boards switch default

Kapan Pakai Multi-Board?

• Satu board: Kalau semua kerjaanmu saling berhubungan (satu proyek besar)
• Multi-board: Kalau kamu punya proyek terpisah yang tidak boleh bercampur (proyek klien A vs B, atau dev vs ops)

8 Pola Kolaborasi

Ini pola-pola yang bisa kamu bangun dengan Kanban. Tidak semua perlu, tapi bagus untuk diketahui:

Best Practices dan Anti-Patterns

Yang Harus Dilakukan

• Selalu kasih body saat create task. Worker butuh konteks yang cukup untuk kerja tanpa nanya balik.
• Pakai komentar untuk komunikasi. Jangan berharap worker bisa baca pikiran. Tulis instruksi jelas.
• Pakai tenant untuk isolasi data. Kalau satu agent handle banyak klien/server/pasar.
• Cek blocked tasks secara berkala. hermes kanban list --status blocked.
• Pakai priority. Angka lebih tinggi = lebih prioritas. Default 0.
• Gunakan hermes kanban tail untuk memantau aktivitas real-time.
• Archive task lama. Board bersih = dispatcher cepat.

Yang Harus Dihindari

Workspace: Pilih yang Tepat

Config yang Perlu Diketahui

config.yaml# Di ~/.hermes/config.yaml
kanban:
  dispatch_in_gateway: true    # Dispatcher jalan di dalam gateway
  failure_limit: 2             # Auto-block setelah 2x gagal spawn
  dispatch_interval: 60        # Dispatcher jalan setiap 60 detik
  orchestrator_profile: default # Profile yang handle triage
  auto_decompose: true         # Auto-pecah task di triage