Chrome, Edge, Firefox ve MDN ekipleri kodlama ajanları için Modern Web Guidance'ı yayınladı

Ne yayınlandı

GitHub'daki Google Chrome organizasyonu, yapay zekâ kodlama ajanlarının web platformuna güncel kalmasını sağlamak için tasarlanmış bir beceri seti olan Modern Web Guidance'ı yayınladı. README'sine göre, 10 Kasım'da Hacker News'te bir Show HN gönderisiyle duyurulan projeyi Google Chrome, Microsoft Edge, Mozilla Firefox ve MDN ekipleri web geliştirici topluluğuyla birlikte yürütüyor.

Kurulum tek bir komutla yapılıyor: npx modern-web-guidance@latest install. Bu komut, rehberliği bir ajan için yapılandıran etkileşimli bir sihirbaz çalıştırıyor. Araç hiçbir şey kurmadan da denenebiliyor: search bir görevle ilgili kılavuzları buluyor, retrieve belirli bir belgeyi kimliğine göre getiriyor ve legacy-scan mevcut bir kod tabanını tarayıp modernize edilebilecek eski kalıpları işaretliyor.

Hedeflenen sorun

Projenin gerekçesi doğrudan: kodlama ajanları eski çözümlere yöneliyor, çünkü eğitim verilerinde çok büyük miktarda eski kod var; bu yüzden platformun artık yerel olarak çözdüğü görevler için gereksiz yere ağır JavaScript üretiyorlar. README'de belirtildiği üzere, bir model modern bir API'nin varlığını bilse bile, onu doğru kullanmak için gereken yoğunluktaki gerçek dünya, üretime hazır uygulama kalıplarına çoğu zaman sahip değil. Hacker News başlığı hedefi, ajanları kabaca 2019 dönemi JavaScript'ten modern web ilkelere taşımak olarak çerçeveliyor.

Modern Web Guidance, CLI'sı aracılığıyla platform uzmanları tarafından özenle hazırlanmış odaklı kılavuzları doğrudan ajanın context window'una ileterek çalışıyor. İçeriği üç öncelik şekillendiriyor: modellerin sık yanlış kullandığı modern tarayıcı API'lerinin doğru yapılandırılması; tarayıcının optimize edebileceği ve yerleşik erişilebilirlik desteği taşıyan platform düzeyinde API'lerin tercih edilmesi; ve ağır polyfill'ler ya da eski kütüphaneler yerine hafif geri dönüş çözümleri.

Kılavuzların kapsamı

Proje 250 modern web özelliğini ve 203 gerçek dünya geliştirici kullanım senaryosunu belgeliyor. Depunun kendi dökümüne göre bu özelliklerden 140'ı CSS ve düzenle, 36'sı HTML ve DOM ile, 74'ü ise JavaScript ve API'lerle ilgili.

İçerik altı disipline ayrılmış durumda:

• Kullanıcı deneyimi — view transition'lar, giriş ve çıkış animasyonları, parallax kaydırma, scrollbar-color
• CSS düzeni — container query'ler, subgrid, oklch gibi modern renk uzayları, text-wrap ayarı, line-height kırpma
• Performans — anında ön yükleme, Interaction to Next Paint teşhisi, scheduler.yield ile görev zamanlama
• Formlar ve UI — tooltip'ler için anchor positioning, Popover API, dialog'lar, :user-invalid doğrulaması, otomatik boyutlanan alanlar
• Erişilebilirlik — ekran okuyucu ve klavye ile çalışabilirlik, içerik gezinme ve keşfedilebilirlik
• Yerleşik yapay zekâ — tarayıcıya özgü çeviri, özetleme ve dil algılama

Context window alanı sınırlı olduğundan kılavuzlar token verimli olacak şekilde yazılıyor; ekip, modellerin zaten bildiği materyali budamak için eval çalıştırıyor, böylece token'lar yalnızca rehberliğin gerçekten gerekli olduğu yerde harcanıyor. Bir eval panosu ve tüm kaynak kodu belgelerle birlikte yayımlandı.

Neden önemli

Yapay zekâ asistanları artık yeni kodların büyük bir bölümünü yazıyor ve alışkanlıkları birikiyor: ajanların bugün ürettiği kalıplar, kod inceleyicilerin, refactor araçlarının ve gelecekteki eğitim verilerinin devraldığı taban haline geliyor. Ajanlar platformun gerisinde kalırsa — modal arka planları elle oluşturur, tooltip kütüphaneleri sevk eder veya yerel ilkelerin olduğu yerde polyfill'ler üst üste yığırsa — bu gecikme tüm ekosisteme yayılıyor.

Proje, arkasında kimlerin durduğu bakımından da dikkat çekici. Tek bir satıcının kendi API'lerini tanıttığı bir girişim yerine, içerik Chrome, Edge ve Firefox ekipleri ile MDN tarafından ortaklaşa korunuyor; bu da ona benzer kaynakların nadiren taşıdığı tarayıcılar arası bir meşruiyet kazandırıyor. Ayrıca eski model bilgisine pragmatik bir çözümü modelliyor: eğitim verilerinin yetişmesini beklemek yerine, güncel platform rehberliği erişilebilir context olarak sunuluyor ve eval'ler onu yalın tutuyor.

Ajanları eski kod tabanlarına yönlendiren ekipler için legacy-scan komutu aynı zamanda bir modernizasyon denetim aracı olarak kullanılabiliyor; depo ise issue'lara ve topluluk katkılarına açık.