Ajan ekibine gerçek iş yaptırmak: GitHub'dan Kaptan'a

Paperclip kurulumu tek bir ajanla bitiyordu. Bu sayfa bir adım öteye geçiyor: ekip GitHub'ı kendisi izliyor, issue'ları triyaj ediyor, kodu yazıyor, kendi PR'ını inceleyip birleştiriyor ve sonucu Gao Kaptan'da bir pod olarak yayına alıyor. Sizin tek işiniz issue açmak.

Aşağıdakilerin hepsi çalışan bir kurulumdan alındı; ekran görüntüleri ve alıntılar gerçek.

Ortaya çıkan düzen

Şirketi siz kurmuyorsunuz. CEO'ya bir hedef verdiğinizde kendi ekibini kendisi işe alıyor — bu kurulumda CTO ve QA'yı o yarattı:

Bir işi CEO'ya verirseniz kendisi yapmaz — delege eder. Tek ajanla kurulmuş bir şirkette CEO işi yapacak kimse bulamayıp kendine geliştirici işe almaya çalışır. Doğru davranış budur, ama beklemediyseniz zaman kaybı gibi görünür.

Kurulum

Akış — gerçek bir örnek

Panonun görsel olarak yenilenmesini isteyen bir issue açıldı. Sonrasına kimse dokunmadı:

1. CTO triyaj etti: "Alindi. Coder'a atandi (Paperclip KAP-12): yeni dal + Closes #5 ile PR acilacak."

2. Coder kendi dalında yazdı, PR açtı.

3. CTO, QA'ya doğrulama görevi açtı — bu talimatta yoktu, kendi kararıydı.

4. CTO inceledi ve birleştirdi. Yorumu ezber değil, ölçüm:

   "py_compile temiz, uçtan uca çalıştırıldı: 10/11 uç sağlıklı, JSONL 500 satır sınırına uyuyor, node --check ile JS doğrulandı, statik sunucuda açıldı."

5. PR birleşince issue kendiliğinden kapandı (Closes #5).

Ekibin ürettiği pano — Gao Kaptan'da kendi açtıkları pod'dan, relay üzerinden:

Gao Kaptan'a dağıtımı ekibe bırakmak

Ajana sabit jeton vermeyin. Gao Kaptan jetonları dakikalar içinde düşüyor; ajan işin ortasında 401 alıp takılır. Kullanıcı adı ve şifre verin, jetonu her seferinde kendisi alsın:

TOKEN=$(curl -sS -X POST "$KAPTAN_API/api/v1/auth/login" -H 'Content-Type: application/json' \
  -d "{\"email_or_username\":\"$KAPTAN_USER\",\"password\":\"$KAPTAN_PASS\",\"device_info\":\"ajan\"}" \
  | python3 -c 'import sys,json;print(json.load(sys.stdin)["data"]["access_token"])')

Sonra "panoyu Gao Kaptan'da yayına al, adresini issue'ya yaz" demek yetiyor. Ekip pod'u açtı, doğruladı ve raporunu yazdı — çarptığı duvarlar dahil:

"İlk pod terminate edildi… K8s tarafında aynı adla bir pod halihazırda mevcut olduğu için (orphan, tenant listede görünmüyor ama create 409 dönüyor) aynı adla pod oluşturulamadı; bu yüzden -v2 adıyla oluşturuldu. Bağlantı ilk denemede 502 döndü, ~1 dakikada 200'e geldi (ingress ısınması). Doğrulandı: index.html 200, durum.json 200."

Bu rapordaki 409 gözlemi gerçek bir platform kusuru: silinen pod'un adı Kubernetes tarafında öksüz kalabiliyor — tenant listesinde görünmüyor ama aynı adla yeni pod açmak 409 dönüyor.

Ajanlara ne öğretmek gerekti

Her ajanın kalıcı bir talimat dosyası var:

~/.paperclip/instances/default/companies/<şirket>/agents/<ajan>/instructions/AGENTS.md

Yolu ajanın adapterConfig.instructionsFilePath alanında görürsünüz. Oraya üç blok yazıldı:

1. Çalışma kuralları. Önce ölç sonra yama · tek değişken değiştir · ne yazdığını değil ne çıktığını kontrol et · durumların hepsini say · ölçtüğünü ve tahminini ayrı yaz.

2. Gao Kaptan el kitabı. Jetonun kısa ömürlü olduğu · pod env/files/command alanlarının yerinde değiştirilemediği (düzeltme = yeniden oluşturma) · kotanın 10 pod olduğu ve silmenin asenkron olduğu · access-token/regenerate ile erişim bağlantısının nasıl kurulduğu · ilk açılışta 502'nin normal olduğu · wildcard DNS olmadığı için relay'in tek yol olduğu · egress'in yalnızca 80/443 olduğu · inference'ın max_tokens olmadan 400 döndüğü.

3. Teşhis. Bir pod çalışmıyorsa sırayla: pod durumu → Kubernetes olayları → konteyner günlüğü → içeride exec. Belirtiden sebebe bir tablo: ImagePullBackOff ne demek, no such file or directory neden olur, boş log + running ne anlama gelir.

Bunlar yazıldıktan sonra ekip, yayındaki pod'un bozulduğu bir işi baştan sona kendi çözdü: teşhis etti, fazla pod'u sildi, dosyaların main ile aynı olduğunu md5 ile doğruladı.

Ekibi güçlendirmek

Ekip kurulduktan sonra yetenekleri iki yerden büyür.

Skills — beceri mağazası. Sol menüde Skills. Kurulumda 5 gömülü beceri gelir, ayrıca 17 beceri katalogda hazır bekler: kod inceleme, pull request akışı, QA/test/doğrulama, dokümantasyon, changelog, MCP, ve gerçek bir tarayıcı sürüp sayfayı gözle doğrulayan agent-browser gibi. "Install" ile kurar, ajana atarsınız. Aynı sayfadaki Studio / New ile kendi becerinizi yazabilirsiniz.

ClipHub — şirket kaydı. Org ekranındaki Import company / Export company düğmeleri buraya bakar. Komple bir şirket (org şeması, ajan tanımları, adaptör yapılandırmaları, başlangıç görevleri, bütçe varsayılanları) indirilebilir; tek tek ajan şablonları ve takım şablonları da yayınlanabiliyor. Ekibi sıfırdan kurmak yerine hazır bir yapı indirip uyarlamak mümkün.

Bunu CEO'ya da söyleyebilirsiniz. "Katalogdaki becerilerden işimize yarayanları kur, eksik bir rol varsa ajan al" diye bir görev verildiğinde CEO kendi seçimini yapıp kuruyor — bu kurulumda github-pr-workflow, task-planning ve wireframe becerilerini kendisi kurdu (5 → 8). Yeni ajan almadı; mevcut ekibi yeterli görmüş.

Tuzaklar

ln -s /workspace/<proje> ~/.paperclip/instances/default/workspaces/<ajanId>/<proje>