/goal için Nihai Kılavuz

/goal bir özellik değil. Bir ilkeldir.

HTTP bir ilkeldir. JSON bir ilkeldir. /goal, kodlama ajanları için bunlardan biri olmaya başlıyor.

Birkaç hafta önce OpenAI'ın Codex CLI'sı, kodlama çalışanına tanımlanmış bir bitiş durumuyla bir iş vermek için /goal ekledi. Claude Code de bu hafta ekledi.

Mac Mini'de kodlama çalışanları arasındaki işi koordine etmek için çalıştırdığım orkestratör Hermes Agent, bir süredir /goal desteğine sahipti.

Artık bir yapıcım, bir incelemecim ve bir orkestratörüm var; hepsi aynı komut formatını kabul ediyor, başka hiçbir ortak noktaları olmasa da.

/goal'u yalnızca daha süslü bir komut olarak gördüyseniz, neyi değiştirdiğini kaçırmışsınız.

/goal aslında nedir

Sıradan bir komut, ajandan bir sonraki yanıtı ister. Geleni okursunuz, doğru olup olmadığına karar verirsiniz ve ajayı bir sonraki adıma itersiniz. Her adımda siz yönlendirirsiniz.

/goal bunu tersine çevirir. "Bitti"nin nasıl göründüğünü yazarsınız, bir kez gönderirsiniz ve ajan oraya ulaşana kadar çalışır. İşte gerçek bir örnek:

1/goal SPEC.md dosyasında açıklanan uygulamayı oluştur. Bitti, testler geçtiğinde,
2derleme geçtiğinde, README doğru olduğunda ve git status yalnızca ilgili
3proje dosyalarını gösterdiğinde anlaşılır.

Hedef, başarılı olana, duraklatılana, engellenene, temizlenene veya bütçesi bitene kadar aktif kalır.

Bu, "goal" kelimesini normal bir tek seferlik komutun içine koymaktan farklıdır. codex exec 'goal: build the app' yazarsanız, bu yine de etiketli bir komuttur. Gerçek ilkel, etkileşimli bir çalışan oturumunun içinde yaşar. CLI'yi başlatırsınız, /goal gönderirsiniz ve başından ayrılırsınız.

Değişim, komut vermekten (sizin sürmeniz) atamaya (sizin tanımladığınız bir hedefe doğru ajanın sürmesi) geçiştir.

GIF

Şu anda /goal konuşan üç araç

/goal kabul eden üç araç aynı tür şeyler değil, bu yüzden spesifik olmakta fayda var.

Codex, OpenAI'ın kodlama CLI'sı. Özellikle net bir spesifikasyon verildiğinde uygulamada güçlü. /goal, bu spesifikasyonu verme şeklinizdir.

Claude Code, Anthropic'in kodlama CLI'sı. Bunun tersinde güçlü: doğru görünen kodda neyin yanlış olduğunu bulmak. Spesifikasyon uyumu, güvenlik sorunları, hata durumları, güvenlik açıkları. /goal, koda işaret edip inceleme isteme şeklinizdir.

Hermes Agent, tamamen farklı türde bir araçtır. Bir kodlama çalışanı değil, yukarıdaki iki araç gibi kodlama çalışanları arasındaki işi koordine eden bir orkestratördür. /goal, Hermes'in görevleri iş için doğru araca devretme şeklidir ve ayrıca Hermes'e ilk etapta ne istediğimi söyleme şeklimdir.

Önemli olan, herhangi birinin /goal özelliğini çıkarmış olması değil. Üç farklı ekibin aynı ilkel üzerinde birleşmesi ve bu birleşmenin onları bir araya getirmeyi mümkün kılmasıdır.

GIF

Kurulum

Hermes'i çalıştıran Mac Mini'de Codex ve Claude Code'a ilk ihtiyaç duyduğumda, bunları elle kurmadım. Hermes'e her ikisini de kurmasını ve beni giriş yapmasını isteyen bir mesaj gönderdim. Gerisini o halletti.

Artık iş akışı bu. Kurulum komutları yazmazsınız. Kurulum da sadece başka bir hedeftir.

Henüz çalışan bir orkestratörünüz yoksa, Codex ve Claude Code'un kurulum sayfalarını takip etmek yeterince kolaydır. Ancak bir kez kurduktan sonra, başka bir aracı elle kurmamalısınız. Bir orkestratöre sahip olmanın amacı, mekanik işlerin size ait olmaktan çıkmasıdır.

Hermes'in /goal'un üzerine ekledikleri

Çıplak bir /goal kendi başına kullanışlıdır. Ancak sizi bir koordinasyon sorunuyla baş başa bırakır.

Codex bir terminalde, Claude Code başka bir terminalde çalışıyorsa, hangi işlemin ne yaptığını hatırlamanız gerekir. Günlükleri kontrol etmeniz gerekir. İnceleme sonuçlarını bir araçtan diğerine manuel olarak iletmeniz gerekir.

Hermes bu dağınık çalıştırmaları bir iş akışına dönüştürür:

1. Hermes'e mesaj atarsınız (benim durumumda, telefonumdan Telegram üzerinden)
2. Hermes bir Kanban panosunda hedef kartları oluşturur
3. Hermes her kart için doğru çalışanı seçer
4. Çalışan hedefi arka planda çalıştırır
5. Kart, süreç kimliğini, PID'yi, depoyu ve bitirme kriterlerini saklar
6. Derleme hazır olduğunda, Hermes depoyu incelemecinin eline verir
7. İnceleme engellerse, Hermes bulguları bir düzeltme hedefi olarak geri gönderir
8. Hermes, dosya sistemini, testleri, derlemeyi ve git durumunu inceleyerek nihai çıktıyı doğrular

Pano, üzerinde bir orkestratör olduğunda /goal'un aldığı şeydir. Her hedefin bir kartı, her kartın bir durumu, her devir teslimin bir izi vardır. Terminallerde avlanmak yerine, işin telefonunuzda sütunlar arasında hareketini izlersiniz.

Üç rol

Araçlar değişir. Roller değişmez.

Orkestratör. Kontrol döngüsüne sahiptir. Görev ayrıştırma, çalışan seçimi, Kanban kartları, arka plan süreçleri, bağımlılıklar, nihai doğrulama, kullanıcıya yönelik özet. Benim kurulumumda Hermes.

Yapıcı. Bir spesifikasyon alır ve çalışan kod üretir. Uygulama, bu rolün çözdüğü darboğazdır. Codex burada genellikle güçlüdür.

İncelemeci. Yapıcının ürettiğini okur ve neyin yanlış olduğunu bulur. Doğruluk darboğazdır. Claude Code burada genellikle güçlüdür.

Uçtan uca gerçek bir çalıştırma

Hermes ajanına şu hedefi verdim:

1/goal Benimle ilgili X bahsini bulan ve bir şey patladığında
2beni uyaran bir CLI aracı oluştur.

Hermes isteği altı karta böldü.

Shubham Saboo

@Saboo_Shubham_

·

12 Mayıs

Codex /goal oluşturur.

Claude Code /goal inceler ve iyileştirir.

Hermes /goal orkestrasyonu ve devir teslimi yönetir.

Tamamı tek bir Kanban Panosunda izlenir ve ajanlar döngüde çalışmaya devam eder.

58

61

852

88K

Kart 1: Spesifikasyon. Hermes, SPEC.md dosyasını kendisi yazdı; yığını, depo yolunu, salt okunur kısıtlamaları, sahte mod gereksinimlerini, testleri ve doğrulama komutlarını yakaladı. PM rolüne ait.

Kart 2: Codex oluşturur. Codex, SPEC.md'ye karşı /goal çalıştırdı. Proje dosyalarını oluşturdu, UI ve arka ucu uyguladı, testler ekledi ve uygulamayı geçer bir duruma getirdi. Yaklaşık 15 dakika. İşi bitirdiğinde, npm test geçti, npm run build geçti ve git status yalnızca ilgili yeni dosyaları gösterdi.

Kart 3: Claude Code inceler. Claude Code, Codex'in oluşturduğunu incelemek için /goal çalıştırdı. Spesifikasyon uyumunu, salt okunur güvenliği, API anahtarı işlemeyi, hata durumlarını, testleri, UI kullanışlılığını, hataları ve güvenlik sorunlarını kontrol etti. Sonuç: GEÇTİ, engelleyici sorun yok.

Kart 4: Codex düzeltme döngüsü. Atlandı, çünkü inceleme geçti. Kart atlandığında hala önemlidir. Hermes'in koşullu iş modelleyebildiğini gösterir. Claude Code engellemiş olsaydı, Hermes bulguları yeni bir /goal olarak Codex'e geri verirdi.

Kart 5: Claude Code son doğrulama. Aynı nedenle atlandı.

Kart 6: Hermes son özet. Yerel yolda çalışan uygulama, UI ve API her ikisi de sahte modda doğrulandı. Codex /goal ile oluşturdu. Claude Code /goal ile inceledi ve GEÇTİ döndürdü.

Bunların tamamı tek bir mesajdan geldi. Üç farklı araç asıl işi yaptı, ama ben yalnızca Hermes ile konuştum.

Doğrulama kuralı

Hermes, Codex'in kendi bildirimine asla güvenmedi. Codex derlemeyi tamamlandı olarak işaretledikten sonra, Hermes komutları kendisi çalıştırdı:

1npm test         # 17 test geçti
2npm run build    # vite derlemesi geçti

Doğrulayıcı, /goal'u bir vaat değil, bir sözleşme yapan şeydir. Çalışanın kendi bildirimini nihai olarak kabul etmeyin. Doğrulayıcıya güvenin.

Kodlama ajanları kendinden emindir. Size derlemenin geçtiğini söylerler ama derleme hiç çalıştırılmamıştır. Size testlerin geçtiğini söylerler ama hiç çalıştırılmamış testler yazmışlardır. Doğrulayıcı bu boşluğu kapatır.

Doğrulama olmadan, /goal sadece daha süslü bir komuttur. Doğrulama ile bir sözleşme haline gelir.

GIF

Birden çok hedefi çalıştırma

Birden çok /goal'u paralel olarak çalıştırabilirsiniz, ancak önce düşünmeden birden çok kodlama çalışanını aynı dosyalara yönlendiremezsiniz.

Benim varsayılanım, depo başına bir ana yapıcıdır. Paralellik istersem, bunu net sınırlar boyunca eklerim. Farklı depolar, farklı dallar, git worktree'leri, ayrı paketler, dokümanlar vs kod, testler vs uygulama. İki çalışanın birbirine müdahale edemeyeceği her yer.

Kötü desen, üç çalışanın aynı depodaki aynı dosyayı düzenlemesidir. Çakışmalar, kısmi üzerine yazmalar ve bir çalışanın diğerinin işini sessizce geri almasıyla karşılaşırsınız.

Daha iyi desen, herhangi bir dosyada aynı anda tek bir yazar olmasıdır. Yapıcı yazar, incelemeci yalnızca okur, düzeltme hedefleri düzeltmeyle sınırlı kalır. Veya üç yapıcıyı üç worktree'de üç rakip yaklaşım üzerinde çalıştırın ve orkestratörün en iyisini seçmesine izin verin.

Panoyu pratik kılan şey budur. O olmadan, paralel arka plan çalışanları terminal kaosuna dönüşür.

Benim için ne değişiyor

Buradaki faydalı çerçeve "arka planda ajan çalıştırabiliyorum" değil.

Tek bir mesajın üç farklı kodlama aracı arasında bir boru hattına dönüşmesi ve tüm işin tek bir panoda sütunlar arasında hareketini izlememdir.

Bir terminalde oturup bir ajanın bitirmesini beklemekten vazgeçer ve görünür durumu olan bir iş kuyruğunu yönetmeye başlarsınız.

Codex ve Claude Code kendi iş devir teslim formatlarını icat etmiş olsalardı, hiçbir orkestratör aralarında yönlendirme yapamazdı. Pano etkileyici, ancak ilkel, panoyu daha da kullanışlı kılıyor.

Çalışanlar değişebilir, ancak ilkel aynı kalır. /goal'u benimseyen bir sonraki kodlama aracı, hiçbir şeyi değiştirmeden bu boru hattına katılacak. Sadece işi ona yönlendireceğim.

İyi ilkeller böyle çalışır.

Hermes, OpenClaw, Claude Code, Codex ve diğer 7/24 ajan ekipleri hakkında daha fazla harika ipucu ve ilginç fikir için.

Takip et → @Saboo_Shubham_