oh-my-harness - Yapay zeka kodlama ajanları için hook oluşturucu CLI

Merhaba. Claude Code ve Codex kullanırken, promptlara güvenemeyip(?) hook oluşturucu olan oh-my-harness adlı bir CLI geliştiriyorum.

Başta yalnızca CLAUDE.md ya da AGENTS.md içine aşağıdaki gibi talimatlar ekliyordum.

Önce testleri düzelt
Commit atmadan önce testleri çalıştır
main branch'ine commit atma
node_modules ya da dist ile oynama
.env dosyasını değiştirme

Ama kullanmaya devam ettikçe, talimatların büyük kısmını görmezden gelip bir noktadan sonra artık uygulamamaya başladı.

Özellikle TDD ile geliştirmesini söylememe rağmen
“Üzgünüm, testleri düzeltmedim”
demesi ya da,

çoktan merge edilmiş bir branch olup olmadığını kontrol etmesini istemişken, commit push ettikten sonra
“Henüz merge edilmiş bir branch değil”
diye diretmesi gibi(?)

Bunun üzerine oh-my-harness'ı yaptım.

Ajanlar için bir CLI, insanlar içinse bir TUI sunuyor.

omh init "React app with TDD"  

veya

omh init  

Bunu çalıştırdığınızda projeyi inceleyip harness.yaml oluşturuyor; ardından bunu temel alarak Claude Code için CLAUDE.md, Codex için AGENTS.md ve her runtime'ın hook yapılandırmasını birlikte üretiyor.

Örneğin şu anda bunları engelleyebiliyor veya kontrol edebiliyor:

• main ya da zaten merge edilmiş bir branch'te commit atmaya çalışırsanız engelleme
• Commit öncesinde test veya type check çalıştırma
• Testleri önce düzeltmeden yalnızca kaynak kodu değiştirmeye çalışırsanız TDD kuralıyla engelleme
• node_modules, dist, .next, .env gibi dosya/klasörleri koruma
• Tehlikeli shell komutlarını filtreleme

Bunların tamamı, benim katalog adını verdiğim, önceden hazırlanmış shell script koleksiyonlarıyla çalışıyor.

omh init, kendisine verilen doğal dil ifadesinden uygun kataloğu seçip belirleme görevini üstleniyor.

Kişisel olarak, yapay zeka kodlama araçlarını kullanırken “hadi kolay gelsin” demektense, hata yaptığında anında durduran güvenlik önlemlerinin çok daha önemli olduğunu hissettim.

Özellikle ajanlar giderek daha fazla dosyayı değiştirip bunu commit'e kadar uzanan doğal bir akışa dönüştürdükçe, bu tür mekanizmalara daha fazla ihtiyaç duyulacak gibi göründü.

———

Kurulum: npm install -g oh-my-harness

GitHub: https://github.com/kyu1204/oh-my-harness

npm: https://www.npmjs.com/package/oh-my-harness

Henüz çok erken aşamada, bu yüzden eksik kalan pek çok nokta var.
Deneyip görüşlerinizi paylaşırsanız sevinirim. Katkılar da memnuniyetle karşılanır!