Oversight: AI Ajanının Gerçekten Okuduğu Storybook Manifestosunu Denetler
Oversight adlı yeni Storybook eklentisi, AI ajanlarının okuduğu MCP manifestosunu denetleyerek eksik dokümantasyonu ve kırık bağlantıları yakalıyor.
Bir geliştirici, kodlama ajanının iyi belgelenmiş bir tasarım sistemini kullanmak yerine iki bileşeni sıfırdan inşa ettiğini fark etti. Sorunun kaynağı, Storybook'un MCP entegrasyonunun yalnızca otomatik oluşturulan components.json manifest dosyasını okuması; Docs sekmesini, kaynak kodu ya da JSDoc etiketlerini görmemesiydi. Manifestin dışında kalan her rehberlik, ajan için hiç yazılmamış gibiydi.
Bu boşlukları yakalamak için yazar, Oversight adında açık kaynaklı bir Storybook eklentisi geliştirdi. Eklenti manifesti, ajana sessizce eksik bağlam aktaran hata türlerine karşı denetliyor: başarısız docgen çıkarımı, yanlış docgen motoru kullanımı (react-docgen ile react-docgen-typescript farklı şekillerde TypeScript türlerini çözümlüyor), belgelenmemiş zorunlu prop'lar, eksik bileşen açıklamaları ve kırık yönlendirme bağlantıları.
Dikkat çekici bir bulgu: @deprecated gibi bileşen düzeyindeki JSDoc etiketleri ajanın aldığı yanıta hiç yansımıyor; yalnızca etiketleri temizlenmiş düz metin açıklama iletiliyor. Bu yüzden seçim rehberliğinin yapılandırılmış meta veri değil, gerçek bağlantılar içeren düz metin cümleler olarak yazılması gerekiyor. Oversight, Storybook'un bileşeni manifestten tamamen gizleyen !manifest etiketinden bilinçli olarak ayrı tutulan kendi @oversightIgnore etiketini sunuyor; böylece linter muafiyetleri yanlışlıkla ajanın görüş alanından bir bileşeni silmiyor.
MCP üzerinden yapay zeka ajanlarını giderek daha fazla ön yüz iş akışlarına dahil eden ekipler için bu durum daha geniş bir soruna işaret ediyor: insanlar için tasarlanmış dokümantasyon hatları, makine tüketicilerine bağlamı otomatik olarak aktarmıyor ve standart bir Storybook derlemesi bunu şu an sessizce hiçbir şekilde işaretlemiyor.