Workspace — bakımcı merkezi

agentteamland/workspace deposu, AgentTeamLand ekosisteminin bakımcı merkezidir. Bir meta-depodur: klonlayıp tek bir betiği çalıştırınca her eş depo (cli, core, registry, software-project-team vb.) tek bir ağaç altında, ./repos/ dizininde, kontrol edilmiş hâle gelir. Platformun her hareketli parçası bir cd repos/<name> uzaklıktadır.

Çalışma alanını, birden çok depoyu kapsayan bakım işi yaparken kullan: depolar arası yeniden tasarımlar, çoklu PR yayımları, yönetişim denetimleri ya da yalnızca 14 ayrı cd komutu olmadan organizasyon genelinde git status çalıştırmak.

atl'yi yalnızca KULLANMAK istiyorsan (kendi projelerine takım kurmak için) çalışma alanına ihtiyacın yoktur — brew install agentteamland/tap/atl yeterlidir. Çalışma alanı, ekosistem tarafındaki iş içindir.

İlk kurulum

git clone https://github.com/agentteamland/workspace.git
cd workspace
./scripts/sync.sh

sync.sh, agentteamland/ altındaki her eş depoyu ./repos/<name>/ dizinine klonlar. İdempotent çalışır — yeniden çalıştırmak var olan klonları ileri-sarmalı çekimle günceller ve son çalıştırmadan bu yana organizasyona eklenen yeni depoları klonlar.

Eşzamanlamadan sonra ./repos/, organizasyonun tam anlık görüntüsünü içerir (2026-05-03 itibarıyla 16 depo):

repos/
├── cli/                       # atl ikilisi (Go) — kullanıcıların kurduğu CLI
├── core/                      # global beceriler + kurallar + JSON şemalar
├── brainstorm/                # /brainstorm becerisi + kuralı
├── rule/                      # /rule + /rule-wizard becerileri
├── team-manager/              # bootstrap install.sh (v1.0.0 sonrası atl'ye devreder)
├── software-project-team/     # 13 ajan + 3 beceri (.NET + Flutter + React yığını)
├── design-system-team/        # 2 ajan + 10 /dst-* becerisi (yerel tasarım + prototip)
├── starter-extended/          # kalıtım örnek takımı
├── create-project/            # 🗄 ARCHIVED 2026-05-04 — iskele takımlara taşındı; tarih için saklandı
├── registry/                  # teams.json — kanonik takım kataloğu
├── docs/                      # bu belgeler sitesi (VitePress, EN + TR)
├── homebrew-tap/              # goreleaser tarafından kendiliğinden yönetilir
├── scoop-bucket/              # goreleaser tarafından kendiliğinden yönetilir
├── winget-pkgs/               # microsoft/winget-pkgs çatallaması
└── .github/                   # organizasyon profili

Günlük komutlar

Çalışma alanı ./scripts/ altında üç betik ile gelir:

./scripts/sync.sh         # eksik depoları klonla; var olanları ileri-sarmalı çekimle güncelle
./scripts/status.sh       # tablolu genel görünüm — kim kirli, kim önde, kim geride
./scripts/push-all.sh     # push'lanmamış commit'lerin kuru çalıştırma listesi (gerçekten push'lamak için --force)

status.sh, her depo için tek satırlık bir tablo yazdırır — dal, önde / geride sayıları, kirli işareti. Organizasyonun mevcut durumunu bir bakışta görmek için her oturumun başında çalıştır.

push-all.sh varsayılan olarak kuru çalıştırma yapar — NE'nin push'lanacağını gösterir, gerçek push'lamayı yapmaz. Gerçekten push'lamak için --force geç. ("force" adı kuru çalıştırmayı bastırmaya işaret eder, git push --force değil — gerçek push olağan Git anlamlarını kullanır.)

Bir eş depoda çalışmak

cd repos/<repo-name>
# Değişikliklerini yap, team-repo-maintenance disiplinini izle
git checkout -b <type>/<short-description>
# ... dosyaları düzenle ...
git add <files> && git commit -m "<conventional message>"
git push -u origin <branch-name>
gh pr create
# Bakımcının inceleyip birleştirmesini bekle

Her eş depo kendi uzak deposu olan kendi Git klonudur. 16 deponun 12'sinde dal koruması (sürüm yayım hattı + .github hariç) PR akışını zorunlu kılar. Tüm disiplin için bkz. Takım deposu bakımı.

Çalışma alanını Claude Code ile kullanmak

Çalışma alanının kökünde Claude Code aç:

cd ~/projects/my/agentteamland/workspace
claude    # ya da Claude Code'u nasıl çağırıyorsan

Claude Code burada başladığında kendiliğinden şunları görür:

• ./repos/ altındaki her eş depo doğrudan düzenleme için — ayrı cd gerekmez.
• Tüm etkin beyin fırtınaları (brainstorm kuralı gereği CLAUDE.md'ye kendiliğinden sabitlenmiş).
• Çalışma alanının CLAUDE.md dosyası — platform düzeyinde yönlendirme belgesi.
• Yerleşmiş kararlar .claude/docs/ altında (tamamlanmış beyin fırtınalarından türeyen mimari kararlar).
• Wiki + journal — .claude/wiki/ ve .claude/journal/ içinde (bilgi sistemi gereği).

Bu, depolar arası iş için doğal kurulumdur: Claude'un çalışma kümesi tüm organizasyondur.

Bilgi haritası

Çalışma alanının CLAUDE.md dosyası, her wiki sayfasının başlığını ve özetini Claude'un bağlamına kendiliğinden yükleyen bir <!-- wiki:index --> işaretçi bloğu taşır. İşaretçi bloğunun nasıl çalıştığı ve neden var olduğu için bkz. Claude Code sözleşmeleri.

Wiki'nin kendisi (.claude/wiki/*.md), bakımcının depolar arası endişeler üzerinde çalışırken elinin altında bulundurması gereken platform genelindeki desenler, sözleşmeler, keşifler ve kötü desenlerin kanonik kaydıdır. Sayfalar güncel tutulur — bilgi sistemi, güncel doğru için yerine yazma biçimli, geçmiş için yalnızca eklemeli journal kullanır.

Oturum sonu

Toparlanırken:

./scripts/status.sh        # her şeyin main'de ve temiz olduğunu doğrula
./scripts/push-all.sh      # push'lanmamış ne var, gör

Daha kapsamlı bir oturum sonu geçişi için /repo-cleanup şunları otomatikleştirir: save-learnings → dal + commit + push + PR + auto-merge → etiket + kayıt defteri + dal budama. Çalışma alanında Claude Code'un içinden çalıştır.

İlgili

• atl CLI'yi kur — yalnızca atl'yi KULLANMAK istiyorsan çalışma alanını atla.
• Takım deposu bakımı — her eş depo PR'ının izlediği disiplin.
• Yönetişim — dal koruması ile team-repo-maintenance kuralı eşi.
• Bilgi sistemi — çalışma alanının .claude/ dizinindeki journal ve wiki katmanları.