İlkeler
Nasıl inşa ederiz.
Yapay zeka ajanları hızlıca kod üretebilir, ama disiplinsiz hız yalnızca hataları daha hızlı sahaya sürer. Bunlar her projeyi tabi tuttuğumuz tavizsiz temellerdir — açık kaynak becerilerimizin, ajanların varsayılan olarak izlemesi için kodladığı aynı temeller.
Sezgiler yerine standartlar
Bir ilke ancak bir makine onu denetleyebiliyorsa geçerlidir. Aşağıdaki her temel, araçlarımızdaki somut bir kapıya karşılık gelir — bir test, bir inceleme kuralı, gerekli bir yapıt — böylece 'bitti', iddia edilmez, kanıtlanır. İşte mühendislik becerilerimizin bir projeye kurduğu ve araştırmamızın keskinleştirmeyi sürdürdüğü şey budur.
Tavizsiz temeller
Güvenlik sunucuda kararlaştırılır
Kimlik doğrulama ve yetkilendirme sunucu tarafında uygulanır, asla istemcide değil. Sırlar hiçbir zaman tarayıcı paketine ulaşmaz. Arayüzdeki bir kontrol kullanıcı deneyimidir — gerçek karar, isteğin ulaştığı yerde, doğrulanmış bir kimliğe karşı verilir.
Testler davranışı kanıtlar
Bir test, yazılımın ne yaptığını öne sürer — içerik, durum, etkileşim, hata ve boş yollar — yalnızca oluşturulduğunu değil. Davranış bozulduğunda başarısız olmayan kapsam, kapsam değildir. Kalite kapıları, bir birleştirmeyi tıpkı bozuk bir derleme gibi engeller.
Her değişiklik bir denetim izi bırakır
Kaydedilmeden hiçbir iş bitmiş sayılmaz: neyin değiştiği, neden, neyin kararlaştırıldığı ve neyin reddedildiği. Arşiv, sonrasında yapılan bir evrak işi değil, teslimatın bir parçasıdır — böylece gerekçe, onu üreten oturumdan sonra da yaşar.
Önce kimlik gelir
Her proje sağlam bir IAM ile başlar: kimlik bir e-posta değildir, erişim ilişki temellidir ve varsayılan olarak çok kiracılıdır, parolasızlık ise hedeftir. Yetkilendirme, bir ihlalden sonra eklenmiş değil, ilk günden ince tanelidir.
Varsayılan olarak açık
Araçlarımız açık kaynak, bulgularımız kamuya açıktır. Önemliyse, onu okuyabilir, çalıştırabilir, çatallayabilir ve üzerine inşa edebilirsiniz. Mesele yeniden üretilebilirliktir — yeniden üretemediğiniz bir sonuç bir görüştür.
Sahaya çıkar, biriktirme
İnşa ederek ve sahaya çıkararak araştırırız; laboratuvar ve ürünler birbirini besler. Amaç, doğru yolu kolay yol yapmaktır — standardı kuran, güncel tutan ve geliştiricinin yolundan çekilen araçlar.
Temelleri kodda gör.
Yukarıdaki ilkeler, Claude Code için kurulabilir mühendislik becerileri olarak kodlanmıştır — ve kaynağın tamamı GitHub'da.