Yapay Zekâya Kod Yazdırırken Delirmemek İçin 4 İlaç Repo: Impeccable, Claude-Mem, Skills ve Superpowers

Terminalde veya IDE'de bir yapay zekâ ajanına (Claude Code, Cursor, Codex, OpenClaw vb.) kod yazdırmaya çalışırken 'Dur yapma onu!', 'Abi 5 dakika önce konuştuk ya!', 'Neden her butona mor degrade basıyorsun?' diye ekrana bağıran tek kişi siz değilsiniz.

Mesele modellerin zekâsı değil; modellerin çalışma disiplini, hafızası, alet çantası ve estetik zevkinin olmaması. Kendi haline bıraktığınızda en gelişmiş yapay zekâ bile aceleci bir stajyer gibi davranır: Ne yapacağını sormadan 15 dosyayı birden değiştirir, dünkü mimari kararları unutur, kütüphanenin 3 yıl önceki eski sürümlerini uydurur ve ortaya ruhsuz, jenerik bir tasarım çıkarır.

Yapay Zekâ ile Kod Yazarken Karşılaşılan 4 Büyük Baş Ağrısı

1. Superpowers (obra/superpowers): Aceleci Stajyeri Kıdemli Mühendise Dönüştürmek

Diyelim ki ajana 'Bize bir sepet sistemi ekle' dediniz. Normal şartlarda ajan ne yapar? Sormadan etmeden src/ içindeki 10 dosyayı aynı anda açar, kafasına göre tipleri değiştirir, test yazmaz, derleme hatası verince paniğe kapılıp daha çok dosya bozar.

Jesse Vincent (@obra) tarafından geliştirilen Superpowers, ajanın eline vurup 'Dur bakalım!' diyen bir mühendislik protokolüdür. Ajanı koda dokunmadan önce gerçek bir kıdemli yazılımcı gibi düşünmeye zorlar:

• Önce Beyin Fırtınası ve Planlama: Kod yazmaya başlamadan önce ne yapacağını, hangi dosyaları değiştireceğini madde madde önünüze koyar ve sizden onay almadan tek satır kod yazmaz.
• TDD (Test-Driven Development): Kodu yazmadan önce testi yazar. Testin önce patladığını (kırmızı) görür, ardından testi geçecek minimum kodu yazar (yeşil).
• Git Worktrees ile İzolasyon: Ana çalışma alanınızı kirletmeden, temiz bir worktree dalında çalışır. İş bitip testler geçince güvenle birleştirir.
• Sistemik Hata Ayıklama (Debugging): Tahmin yürüterek deneme-yanılma kodu basmaz; loglarla ve adım adım kanıt toplayarak kök nedeni çözer.

Superpowers'ı Claude Code veya uyumlu ajanınıza kurmak oldukça basittir:

# Superpowers pazar yerini ekleyin
/plugin marketplace add obra/superpowers-marketplace

# Eklentiyi kurun
/plugin install superpowers@superpowers-marketplace

2. Claude-Mem (thedotmack/claude-mem): Ajanın Balık Hafızasına Son

Hepimizin başına gelmiştir: 3 saat boyunca yapay zekâya projenin mimarisini, GraphQL şemasını, neden PostgreSQL kullandığımızı anlatırsınız. Harika kod yazar. Terminali kapatıp yemeğe gidersiniz; geri gelip yeni oturum açtığınızda 'Selam! Ben Claude, ne yapıyoruz?' der. Her şey sıfırlanmıştır.

Claude-Mem, ajanınızın beynine yerel bir SSD takmak gibidir. Oturum boyunca arkada sessizce çalışır, yaptığınız değişiklikleri, aldığınız mimari kararları ve dosya bağlantılarını semantik olarak sıkıştırıp bilgisayarınızdaki bir SQLite veritabanına kaydeder.

Yeni bir oturum açtığınızda veya ajan bir dosya üzerinde çalışırken, MCP (Model Context Protocol) sunucusu üzerinden sadece ihtiyaç duyulan anıları ajanın bağlamına (context) sessizce fısıldar. 50 bin token harcayıp tüm geçmişi okumaz; sadece 'Biz dün authentication için şu ara katmanı yazmıştık' bilgisini çeker.

# Claude-Mem eklentisini Claude Code'a ekleyin
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem@thedotmack

3. Vercel Skills (vercel-labs/skills & skills.sh): Modüler Uzmanlık Çantası

Yapay zekâ modelleri genel kültürde harikadır ama spesifik teknolojilerin en son sürümlerinde (örneğin Next.js 15 Server Actions, React 19 hooks kuralları veya Tailwind v4) internetteki eski eğitim yazılarını hatırlayıp saçmalayabilir. Geliştiriciler genelde bunu çözmek için 40 sayfalık dökümantasyonu kopyalayıp system prompt'a yapıştırır; bu da hem context'i şişirir hem de faturayı katlar.

Vercel Labs tarafından geliştirilen Skills (skills.sh), ajanlar için adeta bir npm ekosistemidir. Ajanınıza bir dökümanı ezberletmek yerine, o işin uzmanlık kurallarını içeren modüler bir SKILL.md paketi yüklersiniz.

Ajan sadece ilgili konuyla ilgili bir işlem yapacağı zaman o yeteneği okur. Üstelik bu standart sadece tek bir araca özel değil; Claude Code, Cursor, Copilot, Cline, Antigravity dahil 18'den fazla ajan aracıyla uyumludur.

# Yetenek kataloğunda arama yapın
npx skills find react

# Vercel Labs'in resmi en iyi pratikler yeteneğini ekleyin
npx skills add vercel-labs/skills

# Belirli bir beceriyi (örn: web design kuralları) yükleyin
npx skills add vercel-labs/skills --skill web-design-guidelines

4. Impeccable (pbakaus/impeccable): AI Slop ve Çirkin Arayüzlerin Sonu

Bir yapay zekâya 'Bana modern bir landing page yap' deyin. Yemin etmiş gibi şunları üretir: Arkada lacivert zemin, ortada kocaman mor-mavi gradyanlı bir başlık, Inter fontu, 3 tane içi içe geçmiş gri border'lı kart ve sıfır özgünlük. Buna sektörde AI Slop deniyor.

Eski Google ve web standartları emektarı Paul Bakaus tarafından geliştirilen Impeccable, ajanın bu tembel alışkanlıklarını yasaklayan bir tasarım felsefesi ve komut kütüphanesidir. Ajanın tasarım yaparken uyması gereken tipografi hiyerarşisini, renk dengesini ve boşluk kurallarını zorunlu kılar.

En can alıcı özelliği ise terminalde kullanabileceğiniz sihirli yönlendirme komutlarıdır:

• /simplify: Ajanın yazdığı gereksiz 10 katmanlı div karmaşasını, gereksiz animasyonları ve göz yoran süslemeleri temizler; arayüzü ferahlatır.
• /harden: Tasarımın mobil uyumunu, klavye erişilebilirliğini (a11y), responsive kırılma noktalarını ve contrast skorlarını taş gibi sağlamlaştırır.
• /animate: Arayüze yapmacık olmayan, doğal, 60fps mikro-etkileşimler ve yumuşak geçişler ekler.
• /delight: Ruhsuz bir formu veya listeyi; tatlı boş durum (empty state) mesajları, zarif ikonlar ve kullanıcıyı gülümseten mikro detaylarla zenginleştirir.
• /extract: Şişmiş bir bileşeni temiz, yeniden kullanılabilir ve modüler alt parçalara böler.

# Impeccable tasarım kurallarını ve komutlarını ajana ekleyin
npx skills add pbakaus/impeccable

Rüya Senaryo: Bu 4 Aracı Birlikte Çalıştırdığınızda Ne Oluyor?

Bu 4 depoyu kurup projenizin başına geçtiğinizde tipik bir geliştirme döngüsü şu şekilde işler:

1. 1
   1. Görevi Verirsiniz: 'Kullanıcılar için bildirim tercihlerini yönetebilecekleri bir ayarlar sayfası ekleyelim.'
2. 2
   2. Superpowers Devreye Girer: Ajan hemen koda atlamaz. Proje yapısını inceler, mimari planı döker ve önce notification-settings.test.tsx testini yazar.
3. 3
   3. Vercel Skills Rehberlik Eder: Sayfa kodlanırken Next.js ve React Server Actions kurallarını en güncel pratiklere göre hatasız uygular.
4. 4
   4. Impeccable Arayüzü Cilalar: Jenerik mor kutular yerine /delight ve /harden ile erişilebilir, estetik, responsive ve özgün bir UI üretir.
5. 5
   5. Claude-Mem Hafızaya Kaydeder: Oturum bittiğinde bildirim mimarisini ve eklenen endpoint'leri SQLite'a yazar; yarın yeni bir özellik eklerken sıfırdan anlatmak zorunda kalmazsınız.

Hemen Başlamak İçin Hızlı Kurulum Listesi

Terminalinizi açıp aşağıdaki komutları sırayla çalıştırarak 2 dakika içinde ajanınızı tam donanımlı hale getirebilirsiniz:

# 1. Mühendislik disiplini ve planlama (Superpowers)
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# 2. Kalıcı hafıza motoru (Claude-Mem)
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem@thedotmack

# 3. Güncel kütüphane becerileri (Vercel Skills)
npx skills add vercel-labs/skills

# 4. Anti-AI-slop arayüz ve tasarım kuralları (Impeccable)
npx skills add pbakaus/impeccable