Kalıplara genel bakış

Kalıp, belirli bir teknoloji yığını ya da belirli bir geliştirme problemi için kullanıma hazır bir ekip bilgisi paketidir. Çalışma alanına boş başlayıp her hafıza kaydını, kuralı ve beceriyi elle yazmak yerine bir kalıp eklersiniz; yapay zekâ asistanınız da projeye, o yığının genellikle ihtiyaç duyduğu konvansiyonları ve sık yapılan hataları zaten bilerek başlar.

Her kalıp, Pathrule'un zaten kullandığı üç içerik türünden oluşan bir pakettir ve her parça ait olduğu yola önceden bağlanmış olarak gelir. Server component'lerle ilgili bir kural /app yoluna, faturalamayla ilgili bir hafıza kaydı faturalama servisine, bir inceleme becerisi ise köke yerleşir. Hiçbir şey tek bir genel dosyaya yığılmaz.

Kalıplar neden var

Çoğu depo, ilk aşamada aynı sorularla karşılaşır. Bir Next.js App Router projesinde server ve client component'ler nasıl ayrılmalı? Supabase row-level security kuralları nerede tutulmalı? Bir Stripe webhook'unu güvenli şekilde işlemenin yolu ne? Geliştirme ortamında hızlı çalışan bir sorgu production'da neden deadlock'a giriyor? Bu soruların cevapları iyi bilinir, ama her ekip onları yeniden keşfeder ve yeniden yazar.

Kalıplar bu cevapları bir kez, yola bağlı Pathrule içeriği olarak kayda geçirir; böylece yeni bir çalışma alanı onları saniyeler içinde benimseyebilir:

• Önceden yola bağlı, öylece yapıştırılmış değil. Kalıp, bir prompt yığını değildir. Her parça hangi yolda yaşadığını belirtir, böylece asistanınız onu yalnızca ilgili olduğu yerde görür. Arayüzdeki küçük bir değişiklik için hiçbir zaman bir veritabanı kuralını okumak gerekmez.
• Türü belli, serbest metin değil. Kalıp, kendi yazdığınız türlerle aynı olan hafıza kayıtları, kurallar ve becerilerden oluşur. İçe aktarılan bir kural kapsam türünü ve önceliğini korur; içe aktarılan bir beceri adıyla çağrılabilir.
• Konuya göre bir araya getirilmiş. Kurallar, hafıza kayıtları ve beceriler arasındaki denge her kalıpta farklıdır. Bir framework kalıbı katı konvansiyonları için ağırlıklı olarak kurallara dayanır; bir iş akışı kalıbı ise kontrol listesi gibi çalıştırdığınız becerilere ağırlık verir.
• İçe aktardıktan sonra sizin. Bir kalıbı içe aktarmak canlı bir abonelik değil, tek seferlik bir başlangıç içeriğidir. Parçalar çalışma alanınızda sıradan içeriğe dönüşür ve onları diğer her şey gibi düzenlersiniz.

Katalog

Herkese açık katalog pathrule.io/patterns adresindedir. Hepsi birinci taraf ve Apache-2.0 lisansıyla yayımlanmış 150 kalıp içerir ve bunlar sekiz kategoride düzenlenmiştir:

• Framework: uygulama ve platform framework'leri için; Next.js App Router, Nuxt, SvelteKit, Astro ve React Router'dan Django, Rails, Laravel, Spring Boot, ASP.NET Core, SwiftUI, Flutter, Expo ve Unity'ye kadar.
• Frontend: component'ler, formlar, state, stil, erişilebilirlik, Core Web Vitals, hydration, uluslararasılaştırma ve çevrimdışı davranış için.
• Backend: veri erişimi, ORM'ler, kuyruklar, arama, API'ler, kimlik doğrulama, çok kiracılılık (multi-tenancy) ve veritabanı performansı için.
• Billing: ödemeler, abonelikler, faturalama ve vergi, checkout, payout'lar, iadeler ve itirazlar için.
• Infra: container'lar, serverless çalışma ortamları, CI/CD, kod olarak altyapı, gözlemlenebilirlik, önbellekleme, DNS ve TLS için.
• Workflow: kod incelemesi, hata ayıklama, bağımlılık yükseltmeleri, Git iş akışları, sürümler, olaylar (incident) ve ekibe katılım (onboarding) için.
• AI: production'daki ajanlar, ajan hafızası, değerlendirmeler (eval), gözlemlenebilirlik, guardrail'ler, fine-tuning ve yapay zekâ tarafından üretilen kodun doğrulanması için.
• Security: hesap ele geçirme ve MFA, servis kimlik bilgileri, rate limiting, şifreleme, yetkilendirme, kurumsal SSO ve en az yetki ilkesi için.

Katalog sayfasında bir kategori kenar çubuğu ve bir arama kutusu bulunur. Her kalıbın, şunları gösteren kendi sayfası vardır:

• bir içerik özeti: paketin kendisinden çıkarılan kural, hafıza kaydı ve beceri sayıları
• her hedef yolu gösteren bir yol haritası ve yola göre gruplanmış tüm parçaların listesi
• kalıbın neden var olduğu: çözdüğü problem, kimin için hazırlandığı ve asistanınızın yapmasını engellediği hatalar
• kalıbı eklemek için kullanılan token, bir kopyalama düğmesiyle birlikte, ayrıca paketin tamamının elle kopyalanabilir hali
• lisansı, sürümü ve son güncellenme tarihi, kaynağa giden bir bağlantıyla birlikte

Her kalıp ayrıca /patterns/<slug>/raw adresinde düz Markdown olarak sunulur (sayfadaki "View as markdown" bağlantısı); böylece bir yapay zekâ asistanı paylaşılan bir bağlantıdan paketin tamamını doğrudan okuyabilir.

Kalıplar Pathrule'un geri kalanıyla nasıl birleşir

Kalıp, yeni bir çalışma zamanı kavramı getirmez. Zaten bildiğiniz modelin üzerine kurulmuş bir paketleme biçimidir:

• Parçalar hafıza kayıtları, kurallar ve becerilerdir.
• Her parçanın yolu, kendi yazdığınız içerikteki yol kapsamı kuralının aynısını kullanır.
• İçe aktarıldıktan sonra parçalar, çalışma alanınızın geri kalanıyla aynı hook'lar ve aynı tam zamanında (just-in-time) arama mekanizması üzerinden ajana gelir.

Bütün fikir bu: Kalıp, asistanınızın zaten okuduğu biçimin birebir aynısıyla ifade edilmiş, özenle derlenmiş bir başlangıç avantajıdır.

Sırada ne okumalı

• Bir kalıbın anatomisi, içerik modelini ayrıntılarıyla ele alır: parçalar, yollar, sürümleme ve kataloğun arkasındaki açık paket.
• Bir kalıbı içe aktarma, token'ı, önizlemeyi ve bir paketi daha sonra kaldırmayı anlatır.
• Temel kavramlar, modelle yeni tanışıyorsanız hafıza kayıtlarını, kuralları ve becerileri açıklar.