Gerçek Mühendisler İçin Skills - Matt Pocock

Matt Pocock’un ajan skill derlemesi: vibe coding değil, gerçek dünya mühendisliği için bir araç kutusu

Bu depo, TypeScript eğitmeni olarak iyi tanınan Matt Pocock’un her gün kullandığı Claude Code ajan skill’lerini, yani slash command’leri ve davranış kurallarını bir araya getirip yayımladığı bir proje. Sloganı "Skills For Real Engineers" ve yazara göre GSD, BMAD, Spec-Kit gibi tüm süreci üstlenen framework’ler geliştiricinin kontrolünü elinden alıyor ve kusur oluştuğunda iz sürmeyi zorlaştırıyor. Bunun alternatifi olarak küçük, değiştirilebilir ve herhangi bir modelle birleştirilebilen araç birimleri yaklaşımını öneriyor. Kod tabanı gerçekten açılıp incelendiğinde skill’lerin skills/ altında engineering, productivity, misc, personal, in-progress, deprecated gibi bölümlere ayrıldığı ve her skill’in kendi SKILL.md dosyasına sahip bağımsız bir birim olarak yönetildiği görülüyor.

• Kurulum yolunun sadeliği: npx skills@latest add mattpocock/skills tek satırıyla kuruluyor ve /setup-matt-pocock-skills ile issue tracker türü, triage sırasında kullanılacak etiket sözlüğü ve dokümanların saklanacağı konum tek seferde ayarlanıyor. Her depo için yalnızca bir kez çalıştırmak yeterli; diğer skill’ler bu ayarı paylaşıyor.

• Ajan başarısızlık modlarını dört başlıkta toparlayan tasarım niyeti: İlki, "isteneni üretememe" hizalanma problemi; grill-me ve grill-with-docs, niyeti en sonuna kadar sorgulayan bir görüşme oturumunu zorunlu kılıyor. İkincisi, "aşırı geveze ajan" problemi; alan terimleri sözlüğü gibi çalışan CONTEXT.md, hem token israfını hem de adlandırma tutarsızlığını azaltıyor. Üçüncüsü, "kodun çalışmaması" problemi; tdd red-green-refactor döngüsünü, diagnose ise yeniden üretimden regresyon testine kadar olan debug döngüsünü üstleniyor. Dördüncüsü, "çamur topuna dönmüş kod" sorunu; to-prd, zoom-out, improve-codebase-architecture modül sınırlarını ve sistem perspektifini yeniden kurma görevini üstleniyor.

• Paylaşılan dili ele alış biçimindeki fark: Basit bir kodlama yardımının bir adım ötesine geçerek, ajan ile insan arasındaki söz varlığını açıkça eşleştirmeye ağırlık veriyor. Örnek olarak sunulan course-video-manager içindeki CONTEXT.md, "bir kurs içindeki bölüm içindeki dersin dosya sisteminde yer kazandığı andaki problem"i "materialization cascade" adlı tek bir ifadeye sıkıştırıyor; böylece aynı konuşma tekrarlandıkça hem token maliyeti hem de bilişsel maliyet düşüyor.

• İkincil skill’lerin pratikliği: Günlük iş akışları için caveman (yaklaşık yüzde 75 token tasarrufu hedefleyen sıkıştırılmış yanıt modu) ve write-a-skill (skill üretmek için kullanılan bir meta skill) birlikte sunuluyor. Yardımcı araç paketinde ise git-guardrails-claude-code (tehlikeli git komutlarını önceden engelleyen hook kurulumu) ve setup-pre-commit (Husky + lint-staged tabanlı pre-commit yapılandırması) gibi öğeler bulunuyor; yani kod yazmanın dışındaki alanlar da küçük araçlara bölünerek ele alınıyor.

• Deponun kendi işletim kuralları: engineering, productivity, misc içine giren skill’ler mutlaka üst düzey README’ye ve .claude-plugin/plugin.json dosyasına kaydedilmek zorunda. Buna karşılık personal, in-progress, deprecated için kayıt yasak; böylece görünürlük kapsamı kod seviyesinde zorlanıyor. ADR belgelerinin ayrı bir dizinde bulunması ve skill bağlantıları için shell script’lerin scripts/ altında tutulması da aynı disiplinin uzantısı olarak okunabilir.

Genel olarak bu proje, "ajan her şeyi kendi halleder" türü bütünleşik otomasyondan uzak duruyor ve Pragmatic Programmer, Domain-Driven Design, Extreme Programming, A Philosophy of Software Design gibi klasik mühendislik ilkelerini küçük ve değiştirilebilir slash command birimlerine ayırıp taşımış bir yapıya daha çok benziyor. Gösterişli workflow otomasyon araçları bekleyen kullanıcıya biraz sade görünebilir; ancak ajan çağında bile hizalanma, paylaşılan dil, geri bildirim döngüsü ve modül tasarımı gibi temel becerileri günlük araçlara indirme girişimi olması bakımından pratiğe daha yakın bir tona sahip.