Hızlı başlangıç

Sıfırdan üretime hazır bir ajan takımına bir dakikadan kısa sürede — CLI'ı kur, ilk takımını kur, bir oturum aç.

1. atl'yi kur

atl, hiçbir çalışma-zamanı bağımlılığı olmayan tek statik bir Go ikili dosyasıdır. Platformuna uygun tek-satırlık betikle kur:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/agentteamland/atl/main/scripts/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/agentteamland/atl/main/scripts/install.ps1 | iex

Elle kurmayı mı tercih edersin? GitHub Releases sayfasından önceden derlenmiş bir ikili al ve PATH'ine koy. Homebrew, Scoop ya da winget kanalı yok — desteklenen yol betik (ya da release ZIP'i). Tüm ayrıntılar: Kurulum rehberi.

Doğrula:

atl --version

2. Bir proje dizini oluştur

mkdir my-new-app && cd my-new-app

atl bir projenin içinde çalışır. Bir takım kurduğunda, takımın ajanlarını, becerilerini ve kurallarını bu projenin .claude/ dizinine yazar — tam da Claude Code'un onları okuduğu yere.

3. Bir takım bul

atl search dotnet

atl search, atl-team konu etiketiyle işaretlenmiş herkese açık depolardan üretilen GitHub tabanlı kataloğu sorgular. Her sonuç, <handle>/<team>@<version> referansını (handle, takımın GitHub sahibidir — sahiplik yazarlıktır) ve kopyalanacak tam atl install komutunu yazdırır. Artık PR açılacak merkezi bir kayıt-defteri deposu yok; bir deponun listelenmesi, onu atl-team ile etiketlemek (ya da içinde atl publish çalıştırmak) yoluyla olur.

4. Takımı kur

atl install acme/example-team

(acme/example-team kurgusal bir örnek referanstır — 3. adımda bulduğun gerçek <handle>/<takım> referansını kullan.)

Birkaç saniye içinde:

• Takım, indeksten çözümlenir ve indirilir (yeniden kullanım için önbelleğe alınır).
• Takımın ajanları, becerileri ve kuralları .claude/ dizinine yazılır.
• Temel dosya hash'lerinden oluşan bir manifest .atl/ altına kaydedilir; böylece ileride güncellemeler senin düzenlemelerini yukarı-akış (upstream) değişikliklerinden ayırt edebilir.
• Otomasyon hook'ları, kurulumun bir parçası olarak Claude Code'a bağlanır — otomasyon, opt-in değil, varsayılan olarak açıktır.

Artık projeye bağlı eksiksiz bir ajan takımın var.

Global ve proje kapsamı

Bir takım, yayıncısının varsayılanının işaret ettiği yere kurulur. --global (her proje) ya da --project (yalnızca bu proje) ile bastır; bir takım her iki katmanda da bulunduğunda, proje kopyası global olanı gölgeler. Kapsam ekseni için Kavramlar sayfasına bak.

5. Ne kurduğunu gör

atl list

atl list, her kapsamda kurulu takımları gösterir — global (~/.claude) ve proje (<cwd>/.claude). Her ikisinde de bulunan bir takım, her birinin altında listelenir.

6. Claude Code'da kullan

Bu dizinde Claude Code'u aç. Takımın gönderdiği beceriler eğik çizgili komut olarak hazırdır; ajanları da (örneğin agents/backend-agent) Claude'un devredebilmesi için hazır bekler.

Platformun kendi global becerileri de orada — /drain, /create-pr, /create-code-diagram, /brainstorm, /rule, /rule-wizard, /docs-audit, /publish, /skill-stocktake, /rules-distill — hangi takımı kurduğundan bağımsız olarak her projede kullanılabilir.

7. Bırak öğrenme döngüsü kendini çalıştırsın

İşte kurulumunu zamanla bozulmak yerine sürekli daha iyi yapan kısım bu. Sen çalışırken ajanlar öğrendiklerini dayanıklı bir kuyruğa yazar. 4. adımdaki otomasyon hook'ları sayesinde bunların hiçbirini elle yönetmezsin:

• Oturum içinde (ve atl tick ile) bir bakım tick'i çalışır ve kuyruktaki öğrenmeleri bilgi tabanına katar.
• atl doctor kurulumu kendiliğinden onarır — hatırlaman gereken bir komut değil, daima açık çalışan sağlık daemon'udur.
• Öğrenmeler kuyruğa girdiğinde atl, ajana onları arka planda otomatik drain etmesi için sinyal verir — her öğe doğru yerine yönlendirilir (bir wiki sayfası, günlük ya da bir ajanın bilgi tabanı) ve kuyruktan silinir; elle çalıştırılacak bir /drain komutu yoktur.

Kuyruğa istediğin zaman göz at:

atl learnings status

atl learnings peek bekleyen öğeleri listeler, atl learnings ack <id> ise bir öğeyi işlenmiş olarak işaretler.

8. Güncel kal

Bir takım yazarı iyileştirmeler gönderdiğinde:

atl update

Kurulu tüm takımlar tazelenir; değiştirmediğin kopyalar yerinde güncellenir ve yerel düzenlemelerin korunur. Projenin kendi kodunda hiçbir şey değişmez.

Az önce ne oldu?

Tek bir komutla, özenle seçilmiş ve sürüme sabitlenmiş bir ajan kümesini bir projeye kurdun ve kendi kendine çalışan bir bakım döngüsünü açtın. Aynı takımı kuran diğer her proje aynı yapılandırmayı alır — ve yazar gönderdiğinde aynı güncellemeleri — ajanlarının öğrendiği kazanımlar ise atl promote ve atl publish aracılığıyla geri dolaşıma girer.

Sıradaki

• Takımlara göz at — kurabileceğin kataloglanmış takımlar.
• Kavramlar — takımlar, ajanlar, beceriler, kurallar ve global/proje kapsam ekseni.
• CLI referansı — her komut ayrıntısıyla.
• Takım yazma — kendi takımını yaz ve yayımla.