Addyosmani Skills

WCAG 2.2 yönergelerini takip ederek web erişilebilirliğini denetleyin ve iyileştirin. "Erişilebilirliği iyileştir", "a11y denetimi", "WCAG uyumluluğu", "ekran okuyucu desteği", "klavye navigasyonu" veya "erişilebilir hale getir" istendiğinde kullanın.

Kararlı API ve arayüz tasarımına rehberlik eder. API'ler, modül sınırları veya herhangi bir genel arayüz tasarlarken kullanın. REST veya GraphQL uç noktaları oluştururken, modüller arasında tip sözleşmeleri tanımlarken veya ön yüz ile arka yüz arasında sınırlar belirlerken kullanın.

Modern web geliştirme en iyi uygulamalarını güvenlik, uyumluluk ve kod kalitesi için uygulayın. "En iyi uygulamaları uygula", "güvenlik denetimi", "kodu modernleştir", "kod kalitesi incelemesi" veya "güvenlik açıklarını kontrol et" istendiğinde kullanın.

Gerçek tarayıcılarda Chrome DevTools MCP üzerinden test yapar. Tarayıcıda çalışan herhangi bir şeyi oluştururken veya hata ayıklarken kullanın. DOM'u incelemeniz, konsol hatalarını yakalamanız, ağ isteklerini analiz etmeniz, performans profili çıkarmanız veya gerçek çalışma zamanı verileriyle görsel çıktıyı doğrulamanız gerektiğinde kullanın. chrome-devtools MCP sunucusunun yapılandırılmış olmasını gerektirir.

CI/CD pipeline kurulumunu otomatikleştirir. Derleme ve dağıtım hatlarını kurarken veya değiştirirken kullanın. Kalite kapılarını otomatikleştirmeniz, CI'da test çalıştırıcılarını yapılandırmanız veya dağıtım stratejileri oluşturmanız gerektiğinde kullanın.

Çok eksenli kod incelemesi yapar. Herhangi bir değişikliği birleştirmeden önce kullanın. Kendiniz, başka bir ajan veya bir insan tarafından yazılmış kodu incelerken kullanın. Kodun ana dala girmeden önce birden çok boyutta kalitesini değerlendirmeniz gerektiğinde kullanın.

Kodu netlik için sadeleştirir. Davranışı değiştirmeden kodu yeniden düzenlerken kullanın. Kod çalışıyor ancak olması gerekenden daha zor okunuyor, bakımı yapılıyor veya genişletiliyorsa kullanın. Gereksiz karmaşıklık biriktirmiş kodu incelerken kullanın.

Ajan bağlam kurulumunu optimize eder. Yeni bir oturum başlatırken, ajan çıktı kalitesi düştüğünde, görevler arasında geçiş yaparken veya bir proje için kural dosyaları ve bağlam yapılandırmanız gerektiğinde kullanın.

Daha iyi sayfa deneyimi ve arama sıralaması için Core Web Vitals (LCP, INP, CLS) optimizasyonu yapın. "Core Web Vitals'ı iyileştir", "LCP'yi düzelt", "CLS'yi azalt", "INP'yi optimize et", "sayfa deneyimi optimizasyonu" veya "düzen kaymalarını düzelt" istendiğinde kullanın.

Sistematik kök neden hata ayıklamayı yönlendirir. Testler başarısız olduğunda, derlemeler bozulduğunda, davranış beklentilerle eşleşmediğinde veya beklenmedik bir hatayla karşılaştığınızda kullanın. Tahmin yürütmek yerine kök nedeni bulmak ve düzeltmek için sistematik bir yaklaşıma ihtiyaç duyduğunuzda kullanın.

Kullanımdan kaldırma ve geçişi yönetir. Eski sistemleri, API'leri veya özellikleri kaldırırken kullanın. Kullanıcıları bir uygulamadan diğerine geçirirken kullanın. Mevcut kodu sürdürmeye veya sonlandırmaya karar verirken kullanın.

Kararları ve dokümantasyonu kaydeder. Mimari kararlar alırken, genel API'leri değiştirirken, özellikler yayınlarken veya gelecekteki mühendislerin ve ajanların kod tabanını anlaması için gerekli olacak bağlamı kaydetmeniz gerektiğinde kullanın.

Her önemsiz olmayan kararı, yürürlüğe girmeden önce yeni bağlamlı bir çekişmeli incelemeye tabi tutar. Doğruluğun hızdan daha önemli olduğu durumlarda, yabancı bir kod üzerinde çalışırken, risklerin yüksek olduğu (üretim, güvenlik hassasiyeti olan mantık, geri döndürülemez işlemler) veya güvenli bir çıktıyı daha sonra hata ayıklamaktansa şimdi doğrulamanın daha ucuz olacağı her an kullanın.

Üretim kalitesinde, erişilebilir, duyarlı kullanıcı arayüzleri oluşturur. Arayüzler ve sayfalar oluştururken veya değiştirirken, bileşenler geliştirirken, düzenler uygularken, WCAG erişilebilirlik gereksinimlerini karşılarken, durum yönetimi yaparken veya çıktının yapay zeka tarafından üretilmiş gibi değil, üretim kalitesinde görünmesi ve hissettirmesi gerektiğinde kullanın.

Git iş akışı uygulamalarını yapılandırır. Herhangi bir kod değişikliği yaparken kullanın. Commit, branching, çakışma çözümleme veya birden fazla paralel akışta çalışmayı organize etmeniz gerektiğinde kullanın. Bir sürüm çıkarırken, semantik versiyon artışı seçerken, etiketleme yaparken veya changelog yazarken kullanın.

Ham fikirleri, yapılandırılmış ıraksak ve yakınsak düşünme yoluyla keskin, uygulanabilir kavramlara dönüştürür. Bir fikir hâlâ belirsiz olduğunda, bir plana bağlanmadan önce varsayımları strese test etmeniz gerektiğinde veya tek bir seçenekte birleşmeden önce seçenekleri genişletmek istediğinizde kullanın. "Fikir üret", "bu fikri geliştir" veya "planımı strese test et" ifadeleriyle tetiklenir.

Değişiklikleri aşamalı olarak teslim eder. Birden fazla dosyayı etkileyen herhangi bir özellik veya değişiklik uygulanırken kullanın. Bir kerede büyük miktarda kod yazmak üzereyken veya bir görev tek adımda tamamlanamayacak kadar büyük hissettirdiğinde kullanın.

Extracts what the user actually wants instead of what they think they should want. Achieves this through one-question-at-a-time interview until ~95% confidence about the underlying intent. Use when an ask is underspecified ("build me X" without "for whom" or "why now"), when the user explicitly invokes ("interview me", "grill me", "are we sure?", "stress-test my thinking"), or when you catch yourself silently filling in ambiguous requirements before any plan, spec, or code exists.

Kodu enstrümante ederek üretim davranışının görünür ve teşhis edilebilir olmasını sağlar. Loglama, metrik, izleme veya uyarı eklerken kullanın. Üretimde çalışan ve çalıştığına dair kanıta ihtiyaç duyduğunuz bir özelliği dağıtırken kullanın. Üretim sorunları raporlandığında ancak mevcut verilerden ne olduğunu anlayamadığınızda kullanın.

Web performansını optimize ederek daha hızlı yüklenme ve daha iyi kullanıcı deneyimi sağlar. "Sitemi hızlandır", "performansı optimize et", "yüklenme süresini azalt", "yavaş yüklemeyi düzelt", "sayfa hızını iyileştir" veya "performans denetimi" istendiğinde kullanılır.

Uygulama performansını frontend, backend, sorgular ve veritabanları genelinde optimize eder. Performans gereksinimleri olduğunda, performans düşüşlerinden şüphelenildiğinde, Core Web Vitals veya yükleme sürelerinin iyileştirilmesi gerektiğinde, N+1 sorgu desenlerinin düzeltilmesi gerektiğinde veya profil oluşturma darboğazları ortaya çıkardığında kullanın.

İşi sıralı görevlere böler. Bir spesifikasyonunuz veya net gereksinimleriniz olduğunda ve işi uygulanabilir görevlere ayırmanız gerektiğinde kullanın. Bir görev başlamak için çok büyük göründüğünde, kapsamı tahmin etmeniz gerektiğinde veya paralel çalışma mümkün olduğunda kullanın.

Kodu güvenlik açıklarına karşı sağlamlaştırır. Kullanıcı girdisi, kimlik doğrulama, veri depolama veya harici entegrasyonlarla çalışırken kullanın. Güvenilmeyen verileri kabul eden, kullanıcı oturumlarını yöneten veya üçüncü taraf hizmetlerle etkileşime giren herhangi bir özellik oluştururken kullanın.

Arama motoru görünürlüğü ve sıralaması için optimize et. "SEO'yu iyileştir", "arama için optimize et", "meta etiketleri düzelt", "yapılandırılmış veri ekle", "site haritası optimizasyonu" veya "arama motoru optimizasyonu" istendiğinde kullan.

Üretim lansmanlarını hazırlar. Üretime dağıtım yapmaya hazırlanırken kullanın. Lansman öncesi kontrol listesine ihtiyacınız olduğunda, izleme kurarken, aşamalı bir dağıtım planlarken veya bir geri alma stratejisine ihtiyacınız olduğunda kullanın.

Her uygulama kararını resmi dokümantasyona dayandırır. Yetkili, kaynakça atıflı ve güncelliğini yitirmiş desenlerden arınmış kod istediğinizde kullanın. Doğruluğun önemli olduğu herhangi bir framework veya kütüphane ile geliştirme yaparken kullanın.

Kodlamadan önce spesifikasyonlar oluşturur. Yeni bir proje, özellik veya önemli bir değişikliğe başlarken ve henüz hiçbir spesifikasyon mevcut değilken kullanın. Gereksinimler net olmadığında, belirsiz olduğunda veya yalnızca belirsiz bir fikir olarak var olduğunda kullanın.

Geliştirmeyi testlerle yönlendirir. Herhangi bir mantık uygularken, herhangi bir hatayı düzeltirken veya herhangi bir davranışı değiştirirken kullanın. Kodun çalıştığını kanıtlamanız gerektiğinde, bir hata raporu geldiğinde veya mevcut işlevselliği değiştirmek üzereyken kullanın.

Ajan becerilerini keşfeder ve çağırır. Bir oturum başlatırken veya mevcut göreve hangi becerinin uygulanacağını keşfetmeniz gerektiğinde kullanın. Bu, diğer tüm becerilerin nasıl keşfedileceğini ve çağrılacağını yöneten meta-beceridir.

Performans, erişilebilirlik, SEO ve en iyi uygulamaları kapsayan kapsamlı web kalite denetimi. "Sitemi denetle", "web kalitesini gözden geçir", "lighthouse denetimi çalıştır", "sayfa kalitesini kontrol et" veya "web sitemi optimize et" dendiğinde kullanılır.