RADAR'a dön

Nasıl çalışır

RADAR nasıl çalışır.

Geliştiriciler için teknik bir bakış. RADAR kodlama ajanlarını çalıştırır ve bir görevi ancak o görevin kabul testini kendisi yeniden çalıştırdıktan sonra kapatır. Bir ajanın “bitti” demesi bir beyandır; yeniden çalıştırma ise kanıttır.

01 Döngü

Her görev için tek bir döngü.

Her görev aynı döngüden geçer ve her adım yalnızca bir önceki adım geçtiyse çalışır.

  1. 01 · açılış Görev ve kabul testi İş başlamadan önce yazılır
  2. 02 · lease Tek sahip, kendi worktree'si Lease ve fence token
  3. 03 · çalışma Ajan çalışır Projenin kendine ait kopyasında
  4. 04 · beyan Ajan “bitti” der Sonuç olarak değil, beyan olarak kaydedilir
  5. 05 · doğrulama RADAR testi yeniden çalıştırır Güncel revizyon üzerinde
  6. geçerse Kapandı Kanıt kayıtta saklanır
  7. geçmezse · deneme n / 3 Yeniden açıldı, hata eklendi Aynı ajan 03. adımdan yeniden dener
  8. 3 denemeden sonra Başka bir ajan devralır 03. adımdan itibaren en fazla 3 deneme daha
  9. 3 deneme daha sonra Görev sizi bekler Kayıt yeni denemeleri reddeder
Şekil 1 · Görev döngüsü. Beyan, doğrudan kapanışa değil, her zaman yeniden çalıştırmaya götürür.
Açılış
Bir görev, hedefi ve yeniden çalıştırılabilir bir kabul komutuyla açılır. Komut, görev açılırken çalıştırılmadan kontrol edilir: yazıldığı hâliyle çalışamayacak bir ölçüt sonda fark edilmez, daha o anda reddedilir.
Lease
Bir görevin aynı anda yalnızca bir sahibi olur; bunu bir lease ve bir fence token sağlar. Güncelliğini yitirmiş bir sahibin yazma isteği reddedilir.
Çalışma
Ajan kendi git worktree'sinde, kendi branch'inde çalışır.
Beyan
Ajanın işin bittiğini bildirmesi beyan olarak kaydedilir. Beyan görevi kapatmaz.
Doğrulama
RADAR kabul komutunu, işin güncel revizyonu üzerinde kendisi çalıştırır. Ajanın kendi raporu okunur ama kanıt sayılmaz.
Kapatma ya da yeniden açma
Test geçerse görev kapanabilir; doğrulama kaydı kanıtı olarak saklanır. Geçmezse görev, hatayla birlikte yeniden açılır.
Sınırlar
Worker için üç deneme, ardından başka bir ajanın üç kez devralması. Bundan sonra kayıt yeni denemeleri reddeder ve görev sizi bekler. Model, oturum ya da makine değiştirmek sayacı sıfırlamaz; her yeniden deneme neyin değiştiğini belirtmek zorundadır.

02 Kayıt

Her ajanın yazdığı tek bir kayıt.

Her ajan aynı görev kaydını okur ve ona yazar: yerel bir SQLite dosyası. Hangi görevin kimde olduğunu, neyin beyan edildiğini ve testin ne gösterdiğini tutan tek kayıt budur.

Görevler
İş başlamadan önce yazılan hedef ve kabul komutu.
Sahiplik
Her görevin güncel sahibi, lease ve fence token'ıyla birlikte.
Denemeler
Görev başına sayılır; ajan, model ya da makine değişse de sayım sürer.
Beyanlar
Bir ajanın işin bittiğine dair bildirimi; sonuçlardan ayrı tutulur.
Doğrulama kayıtları
Her kabul çalıştırması, üzerinde çalıştığı commit'e ve çalışma ağacına bağlanır.
Değişiklikler
Değiştirilen bir kabul komutu eski ve yeni hâliyle kaydedilir; bir geçersiz kılma da kaydedilir.

Hafıza

Kararlar ve dersler, kaynağı ve kapsamı belirtilmiş Markdown notlarıdır. Yerel bir dizin bunları çevrimdışı arar; bir hook da ajan harekete geçmeden önce ilgili notları önüne koyar. Notlar sade Markdown olduğu için onları Obsidian'da açabilirsiniz.

03 Yalıtım

Her deneme kendi kopyasında.

  • Her deneme kendi git worktree'sinde, kendi branch'inde çalışır. İki worker asla aynı ağacı paylaşmaz.
  • Bir worker kendi kabul komutunu yeniden yazamaz. Onu yalnızca yönetici değiştirebilir, o da görev kapanmadan önce; her değişiklikte eski ve yeni hâl saklanır.
  • İş, ana branch'inize ancak doğrulama geçtikten sonra ulaşır ve kabul komutu merge'den sonra bir kez daha çalışır.
  • Force-push her rol için reddedilir.
  • Bu kurallar, bir model çağrılmadan önce ve sonra kod olarak çalışır. Bir prompt değildirler; bu yüzden bir ajan onları laf kalabalığıyla aşamaz.

04 Ajanlar

Zaten kullandığınız ajanlar.

RADAR; Claude Code, Codex CLI, OMP ve Hermes Agent'ı sizin bilgisayarınızda ya da size ait Linux sunucularında çalıştırır. Onların yerini almaz: işi yine onlar yapar.

  • Claude Code
  • Codex CLI
  • OMP
  • Hermes Agent
Tek sözleşme
Dördü için de aynı kurallar, aynı kayıt, aynı doğrulama kapısı ve aynı deneme sınırları geçerlidir.
Yönetici
Konuştuğunuz ajan yönetir: görevleri açar, worker'lara verir ve bir görevi yalnızca geçen bir doğrulama kaydıyla kapatır.
Worker'lar
Worker'lar işi kendi worktree'lerinde yapar. Görev kapatamaz ve kabul komutlarını değiştiremezler.

05 Önce yerel

Önce yerel.

RADAR hesap da bulut da gerektirmez.

Makinenizde
Kayıt, hafıza notları, worktree'ler ve her doğrulama çalıştırması; sizin bilgisayarınızda ya da size ait Linux sunucularında.
Ağ gerektirenler
Ajanlarınız; bugün olduğu gibi kendi sağlayıcılarıyla konuşurlar. Diğer tüm dış hizmetler isteğe bağlıdır ve siz açana kadar kapalı kalır.
Gereksinimler
Windows veya Linux (macOS henüz desteklenmiyor), Python 3.12 veya üstü ve Git. RADAR yalnızca Python standart kütüphanesini kullanır.
Maliyet
Kendine ait bir faturası yoktur. Ajanlar, onlarla oturum açtığınız hesapları kullanmaya devam eder. Ücretli bir API yalnızca sağlayıcıyı ve bir bütçeyi siz belirtirseniz kullanılır.
Kurulum
Kodlama ajanınıza depo bağlantısını verip “bunu kur” deyin. Ajan bilgisayarınızı kontrol eder, eksik bir şeyi kurmadan önce size sorar, RADAR'ı bir sanal ortama kurar ve radar init ile radar doctor çıktılarını size bildirir.

06 Komutlar

Kısa bir komut listesi.

İlk karşılaşacağınız komutlar. Yer tutucular açılı ayraç içinde gösterilir.

KomutNe yapar
radar init RADAR'ın ana dizinini ve kaydı kurar.
radar doctor Kurulumu kontrol eder ve yapılandırılmamış isteğe bağlı hizmetleri listeler.
radar task new --project P --goal "…" --accept "<command>" Bir görevi kabul komutuyla birlikte açar.
radar dispatch <task> Bir görevi, kendi worktree'sinde çalışacak bir ajana verir.
radar status Tüm sistemi gösterir.
radar verify <task> Kabul komutunu güncel revizyon üzerinde yeniden çalıştırır.
radar task done <task> --evidence "<verification report>" Bir görevi kapatır. Doğrulama geçene kadar reddedilir.
radar collect Biten işi toplar.
radar integrate Doğrulanmış işi main'e merge eder.
radar stop İşi park eder ve STOP koyar.
radar go STOP'u kaldırır ve devam edebilecek işleri listeler.
radar memory search --local "<words>" Hafıza notlarında çevrimdışı arama yapar.
radar uiradar web Kokpiti terminalde ya da tarayıcıda açar.
radar help --all Tüm komutları listeler. Ayrıntılar için radar <command> -h.

07 Yapmadıkları

RADAR'ın yapmadıkları.

  • Ajanlarınızın yerini almaz. Kodu yine onlar yazar; RADAR onlara tek bir kayıt, atlayamayacakları bir denetim ve tek bir hafıza verir.
  • Testlerinizi yazmaz. Bir denetim ancak testi kadar iyidir; RADAR testi iş başlamadan önce açık hâle getirir, böylece bir insan onu okuyabilir.
  • Testi olmayan işi kapatmaz. Çalıştırılabilir bir kabul komutu olmayan görev daha açılırken reddedilir.
  • Ajanlarınızı çevrimdışı tutmaz. Onlar bugün olduğu gibi kendi sağlayıcılarıyla konuşmaya devam eder.
  • Açık sürüm ekipler için değil, bireysel geliştiriciler içindir; şirket sürümü geliştiriliyor.

08 Durum

Erken erişimde

Şimdi erken erişimde. Genel kullanıma açıldığında açık kaynak.

RADAR erken erişimde. Genel kullanıma açıldığında Apache-2.0 lisansıyla açık kaynak olarak yayımlanacak. Katılmak için bize yazın.