Hermes Kanban: AI Temsilcileriniz için Görev Kontrol Merkezi

Hermes Kanban'ın kapsamlı bir anlatımı: koordinasyon modeli, ajanlar arasında bağlam paylaşımı ve yaklaşık 20 dakikada 4 ajanlı bir yazılım ekibi (PM, backend, frontend, testçi) kurma.

Yapay zeka ajanlarının bir ekip gibi çalışması gerekiyordu.

Sen hedefi anlatıyorsun. Onlar işi bölüşüyor. Her biri kaldığı yerden devam ediyor.

Kulağa hoş gelen fikir bu. Gerçekte olan ise tam tersi. Ajanlar boş bir sayfayla başlıyor. Bir ajan diğerlerinin ne inşa ettiğini, hangi dosyaların değiştiğini veya API'nin neye benzediğini bilmiyor. Her devir teslim soğuk bir başlangıç oluyor ve iş bir ajandan diğerine geçtiği anda bozuluyor.

Hermes Kanban bunu düzeltiyor. Her görev çökmelere ve yeniden başlatmalara karşı dayanıklı. Her brifing, bir sonraki ajanın ihtiyacı olan her şeyi tam olarak içeriyor. Her başarısızlık kaydediliyor, böylece yeniden deneme neyin bozulduğunu biliyor.

Görev kontrol merkeziniz şöyle görünüyor:

Kanban panosu

En iyi yanı ise tüm ekibin telefonunuzdan yönetilebilmesi. Telegram üzerinden görevler oluşturup yönlendiriyorsunuz ve siz masanızdan uzaktayken ajanlar bu görevleri devralıyor.

Şuna bir bakın:

Bu yazıda, bu kurulumu sıfırdan inşa ediyoruz: koordinasyon modeli, brifingler ve kendi donanımınızda çalışan 4 kişilik bir yazılım ekibi. Yaklaşık 20 dakika sürüyor.

Bunu göstermek için, tam da bu ajan ekibi tarafından oluşturulmuş, AI özellikleri ve prodüksiyona hazır backend'i olan çalışan bir Google Dokümanlar benzeri oluşturdum.

Google dokümanlar benzeri demo

Uzun lafın kısası, hemen başlayalım.

Neden tek bir ajan yeterli değil

Diyelim ki bir şifre sıfırlama özelliği eklemek istiyorsunuz. İş üç alana ayrılır:

• REST API'yi inşa eden bir backend geliştiricisi
• Bu API'yi okuyup üzerine kullanıcı arayüzü inşa eden bir frontend geliştiricisi
• Tüm sistemi uçtan uca doğrulayan bir testçi

1'e karşı 3 Ajan

Üçünü de tek bir ajan üzerinden yürütebilirsiniz, ancak bağlam penceresi dolar ve ajan üç adım önce ne yaptığını unutur. Onu yönetmek, size kazandırdığı zamandan daha fazla zaman harcamanıza yol açar.

İşi, her biri bir alana sahip olan ajanlar arasında bölmek farklı bir sorun yaratır: Frontend geliştiricisi, backend geliştiricisinin ne inşa ettiğini nasıl bilecek? İşte Hermes Kanban'ın çözdüğü paylaşılan bağlam sorunu budur.

Zihinsel model: bir görev panosu, ancak sütunların arkasında ajanlar var

Her görevin bir başlığı, bir açıklaması, bir sahibi ve bir durumu vardır. Birisi onu alır, panoda ilerletir ve kapatır. Pano, tek doğruluk kaynağıdır.

Hermes Kanban bu modeli korur ve insanlar yerine her sütunun arkasına ajanlar koyar.

Hermes Kanban Panosu

Her görev, çökmelere ve yeniden başlatmalara dayanıklı bir satırdır. Bir ajan işini bitirdiğinde bir özet yazar: değiştirilen dosyalar, inşa ettiği şey, bir sonraki ajanın bilmesi gerekenler. Bir sonraki ajan, başlamadan önce bu özeti okur.

İşte bütün sır bu özette. Bir grup ajanı yabancılardan ziyade bir takıma dönüştüren şey budur.

Sözlük

Kanban panosunda 6 farklı sütunumuz var:

• Triage (Ön Değerlendirme): Kaba fikirler buraya gelir. Tam bir spesifikasyonunuz olmadan "kimlik doğrulama hız sınırlaması istiyorum" gibi şeyler için idealdir.
• Todo (Yapılacak): Görev oluşturuldu ancak bir bağımlılığı bekliyor. Üst görevi tamamlanana kadar ilerlemez.
• Ready (Hazır): Bağımlılıklar karşılandı, bir ajanın alması bekleniyor.
• In Progress (Devam Ediyor): Bir ajan aktif olarak çalışıyor.
• Blocked (Engellendi): Ajan bir duvara çarptı ve bir insana işaretledi. Siz engeli kaldırana kadar hiçbir şey çalışmaz.
• Done (Tamamlandı): Tamamlandı, çalıştırma geçmişi, özet ve meta veriler korunur.

Orkestratör: diğerlerini yöneten bir ajan

Orkestratör ajanını, üst düzey bir hedefi okuyan, hangi ajanların mevcut olduğunu kontrol eden, hedefi birbirine bağlı görevlere bölen ve geri çekilen bir proje yöneticisi olarak düşünün. Asla kod yazmaz veya test çalıştırmaz. Koordinasyon sağlar.

Orkestratör ajanı

Önemli olan tek kural: Görevleri oluşturmadan önce hangi profillerin mevcut olduğunu kontrol edin. Sistem, atanan kişisi gerçek bir profille eşleşmeyen herhangi bir görevi sessizce atlar, bu nedenle sıfırıncı adım her zaman kanban_list olur.

İşte tipik bir proje yöneticisi adımı, bir "şifre sıfırlama akışı oluştur" talebini birbirine bağlı bir işlem hattına ayırıyor:

1kanban_show()
2
3be = kanban_create(title="Password reset backend", assignee="backend-developer",
4    body="Forgot/reset password flow + session invalidation")
5
6fe = kanban_create(title="Password reset UI", assignee="frontend-developer",
7    parents=[be], body="Next.js reset flow using backend API")
8
9qa = kanban_create(title="E2E password reset test", assignee="tester",
10    parents=[fe], body="Validate all acceptance criteria")
11
12kanban_complete(summary="Created backend → frontend → QA dependency pipeline")

Bundan sonra, pano yükseltmeyi, brifingler de bağlamı halleder. Üçü de bittiğinde, proje yöneticisi uyanır, özetleri okur ve işin bitip bitmediğine karar verir. Testçi "verdict": "FAIL" döndürürse, düzeltme görevleri oluşturur ve döngü devam eder.

Ancak gerçekte, hiçbir şeyle ilgilenmenize gerek yok. Sadece Telegram'dan bir görev atamanız yeterli, orkestratör oradan devralır.

Sürekli kullanacağınız üç desen

1. İşlem hattı:Her görev bir öncekine bağlıdır. Sadece ilki hazır durumda başlar. Diğer her şey sırasını bekler.

1BACKEND=$(hermes kanban create "Implement auth API" \
2    --assignee backend-developer \
3    --body "POST /register, POST /login, POST /refresh, POST /logout." \
4    --json | jq -r .id)
5
6FRONTEND=$(hermes kanban create "Build auth UI" \
7    --assignee frontend-developer \
8    --parent $BACKEND \
9    --body "Read backend handoff for API shape. Login, register, profile pages." \
10    --json | jq -r .id)
11
12hermes kanban create "Test auth flow end to end" \
13    --assignee tester \
14    --parent $FRONTEND \
15    --body "Cover happy path, wrong password, expired token, session persistence."

Bunu elle çalıştırmazsınız. Projeyi Telegram'daki proje yöneticisine anlatırsınız ve o sizin için bu görevleri oluşturur. Perde arkasında yukarıdaki gibi görünür.

Backend ajanı kanban_complete() işlevini çağırdığında, frontend görevi, backend'in çalışması eklenmiş olarak hazır duruma geçer.

2. Döngüde insan:Her engelleyici bir başarısızlık değildir. Bazen bir ajan gerçek bir sorun bulur ve sormak için durur.

1kanban_block(reason="review-required: password strength check missing, "
2           "reset tokens aren't single-use (can be replayed within 30 min)")

Engeli panoda görürsünüz. Sorunu doğrular, düzeltir ve görevin engelini kaldırırsınız:

1hermes kanban unblock $IMPL

Bunu da terminalde çalıştırmazsınız. Sadece Kanban panosuna yorum yapın veya Telegram'dan mesaj atın, sistem engeli kaldırır.

Sistem, bir sonraki döngüde ajanı yeniden başlatır. İkinci çalıştırma kanban_show() işlevini çağırır ve ilk denemenin neden engellendiğini tam olarak görür. Tam olarak neyi düzeltmesi gerektiğini bilir; sıfırdan başlamaz.

3. Ön değerlendirme belirleyici.

Tam bir spesifikasyon yerine kaba bir fikriniz olduğunda, onu panoya bırakın ve herhangi bir ajan almadan önce sistemin detaylandırmasına izin verin.

1# Kaba bir fikir bırak
2hermes kanban create "auth needs rate limiting" --triage --assignee backend-developer
3
4# Dağıtıcı almadan önce detaylandır
5hermes kanban specify $TASK_ID

specify komutu, üç kelimelik başlığı bir hedef, bir yaklaşım ve kabul kriterleri ile eksiksiz bir göreve dönüştürür. Onu alan ajan gerçek bir brifing alır.

Kurulum: yaklaşık 20 dakikada dört profil

Dört ajan, paylaşılan bir pano, Telegram üzerinden ulaşılabilen bir proje yöneticisi.

Adım 1: Profilleri oluşturun.

1hermes profile create project-manager --clone
2hermes profile create backend-developer --clone
3hermes profile create frontend-developer --clone
4hermes profile create tester --clone

--clone, varsayılan profilinizin yapılandırmasını başlangıç noktası olarak kopyalar.

Adım 2: Her ajana bir kişilik verin

1. Proje Yöneticisi ~/.hermes/profiles/project-manager/SOUL.md konumunda:

1# Soul
2
3Sen bir yazılım geliştirme ekibinin proje yöneticisisin. Görevin,
4kullanıcının bir uygulama fikrini almak, net görevlere bölmek, bunları
5doğru ekip üyelerine atamak ve Kanban panosunda ilerlemeyi takip etmektir.
6Kendin kod yazmazsın. İşi yönetirsin.

2. Backend Geliştiricisi ~/.hermes/profiles/backend-developer/SOUL.md konumunda:

1# Soul
2
3Sen bir yazılım ekibinin backend geliştiricisisin. Tüm backend'i
4InsForge kullanarak inşa eder ve yönetirsin — veritabanı, kimlik doğrulama,
5depolama, edge fonksiyonları ve dağıtım.

3. Frontend Geliştiricisi ~/.hermes/profiles/frontend-developer/SOUL.md konumunda:

1# Soul
2
3Sen bir yazılım ekibinin frontend geliştiricisisin. Kullanıcı arayüzünü —
4bileşenler, sayfalar ve kullanıcı akışları — inşa eder ve bunları backend
5geliştiricisinin kurduğu API'leri ve SDK yöntemlerini kullanarak backend'e
6bağlarsın.

4. Testçi ~/.hermes/profiles/tester/SOUL.md konumunda:

1# Soul
2
3Sen bir yazılım ekibinin testçisisin. Tamamlanan özellikleri uçtan uca
4test eder, kabul kriterlerinin karşılandığını doğrular ve hataları
5düzeltilebilmeleri için net bir şekilde Kanban panosuna bildirirsin.

Adım 3: Ajan becerileri ekleyin

Beceriler, belirli iş türlerinin nasıl yapılacağına dair adım adım kılavuzlardır. Bunları ajanlarınız için iş başı eğitimi olarak düşünün. Bunları tek tek sıralayalım:

InsForge

InsForge (açık kaynak, Apache 2.0), Beceriler ve CLI kullanan ajanlar için backend bağlam mühendisliği katmanı olarak çalışır. Backend geliştirici ajan profillerimiz, projeler için kullanıma hazır bir backend hizmetine sahip olmak üzere bu beceriyi kullanır.

İlk olarak, InsForge becerilerini ekleyin:

1hermes skills tap add InsForge/insforge-skills

Ardından backend becerilerini yükleyin:

1hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force

Aynı şekilde, diğerlerini insforge-cli (altyapı komutları), insforge-debug (hata teşhisi) ve insforge-integrations (üçüncü taraf kimlik sağlayıcıları) olarak kuruyoruz.

Backend geliştirici ajanının, projemizin backend'ini InsForge üzerinde inşa etmek için beceriyi nasıl kullandığı aşağıda açıklanmıştır.

İlk olarak backend geliştirici ajanı InsForge'da "Google Dokümanlar Klonu" adlı bir proje oluşturur.

Pano, Kullanıcı sayısı, Veritabanındaki tablolar, Depolama ve kimlik doğrulama, belge işleme vb. ile ilgili dağıtılmış JavaScript/TypeScript koduna sahip Edge Fonksiyonlarının listesi gibi proje istatistiklerini gösterir.

Yani bir AI backend mühendisi inşa ediyorsanız, InsForge'a mutlaka göz atın →

(yıldız 🌟 vermeyi unutmayın)

Beceri Merkezi'nden daha fazla beceri

Hermes ayrıca 18 kategoride 687 beceriye sahip bir Beceri Merkezi'ne sahiptir: 87'si yerleşik, 79'u isteğe bağlı, 16'sı Anthropic'ten (frontend-design, pdf, pptx, docx, mcp-builder ve daha fazlası) ve 505'i LobeHub'dan.

Frontend geliştirici için frontend-design becerisini yükleyin. Testçi için webapp-testing becerisini yükleyin. Her ikisi de Merkez'de bulunur.

Adım 4: Panoyu başlatın ve ağ geçidini başlatın.

hermes kanban init, her görevi, bağlamı ve çalıştırma geçmişini tutan SQLite veritabanı ~/.hermes/kanban.db dosyasını oluşturur.

Ardından, proje yöneticisi profili altında sohbet ağ geçidini ayarlayın. Telegram'daki @BotFather'dan bir bot token'ı ve @userinfobot'tan kullanıcı ID'nizi alın, ardından:

1hermes kanban init
2hermes -p project-manager gateway setup
3hermes -p project-manager gateway start

Bağlantı 7/24 çalışır, sistemi canlı tutar ve proje yöneticisine Telegram üzerinden ulaşılmasını sağlar.

Adım 5: İlk projenizi gönderin.

Proje yöneticisine ne inşa edilmesini istediğinizi mesaj olarak gönderin. Hedefi görevlere böler, bağımlılık bağlantılarıyla oluşturur ve sistem bunları sırayla çalıştırır.

Pano

hermes dashboard komutunu çalıştırın ve http://127.0.0.1:9119 adresini açın. Her durum için bir sütun ve yenileme gerektirmeyen WebSocket üzerinden canlı güncellemeler alırsınız.

0:20

Hermes kanban panosu

Bilmeye değer iki kontrol var. Lanes by profile (Profile göre şeritler), Çalışan sütununu atanan kişiye göre alt gruplara ayırır, böylece hangi ajanın neye sahip olduğunu bir bakışta görebilirsiniz. Nudge dispatcher (Dağıtıcıyı dürt), 60 saniye beklemek yerine hemen bir geçiş çalıştırır; bu, bir görevin engelini kaldırdıktan hemen sonra işe yarar.

Herhangi bir karta tıklayarak, tam çalıştırma geçmişini, her denemenin sonucunu ve meta verilerini ve ayrıca başlık, atanan kişi, öncelik ve bağımlılıklar için düzenlenebilir alanları görmek için çekmecesini açın.

Dikkat edilmesi gerekenler

Ciddi bir iş yükünden önce bilinmesi gereken üç hata modu.

1. Veritabanı aşırı yüklenmesi. Paralel olarak 2 ila 4 ajanla bunu asla yaşamazsınız. 10'dan fazla ajan yüksek frekansta yazma yaptığında işler yavaşlar. Bunu hermes kanban dispatch --max 4 ile sınırlayın.

2. Çalışma alanı silme. Bir çalışma alanına kaydedilen dosyalar, görev tamamlandı olarak işaretlendiği anda kaybolur çünkü çalışma alanı tasarım gereği temizlenir. Kodlama görevleri için worktree kullanın veya görev tanımına proje klasörü yolunu koyun, böylece ajan nereye kaydedeceğini bilir.

3. Yerel model doygunluğu. Yerel bir modele (Ollama, yerel GPU) karşı sistem, aynı anda birkaç ajanı başlatabilir ve GPU'yu aşırı yükleyebilir, bu da oluşturmayı yavaşlatır ve otomatik durdurmayı tetikler. Yerel kurulumlar için hermes kanban dispatch --max 2. Claude veya GPT-4o gibi API tabanlı modellerde bu nadiren sorun olur.

Tam resim

Her bir parçanın bir işi vardır:

• SOUL.md, ajanın sabit kimliğidir: kim olduğu ve nasıl düşündüğü.
• Beceriler, belirli iş türleri için adım adım talimatlardır.
• Hafıza, ajanın ortamınız hakkında oturumlar arasında bildiği şeydir.
• Kanban, koordinasyon katmanıdır: paylaşılan durum, bağlam aktarımı ve herhangi bir noktada döngüde bir insan.

Dört profil, dört SOUL.md dosyası, bir ağ geçidi başlatma. Proje yöneticisine Telegram üzerinden ne inşa edilmesini istediğinizi anlatın ve panonun dolmasını izleyin.

Videodan daha iyi öğreniyorsanız, Hermes Kanban'ın tam bir anlatımı birkaç gün içinde YouTube ve X'te yayınlanacak.

Okuduğunuz için teşekkürler.