Pokayoke: Hataları Önceden Engelleyen Repository Politikası

1960'larda Japon üretim ustası Shigeo Shingo, yazılım geliştiricilerin çok iyi bildiği bir soruna çözüm bulmuştu: hataları nasıl imkânsız hale getirirsiniz ya da en azından anında fark edilir kılarsınız?

Mantık oldukça basit. İnsanların kurallara kusursuzca uymasına güvenmek yerine, sapmaları otomatik olarak yakalayan sistemler tasarlıyorsunuz. Tek bir şekilde takılan bir soket gibi. Bir şey yanlış hizalandığında hattı durduran bir sensör gibi. Üretimde bu, müşteriye ulaşan hataları önlüyor. Yazılımda ise kod standartlarından sapmaların production ortamına çıkmasını engelliyor.

Pokayoke.codes bu felsefeyi, yapay zeka destekli geliştirme çağı için sıfırdan tasarlanmış bir araçla repository'lerinize taşıyor.

Linter'ların Ötesinde: Politika Belgeleme

Çoğu ekip zaten linter kullanıyor. ESLint kullanılmayan değişkenleri yakalıyor. Prettier formatlamayı standartlaştırıyor. TypeScript tip hatalarını caught ediyor. Bu araçlar işlerini iyi yapıyor, ama zimmanda saklı olan örtük bilgiyi yakalayamıyorlar. Herkesin bildiği ama kimsenin yazıya dökmediği kuralları.

Belki API endpoint'leriniz belirli bir naming pattern'ı izliyordur. Belki bazı bağlamlar için hangi paketlerin kabul edilebilir olduğuna dair kurallarınız vardır. Ya da dosya organizasyonuyla ilgili, hiçbir yerde zorunlu tutulmayan bir takım anlaşmalar.

İşte pokayoke buradaki boşluğu dolduruyor. Geleneksel linting kapsamı dışında kalan ama kod tutarlılığı için en az o kadar önemli olan, repository'ye özgü değişmezleri kod haline getirmenize olanak tanıyor.

Önce Ajanlar

Pokayoke'yi gerçekten ilginç kılan şey: ajanlar için tasarlanmış olması.

Modern kodlama asistanları codebase'inizde gezinebiliyor, yeni özellikler yazabiliyor, mevcut kodu refactor edebiliyor. Ama onları takımınızın kurallarıyla uyumlu tutmak? Hâlâ manuel bir süreç. System prompt'a kurallar ekleyebilirsiniz, ama ajanlar unutuyor, hallucinate yapıyor veya sizin için neyin önemli olduğunu bilmiyor.

Pokayoke, politika kurallarını ajanların okuyabileceği, anlayabileceği ve harekete geçebileceği birincil vatandaşlar olarak ele alarak bu sorunu çözüyor. pokayoke agent SKILL.md komutu ajanları özerk bir şekilde çalıştırıyor ve kuralların kendisi, insan geliştiriciler için değil, AI tarafından yazılıp bakımı yapılacak şekilde tasarlanmış.

AI'nın ağır işleri hallettiği bir Vibe Coding workflow'u kuruyorsanız, pokayoke standartlarınızı gerçekten işe yarayan bir formatta iletmenizi sağlıyor.

Mevcut Stack'inizle Uyumlu

Yeni bir araç eklemekle ilgili endişe, dağınıklık riski. Zaten ESLint, Prettier, Husky ve codebase'inizi düzende tutan onlarca araç var. Pokayoke eklemek bunların hiçbirini değiştirmek zorunda değil—mevcut pipeline'ınızı genişletmek anlamına geliyor.

Dokümantasyon, pokayoke'nin tarafsız olduğunu vurguluyor. Formatlama onu ilgilendirmiyor (bu Prettier'ın işi) veya genel kod kalitesi (ESLint buna bakıyor). Bunun yerine, yalnızca sizin takımınızın bildiği projeye özgü değişmezlere odaklanıyor.

TypeScript kuralları repo'nuzda lokal ve yalnızca sizin özel kurulumunuz için önemli olan kısıtlamalara karşı kontrol ediyor. Standart araçlarınızın üzerine inşa edilmiş özel bir doğrulama katmanı gibi düşünebilirsiniz.

Başlangıç

Repository'nizi hatalardan korumaya hazır mısınız? Kurulum oldukça kolay:

npx skills add rorz/pokayoke

Ardından takımınızın kurallarını tanımlayan kurallar yazabilirsiniz. Kurallar kendi kendini belgeleyecek şekilde tasarlanmış—hem insanlar hem de ajanlar hangi politikaların yürürlükte olduğunu ve nedenini anlamak için okuyabiliyor.

Büyük Resim

Pokayoke, kod kalitesi araçlarına bakış açımızda ilginç bir değişimi temsil ediyor. Geleneksel linter'lar sözdizimi ve stili zorunlu kılıyor. Statik analiz araçları hataları yakalıyor. Ama yapay zeka kodlama asistanları birincil işbirlikçilerimiz haline geldikçe, ajanların gerçekten anlayıp takip edebileceği şekilde niyeti ileten yeni araç kategorilerine ihtiyacımız var.

Artık sadece hataları yakalamakla ilgili değil. Standartlarınızı makine tarafından okunabilir, ajan dostu ve ihlal edilmesi zırhlı hale getirmekle ilgili—ister insan geliştiriciden ister AI asistanından gelsin.

Bu anlamda pokayoke, belki de birkaç yıl içinde hepimizin kod yazma şeklimiz için özel olarak oluşturulmuş ilk araçlardan biri. Göz atmaya değer.