Senior Dev Kit

Claude Code yapılandırma kiti · v1.0.0

Modele
etki alanı bilinci ver.

Kutudan çıktığı haliyle Claude Code, bir CSS hatasını düzeltmeye giderken auth middleware'ini yeniden yazar, bir kolonu düşürür ve alakasız üç dosyayı refactor eder. Bu kit ona kıdemli bir takım arkadaşında olup taze bir modelde olmayan şeyi verir: neyin tehlikeli olduğu fikri.

claude — senior-dev-kit ile
$ claudeusers tablosuna kolon ekle ◆ katman 3 — veritabanı şeması · db-guard'a yönlendi  salt okunur. henüz hiçbir şey yazılmadı.   PLAN  1  ALTER TABLE users ADD COLUMN plan text NULL  2  parti parti backfill, tablo kilidi yok  3  geri alma: DROP COLUMN plan   onayın bekleniyor
Ajan
7
Skill
25
Kural dosyası
11
Preset
28
Referans doküman
16
Deny kuralı
412

01 — Yan yana

Aynı istek. Bambaşka iki öğleden sonra.

Claude Code'a yazılan tek cümle: users tablosuna kolon ekle. Anahtarı çevir, kitin sonrasını nasıl değiştirdiğini gör.

düz
users tablosuna kolon ekle ● Edit  prisma/schema.prisma● Edit  src/types/user.ts● Bash  npx prisma migrate dev --name add_plan   `users` düşürülüp yeniden kurulsun mu? … uygulandı  47 satır kayboldu Tamamdır! Kolonu ekledim ve tipleri güncelledim.
3 dosya yazıldı0 plan gösterildi0 onay istendi
senior-dev-kit
users tablosuna kolon ekle ◆ katman 3 — DB şeması · ESCALATE TO: db-guard  db-guard'ın Edit veya Write aracı yok.   PLAN — eklemeli, kesintisiz  1  ADD COLUMN plan text NULL      (kilit yok)  2  1000'lik partiler hâlinde backfill  3  geri alma: DROP COLUMN plan   onayın bekleniyor
0 dosya yazıldı1 plan gösterildi1 onay istendi

Koruma, talimatla değil araç tanımıyla salt okunur — yapılandırmasında uzanabileceği bir Edit veya Write aracı yok. Kibarca geri durması rica edilmiyor.

02 — İşleyiş

Her işte dört şey olur.

Hiçbirini sen tetiklemezsin. İşi normal cümlelerle anlatırsın; yönlendirme otomatiktir.

  1. Düzenlemeden önce projeyi okur

    Oturum başına bir kez: paket yöneticisi, config, CI/CD, ORM ve migration düzeni, mimari şekli ve gerçek test komutu. Tespit edemediğini tahmin etmek yerine UNKNOWN işaretler — yanlış bir varsayım, açıkça söylenmiş bir boşluktan kötüdür.

  2. Planlamadan önce etki alanını ölçer

    Her iş bir katmana düşer. Tek satırlık bir CSS düzeltmesi doğrudan geçer. Auth, ödeme, veritabanı şeması, CI/CD, secret veya altyapıya dokunan her şey katman 3 ve üstüdür — plan modu, salt okunur, sen onaylamadan tek satır düzenleme yok.

  3. O yüzeyin sahibine yönlendirir

    Korumalı bir isim, iş fiilini yener: "login formundaki CSS'i düzelt" bir stil sorusu değil, güvenlik sorusudur. Kural dosyaları da aynı mantıkla yüklenir — dosya yolu eşleşmesiyle, böylece bir Flutter projesi REST-API kurallarının bedelini ödemez.

  4. Tam olarak değiştirdiği şeyi doğrular

    Davranış için hedefli test, yeni dosya için lint + test, yeni route için build, tip değişikliği için type-check. Tek dosyalık düzenleme için asla tüm suite değil; komut çıktısı olmadan "bitti" yok.

Örnek istekler ve her birinin yönlendiği yer
Sen dersin kiYönlendiği yer
login sayfasındaki kırık linki düzeltbug-hunter
ayarlar sayfası eklesenior-engineer
checkout akışını yeniden tasarlafeature-plansecurity-guard
Docker CI'ya SBOM üretimi ekledevops-guard
users tablosuna kolon ekledb-guard — önce plan, onaysız migration yok

03 — Kurulum

Üç satır, Claude Code içine yazılır.

/plugin marketplace add mtvrkan/senior-dev-kit
/plugin install senior-dev-kit@senior-dev-kit
/kit-setup

Üçüncü satır tek seferlik ve yapısal bir nedeni var: Claude Code, yola göre yüklenen kuralları ve izin kurallarını yalnızca senin ayarlar dizininden okur, bir plugin'in oraya yazmasına izin verilmez. /kit-setup ne yapacağını tam olarak gösterir, onay bekler ve dokunduğu her şeyin yedeğini alır. Yeniden başlat, sonra /kit-doctor ile doğrula. Güncellemeler /plugin marketplace update ile gelir.

Ya da dosyaları kendin kur

Node.js 18 veya üzeri, bağımlılık yok.

git clone https://github.com/mtvrkan/senior-dev-kit.git
cd senior-dev-kit
node scripts/install.mjs --dry-run
node scripts/install.mjs

Elindeki hiçbir şey yok edilmez: protokol CLAUDE.md dosyana işaretler arasına girer, deny kuralları settings.json ile birleştirilir ve üzerine yazılan her şeyin önce yedeği alınır. İki yoldan birini seç, ikisini birden değil.

04 — İçerik

Eline tam olarak ne geçiyor.

7 ajan

Yazamayan korumalar

Dördü talimatla değil, araç tanımıyla salt okunur: yapılandırmalarında uzanabilecekleri bir Edit veya Write aracı yok. Plan üretip dururlar. Diğer üçü uygular.

25 skill

Her iş tipi için bir prosedür

Hata düzelt, sayfa ekle, migration incele, sürüm kapısını geç — her biri modelin doğaçlama yerine izlediği yazılı bir disiplin. Çoğu iş tipine göre tetiklenir; birkaçı tasarım gereği yalnızca elle çağrılır.

11 kural dosyası

Arkasında kapı olan bağlam bütçesi

Her turda üç dosya yüklenir, bir script'in denetlediği ortak satır sınırı altında. Gerisi yol eşleşmesiyle gelir; 16 referans doküman ise ancak bir skill ihtiyaç duyduğunda yüklenir.

412 deny kuralı

Modelin okuyamadığı sırlar

.env, özel anahtarlar, service-account JSON'ları, Terraform state, kubeconfig. Kibarca rica eden bir prompt değil — araç çalışmadan önce harness'ın uyguladığı izin kuralları.

28 stack preset'i · stack başına ev kuralları

05 — Doğrulama

Bu sayfadaki her sayı türetilmiş, yazılmış değil.

Bir yapılandırma kiti sessizce çürür: bir kural dosyası, başka bir kuralın emekli ettiği aracı önermeye başladığında ya da bir README altı commit önce doğru olmaktan çıkmış bir sayı iddia ettiğinde hiçbir şey çökmez. Bu yüzden depo, bir test suite'inin göremediği şeyleri denetler.

npm run check; birim testlerini, frontmatter ve yönlendirme doğrulayıcılarını, link kontrolünü, tutarlılık kontrollerini, plugin manifest doğrulamasını, type-check'i, lint'i, markdown lint'i ve bağımlılık denetimini çalıştırır. Tutarlılık kontrolleri her sayıyı diskten yeniden türetir, her turda yüklenen satır bütçesini sabitler, her kuralın glob'larının iddia ettiği düzenlere ulaştığını doğrular, kitin kendi kod örneklerini etrafındaki metne göre notlandırır ve bir preset, bir kuralın emekli ettiği aracı önerirse kapıyı düşürür.

Bu sayfadaki rakamlar da derleme anında aynı türetmeden geliyor. Bulgular kök nedenden kapatılır ve kapatan kontrol yazıya dökülür, böylece aynı sınıf fark edilmeden geri gelemez. Yöntemin tamamı bu.