AgentBuilder, başka repolar için AGENTS.md, ajan talimat dosyaları, prompt dosyaları ve Codex /goal rehberliği hazırlamak üzere kullanılan bir host çalışma alanıdır. Bu repodaki ana amaç uygulama kodu geliştirmek değil, başka hedef repolarda çalışacak ajanlara doğru, kısa ve kanıta dayalı talimatlar üretmektir.
- Yeni bir hedef repo için kanıta dayalı
AGENTS.mdtaslağı hazırlamak. - Mevcut ajan talimatlarını gözden geçirmek, sadeleştirmek, doğrulamak veya güncellemek.
- Prompt dosyaları oluşturmak, iyileştirmek, taşımak, değerlendirmek veya hata ayıklamak.
- Codex
/goalslash komutu ve uzun süreli Codex hedefleri için doğru, kısa ve operasyonel rehberlik yazmak. - Repo kurallarını gerçek dosyalar, scriptler, CI ayarları, dokümantasyon ve mevcut talimatlarla doğrulamak.
Bu repo çoğu çalışmada hedef repo değildir. Varsayılan ayrım şöyledir:
- Host repo: (örneğin)
/Users/umutcanoner/Documents/Github/AgentBuilder - Target repo: Talimat, prompt veya
/goalrehberliği üretilecek başka repo ya da alt ağaç
Kullanıcı bu reponun kendisinin hedef olduğunu açıkça söylemezse AgentBuilder host repo olarak kalır. Notlarda, komutlarda, diff'lerde ve sonuçlarda host ve target path ayrımı açık tutulmalıdır.
git clone https://github.com/zopiolabs/agentbuilder
cd agentbuilder
codexCodex Desktop uygulamasıyla çalışacaksanız klonlanan dizinde şu komutu kullanabilirsiniz:
codex appAçılan oturumda hedef repoyu ve yapılacak işi açıkça belirtin:
Hedef repo: /path/to/target-repo
Bu repo için mevcut AGENTS.md dosyasını gözden geçir ve daha uygulanabilir hale getir.
Varsayılan çalışma modu AGENTS.md hazırlama, inceleme ve iyileştirme modudur. Kullanıcının isteğinde başka bir iş akışı için tam aktivasyon ifadesi yoksa istek, hedef repo için ajan talimatı üretme veya iyileştirme işi olarak ele alınır.
Prompt çalışması yalnızca isteğin içinde şu ifadelerden biri açıkça yer alırsa aktive olur:
I need a prompt work.
Bir prompt çalışmasına ihtiyacım var.
Codex /goal çalışması yalnızca isteğin içinde şu ifadelerden biri açıkça yer alırsa aktive olur:
I need a /goal work.
Bir /goal çalışmasına ihtiyacım var.
Sadece /goal yazmak, /goal komutundan bahsetmek veya uzun süreli hedefleri tartışmak /goal çalışma modunu aktive etmez. Aktivasyon ifadeleri yalnızca kullanıcının gerçek isteğinde geçerliyse dikkate alınır; alıntı, kod bloğu, diff, örnek veya bu dosyanın tartışması içinde geçiyorsa mod değiştirmez.
Bir /goal çalışmasının çıktısı copy/paste edilebilir bir goal prompt ise prompt metni tam olarak /goal ile başlamalıdır. Başına başlık, madde imi, açıklama, boşluk veya kod bloğu işareti konmamalıdır.
AGENTS.md çalışması
Hedef repo: /path/to/target-repo
Bu repo için mevcut AGENTS.md dosyasını incele. Test komutlarını, güvenli değişiklik kurallarını ve tamamlanma ölçütünü repo kanıtlarına göre güncelle.
Beklenen etki: Hedef repodaki AGENTS.md dosyası, repo gerçeklerine dayalı olarak daha uygulanabilir ve daha az muğlak hale getirilir.
Prompt çalışması
Hedef repo: /path/to/target-repo
Bir prompt çalışmasına ihtiyacım var. Bu promptu daha kısa, doğrulanabilir ve copy/paste edilebilir hale getir.
Beklenen etki: İstek prompt-work modunda ele alınır. Çıktı, doğrudan kullanılabilir bir prompt, prompt patch'i, prompt şablonu veya değerlendirme önerisi olur.
Codex /goal çalışması
Hedef repo: /path/to/target-repo
Bir /goal çalışmasına ihtiyacım var. Bu çalışma için teslim odaklı bir Codex hedef promptu yaz.
Olası copy/paste edilebilir çıktı:
/goal Hedef repodaki AGENTS.md dosyasını README, CI ve paket scriptleriyle karşılaştırarak güncelle; desteklenen doğrulama komutlarını, güvenlik sınırlarını ve tamamlanma ölçütünü netleştir; düzenleme README ile tekrar kontrol edildikten sonra işi bitir.
AGENTS.md work
Target repo: /path/to/target-repo
Review this repository's AGENTS.md and update it with supported test commands, safety constraints, and a concrete definition of done based on repo evidence.
Beklenen etki: İstek varsayılan AGENTS modunda ele alınır. Hedef repo talimatları, gerçek dosya ve komut kanıtlarına göre iyileştirilir.
Prompt work
Target repo: /path/to/target-repo
I need a prompt work. Rewrite this prompt so it is shorter, easier to evaluate, and directly copy/pasteable.
Beklenen etki: İstek prompt-work modunda ele alınır. Çıktı, promptun kendisini veya istenen prompt patch'ini önce verecek şekilde düzenlenir.
Codex /goal work
Target repo: /path/to/target-repo
I need a /goal work. Write a deliverable-oriented Codex goal prompt for updating the repository instructions.
Olası copy/paste edilebilir çıktı:
/goal Update the target repo's AGENTS.md so it lists supported validation commands, safety constraints, and the definition of done; finish after checking the edited instructions against README, CI, and package scripts.
Sohbet, kullanıcının başlattığı dilde sürdürülür. Kullanıcı daha sonra açıkça başka bir dil isterse son açık tercih takip edilir.
Buna rağmen AGENTS.md, ajan talimat dosyaları, prompt dosyaları ve Codex /goal rehberliği varsayılan olarak İngilizce yazılır. Artifact dilinin Türkçe, İngilizce, başka bir dil veya özel bir üslup olması gerekiyorsa bunu istekte açıkça belirtin.
Konuşma dili İngilizce değilse ve üretilecek artifact varsayılan olarak İngilizce kalacaksa ajan kısa bir notla bunu belirtir ve şu referansı verir:
https://x.com/arankomatsuzaki/status/2049125048792006965?s=48
AGENTS.md: Bu çalışma alanında ajanların nasıl çalışacağını belirleyen ana talimat dosyası.README.md: Ekip arkadaşları ve ajan kullanıcıları için kısa kullanım özeti.docs/codex_goal.md: Codex/goalkomutunun davranışı, sınırları ve operasyonel notları.
- Host veya target repoda
umut_stuff/içinden okumak, aramak, diff almak, indekslemek, değiştirmek veya geniş komutlar geçirmek için açık kullanıcı isteği gerekir. - Silme,
git reset --hard, force push, credential rotation, production/deploy değişikliği, veritabanı veya altyapı mutasyonu gibi yıkıcı ya da paylaşımlı sistem etkisi olan işler açık onay olmadan yapılmaz. - Repo gerçeklerinden çıkarılabilecek bilgiler kullanıcıya sorulmaz; önce dosyalar, scriptler, CI ve mevcut talimatlar incelenir.
- Eksik kanıt varsa komut, sahiplik, politika veya platform davranışı uydurulmaz; placeholder ya da açık varsayım kullanılır.
- Promptlarda gizli chain-of-thought istenmez. Bunun yerine kısa gerekçe, doğrulama özeti, kontrol listesi veya karar kaydı istenir.