İçeriğe geç
Ahmet Eren Lapanta
EnglishÜcretsiz başla
Menü
Ücretsiz başla

Ekibin defalarca yaptığı iş, herkesin ajanında aynı tarifle.

TeamHandbook, Claude Code için açık kaynak bir plugin. Git geçmişinde sık yapılan bir işten, o işi ajana tarif eden bir skill taslağı yazıyor. Sen onaylamadan bir yere gitmez. Onaylanıp merge edilince, yani ana koda alınınca, ekip repo'suna abone olan herkesin ajanı onu bir sonraki oturumda bulur.

KurulumGitHub'daki repo

Kurulum

Ekipte bunu bir kişi bir kez yapıyor.

  1. 1

    Plugin'i Claude Code'a ekle.

    • /plugin marketplace add AhmetErenLapanta/TeamHandbook
    • /plugin install handbook@teamhandbook

    Claude Code kurulum yerini sorduğunda "Install for you (user scope)" seç. Project scope seçersen plugin repo'yu klonlayan herkese kurulur.

  2. 2

    Hook'lar yüklensin diye Claude Code'u yeniden başlat. Sonra ekibin ortak repo'sunu kur.

    • /handbook:init

    Boş bir git repo'su ver ya da senin için açmasını iste. Çıktının sonunda ekibine göndereceğin mesaj duruyor.

Claude Code 2.1 ve üstü · Node.js 22 ve üstü · Apache-2.0 · v0.23.1

Örnek çıktı, hayali bir repo üzerinde
/handbook:mineRepeating work found in 1 repository, most established first:   1. docs/*api.md + routes/*Routes.ts + schemas/*Schema.ts     done 10 times, in 1 repository, by 3 people · last 2026-10-06  2. ./*env.example + config/*defaults.ts + config/*schema.ts     done 8 times, in 1 repository, by 3 people · last 2026-10-02 Nothing has been sent anywhere: this read your git history and nothing else. /handbook:mine draft 1Drafting 1: this sends the screened evidence for this workflow to the model.Queued "add-resource-endpoints" for review. /handbook:reviewadd-resource-endpoints   draft from repository history  file map   4 files, each changed in 10 of 10 jobs  open       3 questions the history could not showWhere should it go?  › Share with the team    Add to shop-api    Keep for yourself    Reject Shared "add-resource-endpoints" with the team: gitlab.com/ekibin/handbook/-/merge_requests/14Merge that request and every teammate gets it at their next session.

Nasıl çalışıyor

  1. 01

    Tekrar eden işi listeler

    /handbook:mine repo'nun git geçmişini okuyor. Aynı dosyalara aynı şekilde dokunan işleri, kaç kez ve kaç kişiyle yapıldığıyla gösteriyor. Bu adımda model çağrısı yok.

  2. 02

    Seçtiğin iş için taslak yazar

    /handbook:mine draft 1 taslağı senin claude CLI'ınla yazıyor. İçinde adımların iskeleti ve geçmişin ölçtüğü dosya haritası var. Git'in göremediği kısım açık soru olarak kalıyor.

  3. 03

    Kararı sen verirsin

    /handbook:review taslağı gösteriyor. Açık soruları cevaplıyorsun, sonra nereye gideceğini seçiyorsun. Ekiple paylaşmak team repo'suna bir merge request açıyor.

  4. 04

    Ekip bir sonraki oturumda kullanır

    Biri merge edince ekibin plugin sürümü artıyor. Claude Code her ekip arkadaşının kopyasını bu sürümle yeniliyor. Kimse elle bir şey kurmuyor.

Komutlar

Hepsi Claude Code içinde slash command olarak çalışıyor.

  • /handbook:mine

    Ne yapar
    Repo'nun git geçmişinde tekrar eden işleri listeler. Her işin dokunduğu dosyaları, kaç kez ve kaç kişiyle yapıldığını gösterir.
    Ne zaman
    Bir repo'da hangi işin defalarca yapıldığını görmek istediğinde.
    Çalıştığını nasıl anlarsın
    Numaralı bir liste görürsün. Genç bir repo'da liste boş gelebilir. Bu da doğru bir cevap.

  • /handbook:mine draft <n>

    Ne yapar
    Listeden seçtiğin tek iş için skill taslağı yazar. Bunu senin claude CLI'ınla, tek bir model çağrısıyla yapar.
    Ne zaman
    Listede ekibinin sık yaptığı bir işi tanıdığında.
    Çalıştığını nasıl anlarsın
    Taslak review kuyruğuna düşer. Hiçbir yere kurulmaz, commit de edilmez.

  • /handbook:review

    Ne yapar
    Bekleyen taslakları tek tek gösterir. Her biri için ekiple paylaşmayı, projeye eklemeyi, kendine saklamayı ya da reddetmeyi seçersin.
    Ne zaman
    Kuyruğa bir taslak düştüğünde.
    Çalıştığını nasıl anlarsın
    Paylaştığında bir merge request linki görürsün. Projeye eklerken commit mesajını önce sana onaylatır.

  • /handbook:share

    Ne yapar
    Makinendeki skill'leri, MCP sunucularını ve slash komutlarını tek ekranda listeler. Seçtiklerin ekibe birlikte gider.
    Ne zaman
    Kendi yazdığın bir skill'i ya da kurduğun bir MCP sunucusunu ekibine vermek istediğinde.
    Çalıştığını nasıl anlarsın
    Seçtiğin her şey tek bir merge request'te toplanır. Senin kopyalarına dokunulmaz.

  • /handbook:init

    Ne yapar
    Ekibin ortak repo'sunu bir Claude Code plugin marketplace'i olarak kurar.
    Ne zaman
    Ekibinde henüz böyle bir repo yokken. Bunu bir kişi bir kez yapar.
    Çalıştığını nasıl anlarsın
    Repo'da commit varsa kurulum bir merge request olarak gelir. Çıktının sonunda ekibine gidecek mesaj durur.

  • /handbook:join <team-repo-url>

    Ne yapar
    Bu makineyi ekibinin var olan repo'suna bağlar. Onayladığın skill'ler oraya gider.
    Ne zaman
    Ekibinden biri repo'yu /handbook:init ile kurduysa.
    Çalıştığını nasıl anlarsın
    Sonunda iki /plugin komutu yazdırır. Onları çalıştırınca ekibin merge ettikleri sana da gelir.

  • /handbook:demo

    Ne yapar
    Bütün yolu geçici bir repo'da yürütür. Önce liste gelir, sonra bir taslak, en son review ekranı.
    Ne zaman
    Ekibine önermeden önce nasıl çalıştığını kendin görmek istediğinde.
    Çalıştığını nasıl anlarsın
    Üç ekranı sırayla görürsün. Canlı taslak istemedikçe model çağrısı yapmaz.

  • /handbook:doctor

    Ne yapar
    Node'u, claude CLI'ı, hook'ları, config'i ve team repo'yu kontrol eder.
    Ne zaman
    Kurulumdan sonra ya da bir şey çalışmıyor gibi göründüğünde.
    Çalıştığını nasıl anlarsın
    Her hatanın yanına çözümünü yazar. Yeniden başlatmadan önce hook'ları çalışmıyor gösterir. Bu doğru, çünkü henüz yüklenmediler.

  • /handbook:leave

    Ne yapar
    Team repo bağlantısını kaldırır ve seni tek başına çalışmaya döndürür. Hiçbir skill'i silmez.
    Ne zaman
    Ekipten ayrıldığında ya da başka bir ekibin repo'suna geçeceğinde.
    Çalıştığını nasıl anlarsın
    Aboneliğin olduğu gibi kalır. Onu /plugin marketplace remove ile sen bitirirsin.

TeamHandbook'un yazdığı hiçbir şey sen karar vermeden makinenden çıkmaz

Bir modelin yazdığı şey makul görünüp yanlış olabiliyor. Bu yüzden TeamHandbook'u her adımda karar sende kalacak şekilde yazdım.

  • Her taslak review'da bekliyor

    /handbook:review taslağı ve neyden yazıldığını gösteriyor, sonra nereye gideceğini soruyor. Düzenleme isteyebilir ya da kararı sonraya bırakabilirsin.

  • Paylaşmak bir merge request ile bitiyor

    Ekiple paylaş dediğinde team repo'suna bir merge request açılıyor. Ekipten biri okuyup merge edene kadar kimse için bir şey değişmiyor.

  • Makinene kimse bir şey koyamaz

    Repo'yu kuran kişi senin ~/.claude klasörüne yazamaz. Aboneliği iki /plugin komutuyla kendin başlatıyorsun. İstediğin an kaldırabilirsin.

  • Neyin gönderildiğini biliyorsun

    Listelemek hiçbir şey göndermiyor. Taslak, seçtiğin tek işin ayıklanmış verisini senin claude CLI'ına gönderiyor. Gömülü bir anahtar ya da telemetri yok.

  • Bırakırsan skill'lerin kalıyor

    Ekip TeamHandbook'u bırakırsa repo ve dağıtım çalışmaya devam ediyor. Skill'ler SKILL.md okuyan her araçta çalışıyor.

Sıradaki adım