Ponytail: Yapay zeka kodlama aracını tembelleştirme

Ponytail nedir

Ponytail, bir yapay zeka kodlama aracısının daha az kod yazmasını sağlayan bir kural kümesidir. Proje kendisini tek cümleyle şöyle tanımlar: "Yapay zeka aracınızın odadaki en tembel kıdemli geliştirici gibi düşünmesini sağlar. En iyi kod, hiç yazmadığınız koddur." MIT lisansına sahiptir. Kendi çalışma zamanı yoktur ve içindeki hiçbir şey çalıştırılmaz. Bu içerik, aracının yönergelerine eklenen metinlerden oluşur. Yetenekleri yükleyen ana makineler için skill olarak, yetenek yüklemeyen ana makineler için ise düz kural dosyaları olarak paketlenmiştir.

Depo DietrichGebert/ponytail konumundadır. 12 June 2026 tarihinde oluşturulmuş ve 1 August 2026 tarihinde 90,000 yıldız sayısını aşmıştır. 1 August 2026 tarihindeki en yeni etiketli sürüm v4.8.4 olup 29 June 2026 tarihinde yayımlanmıştır. Releases sayfasında yalnızca 14 June ile 29 June arasındaki dönem için on etiket listelenmektedir. Bu hızla ilerleyen bir proje siz bunu okuduğunuzda değişmiş olacaktır. Bu nedenle üzerine herhangi bir şey oluşturmadan önce bir etiket sabitlenmelidir.

Aracın öncesindeki fikir: işe yarayan ilk basamakta durun

Ponytail'in temelinde bir karar merdiveni bulunur. Aracı, herhangi bir şey yazmadan önce bu merdiveni tırmanır ve işe yarayan ilk basamakta durur.

1. Bunun gerçekten var olması gerekiyor mu? Bu, YAGNI'dir (buna ihtiyacınız olmayacak). Yanıt hayırsa bunu atlayın.
2. Bu zaten bu kod tabanında var mı? Zaten mevcut olan yardımcıyı veya deseni yeniden kullanın.
3. Standart kitaplık bunu yapıyor mu? Onu kullanın.
4. Yerel bir platform özelliği bunu karşılıyor mu? Onu kullanın.
5. Zaten yüklenmiş bir bağımlılık bu sorunu çözüyor mu? Onu kullanın.
6. Bu tek satır olabilir mi? Tek satır hâline getirin.
7. Ancak bundan sonra, çalışan en az miktardaki kodu yazın.

İşi tek tek basamaklar değil, sıralamanın kendisi yapar. Bir aracıdan tarih seçici istendiğinde tarih seçici yazar; çünkü kendisine yapması söylenen budur. Merdiven, önce 4. basamağı kontrol etmesini sağlar ve 4. basamak tarayıcının zaten <input type="date"> özelliğine sahip olduğunu belirtir. Projenin kendi kıyaslama notlarında tam olarak bu örnek yer alır: kural olmadan 404 satır olan tarih seçici, bu kuralla 23 satıra düşmüştür; çünkü araç bir bileşen oluşturmak yerine yerel girdiyi kullanmıştır. Aynı nedenle renk seçici de 287 satırdan 23 satıra düşmüştür.

Buradaki tembellik dikkatsizlik anlamına gelmez; kural kümesi bunu doğrudan belirtir. "Asla tembellik edilmeyecek" listesinde karar vermeden önce problemi anlama, güven sınırlarında girdi doğrulama, veri kaybını önleyen hata işleme, güvenlik, erişilebilirlik ve adını açıkça verdiğiniz her şey yer alır. Ayrıca önemsiz olmayan her mantık parçası için çalıştırılabilir, küçük bir kontrol ister. Kural, yeni çözümler icat etmeyi sınırlar. Doğruluğu sınırlamaz.

Depo aslında ne yayımlar

• AGENTS.md; beş dakikada okunabilen tek dosyada tüm yaklaşımı içeren, sürekli etkin kural kümesidir.
• skills/ponytail/SKILL.md; lite, full veya ultra bağımsız değişken ipucunu içeren beceri tanımıdır.
• .cursor/rules/ ve .windsurf/rules/ gibi düzenleyiciye özgü dizinlerde bulunan kural dosyalarıdır. Bunlar kuralları okuyan ancak becerileri yüklemeyen ana bilgisayarlar içindir.
• hooks/, benchmarks/, examples/ ve scripts/.

Yoğunluk bağımsız değişkeni, kuralın ne kadar sıkı uygulanacağını değiştirir. lite, isteneni oluşturur ve tek satırda daha gevşek bir seçenek belirtir. full varsayılandır ve kademeli yapıyı zorunlu kılar. ultra, YAGNI yaklaşımının en katı ayarıdır: ekleme yerine silmeyi tercih eder ve gereksinimin kendisine bile itiraz eder.

Beceri destekleyen ana bilgisayarlar slash komutlarını da kullanabilir. /ponytail düzeyi ayarlar, /ponytail-review bir diff dosyasını aşırı mühendislik açısından denetler, /ponytail-audit bütün bir depoyu denetler, /ponytail-debt ertelenen kısayolları toplar ve /ponytail-gain karşılaştırma puan kartını yazdırır. Yalnızca kural dosyalarını okuyan ana bilgisayarlar komutlar olmadan kural kümesini kullanır.

Kaynağa güvenmeden önce okumak için branch yerine tag klonlanmalıdır:

git clone --depth 1 --branch v4.8.4 https://github.com/DietrichGebert/ponytail.git

Claude Code üzerinde proje bunun yerine bir plugin kurulumu belgeler. Aşağıdaki iki satır 1 August 2026 tarihinde belgelerde yer aldığı şekildedir:

/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail

Plugin yolu tag yerine varsayılan branch'i izler. Bu nedenle aracınızı yönlendiren talimatlar, oturumlar arasında siz fark etmeden değişebilir. Bu, bir update komutunun sağladığı kolaylık karşılığında kabul edilen ödünleşimdir.

VPS üzerinde temkinli bir aracının maliyeti neden daha düşüktür

Bir aracının yazdığı diff konuşmanın dışına çıkmaz. Sonraki turda model, açtığı tüm dosyalarla birlikte bu diff'i yeniden okur. Bu nedenle 500 satırlık bir değişiklik yalnızca onu oluşturan turu değil, oturumdaki sonraki tüm turları da yük altına sokar. Kontrolsüz bir yeniden düzenleme, oturum ilerledikçe aracının daha yavaş ve daha hatalı çalışıyor gibi görünmesine bu yüzden yol açar: bağlam penceresi aracının kendi çıktısıyla dolar ve gerçek kodunuz için kalan alan küçülür. Bunu kontrol altında tutmak, bir kodlama aracının bağlam penceresini yönetme konusunun tamamını oluşturur.

Belirteçler giriş ve çıkış yönünde ücretlendirilir. Bu nedenle boyutunun yarısı kadar olan bir diff iki kez daha ucuzdur: bir kez yazılırken ve yeniden okunduğu her turda. Self-hosted bir kurulumda maliyeti izliyorsanız talimat dosyası, kullanımı hiçbir maliyet gerektirmeyen bir denetim aracıdır. Bir yapay zeka aracının size olan maliyetini kontrol etme çıktı hacmiyle başlar. Bir kodlama aracının belirteçlerini nasıl harcadığı ise yeniden okumanın neden beklenenden daha önemli olduğunu açıklar.

Diff'i yine bir insan okur. 20 satır olması gerekirken 400 satır olan bir değişiklik, incelemeyi yapan kişinin dikkatini tüketir. Dikkat, ilk tükenen kaynaktır. Hiç kimse günün dördüncü uzun diff'ini, ilk diff'e gösterdiği özenle incelemez. Bu nedenle gereğinden fazla geliştirme yalnızca zaman kaybettirmez. Hataları yakalaması gereken incelemenin kalitesini de fark edilmeden düşürür.

Sunucuda riskin niteliği değişir. Bunun nedeni, aracının çoğu zaman kimse izlemeden çalışmasıdır. tmux oturumunda veya zamanlayıcı üzerinden çalışan bir aracının, siz fark etmeden önce hatalı bir karar üzerine saatlerce işlem yapacak zamanı vardır. VPS üzerinde bir kodlama aracısı çalıştırmanın pratik riski budur. Döngü mühendisliği yapan kişilerin tek tek istemlerden çok kalıcı talimatlara bu kadar dikkat etmesinin nedeni de budur. Her zaman etkin olan dosyadaki bir kural 200. tur için geçerlidir. Sohbette yazdığınız bir kural ise 3. tur için geçerlidir.

Yeni bağımlılıklar diğer sessiz maliyettir. Rung 5, kurulu olanları kullanmayı söyler. Bir aracının kendi inisiyatifiyle eklediği her paket, daha sonra yamalamanız gereken ve o depodan oluşturduğunuz her container image içine giren bir bileşendir.

Ponytail’ın kendi kıyaslama sonuçları ne gösteriyor

Proje iki sonuç kümesi yayımlar ve bu sonuçlar birbirinden büyük ölçüde farklıdır. Her ikisi de projenin kendi yayımladığı verilerdir. Hiçbiri bağımsız bir test değildir.

[
  {
    "label": "Lines of code",
    "single_shot_pct": 93,
    "agentic_pct": 54
  },
  {
    "label": "Cost per run",
    "single_shot_pct": 63,
    "agentic_pct": 20
  },
  {
    "label": "Wall clock time",
    "single_shot_pct": 74,
    "agentic_pct": 27
  }
]

Tek seferlik sütun, küçük bir istem kümesine kural kullanılarak ve kullanılmadan yanıt veren yalın bir modelden elde edilmiştir. Bu değerler, 13 ve 17 June 2026 tarihli yinelenen çalıştırmaların medyanlarıdır. Aracılı sütun ise gerçek bir FastAPI ve React deposu olan tiangolo'nun full-stack-fastapi-template deposunu, Haiku 4.5 üzerinde her biri dört çalıştırmadan oluşan on iki özellik biletiyle düzenleyen başsız bir Claude Code oturumundan elde edilmiştir. Değerlendirme, geride bırakılan git diff üzerinden yapılmıştır.

İkinci sütunu inceleyin. Aracılı sonuç, kod satırı sayısını 54 yüzde, maliyeti 20 yüzde ve geçen gerçek zamanı 27 yüzde azaltmaktadır. Tek seferlik kurulumda aynı ölçüler için bu oranlar sırasıyla 93 yüzde ve 74 yüzdedir. README bunun nedenini açıkça belirtir: tek seferlik temel, "birkaç seçenek ve ek açıklamayla yanıt veren" yalın bir modeldir ve bunu geçmek kolaydır. Gerçek iş yapan gerçek bir aracıyla karşılaştırıldığında kazanım azalır. Sonuç yine de geçerliliğini korur ve daha yararlı olan bilgi de budur.

Bir uyarı projenin kendisine aittir ve bunun size yardımcı olup olmayacağını belirleyen nokta budur. Tasarruf, gereğinden fazla geliştirme tuzağının gerçekten bulunduğu yerlerde en yüksektir. Zaten asgari düzeyde olan kodlarda ise tasarruf neredeyse sıfırdır. Tek bir Python ve TypeScript deposundaki on iki bilet, sizin deponuz için öngörü sağlamaz. Bu sayı sizin için önemliyse karşılaştırmayı kendi biletlerinizde, kural kullanılarak ve kullanılmadan çalıştırın. Satırları kendiniz sayın.

Bugün herhangi bir kurulum yapmadan kullanabileceğiniz kalıp

Bu merdiven metin biçimindedir; bu nedenle fikri kullanmak için eklenti gerekmez. AGENTS.md, CLAUDE.md veya düzenleyicinizin kural dosyası gibi aracınızın zaten okuduğu yönerge dosyasına aşağıdakine benzer bir blok yapıştırılabilir.

## Before you write code

Climb this list in order. Stop at the first line that applies.

1. Does this need to exist? If not, say so and stop.
2. Does this repo already have it? Reuse the helper.
3. Does the standard library do it? Use it.
4. Does the platform do it natively? Use it.
5. Does an installed dependency do it? Use it.
6. Can it be one line? Write one line.
7. Otherwise write the minimum that works.

Never take the shortcut on: reading the code before changing it, validating
input that crosses a trust boundary, error handling that would otherwise lose
data, security, accessibility, or anything I asked for by name.

Do not add an abstraction I did not ask for. Do not add a dependency without
saying why in one line. Prefer deleting code to adding it.

Mark a deliberate simplification with a comment naming its ceiling and the
upgrade path.

Son kuralı ayrıca ele almak gerekir. Ponytail kuralı, aracın adıyla etiketlenmiş bir yorum kullanır:

# ponytail: global lock, per-account locks if throughput matters

Bu yorum iki satırlık çalışmayla, aksi durumda bir inceleme döngüsüne mal olacak bir soruyu çözüme kavuşturur. Bir sonraki okuyucuya basit sürümün bilinçli bir karar olduğunu bildirir ve bu kararın hangi koşulda geçerliliğini yitireceğini belirtir. Bu yorum olmadığında incelemeyi yapan kişi, üzerinde düşünülmüş bir kısayolu aracın unuttuğu bir işlemden ayırt edemez. Bu nedenle soru sorması gerekir.

Bloğun nereye yerleştirildiği, ne söylediği kadar önemlidir. Aracın her çalıştırmada yüklediği bir dosya, izlemediğiniz çalıştırmalar dahil her çalıştırmayı yönlendirir. Bu fark, aracınızın gerçekten izlediği bir AGENTS.md dosyası yazma konusunun temelidir. Bu nedenle bu kalıp kabuk geçmişinde değil, sürüm denetimine alınmış bir dosyada bulunmalıdır.

Kuralın geçerliliğini yitirdiği durumlar

Bu basamaklar, yeniden kullanımın genellikle mümkün ve doğru olduğu, zaten var olan bir kod tabanındaki özellik geliştirme çalışmaları için ayarlanmıştır. Henüz yeni başlatılan bir projeye iyi uymaz; çünkü 2. basamakta yeniden kullanılacak bir şey yoktur ve 5. basamakta kurulmuş bir şey bulunmaz. Bu nedenle aracı her seferinde 7. basamağa düşer. Soyutlamaya gerçekten ihtiyaç duyduğunuz anda da iyi sonuç vermez. Aynı kopyalanmış bloğun dördüncü çağırıcısını eklemek üzereyseniz, "en kısa diff" size beşinci bir kopya sunar.

ultra seviyesi, gereksinimlerinizi sorgular. Bu seviyenin amacı budur. Ancak kararı zaten vermiş ve işin tamamlanmasını istiyorsanız, bu gerçek bir maliyettir. Olağan çalışmalar için full kullanın. Bir özellik isteğinin asıl sorun olduğundan şüpheleniyorsanız ultra seviyesine başvurun.

Hiçbir yönerge bloğu, sorunu yanlış anlamanızı engelleyemez. Kural kümesinin ilk maddesi de karar vermeden önce kodu anlamaktır. Bu, maliyetli olan ve metnin sizin yerinize yapamayacağı bölümdür. Yanlış işlevdeki minimal diff yine yanlış düzeltmedir. Üstelik artık onaylanması kolay, küçük bir yanlış düzeltmedir.

Dürüst özet şudur: Ponytail, dikkatle yazılmış ve iyi dağıtılmış, sayılarla desteklenen bir istemdir. İçindeki hiçbir şey eklentiyi zorunlu kılmaz. Projenin sunduğu şey, bir kişinin listeyi düzgün biçimde yazmış, gerçek bir repository üzerinde test etmiş ve yöntemi sonuçla birlikte yayımlamış olmasıdır.

FAQ

Ponytail, Claude Code dışındaki agent’larla çalışır mı?

Evet. Ponytail, skill yükleyen host’lar için bir skill olarak sunulur. Bu host’lar arasında Claude Code, Codex, OpenCode, Gemini ve README’de belirtilen diğerleri bulunur. Cursor, Windsurf, Cline ve Copilot gibi rule dosyalarını okuyup skill yüklemeyen editor’ler, eşleşen rules dizinindeki always-on ruleset’i kullanır ve slash command almaz. Metin her iki durumda da aynıdır. Asıl fark, host’un bu metni her turda bağlamda tutup tutmadığı veya yalnızca bir skill tetiklendiğinde mi yüklediğidir.

Tembel bir agent testleri, doğrulamayı veya güvenliği atlar mı?

Hayır. Ruleset bunu doğrudan belirtir. "never lazy about" listesinde trust boundary’lerde input validation, veri kaybını önleyen error handling, security ve accessibility yer alır. Ayrıca önemsiz olmayan her mantık parçası için çalıştırılabilir küçük bir check istenir. Kuralın kaldırdığı şey, talep edilmeyen yapının oluşturulmasıdır: kimsenin istemediği abstraction’lar ve kimsenin ihtiyaç duymadığı dependency’ler. Kurulumdan sonra agent testleri atlamaya başlarsa bunun nedeni kendi config’inizdeki başka bir instruction’ın bu kuralı geçersiz kılmasıdır. Bu nedenle agent’ın en son yüklediği dosyayı okuyun.

Yayınlanan hız ve maliyet rakamlarına güvenilebilir mi?

Bunlar projenin kendi ölçümleridir ve yöntemleriyle birlikte yayımlanmıştır. Bu nedenle bu kapsamda değerlendirilmelidir. Single shot rakamları, seçenekler ve açıklamalarla yanıt veren bare model ile karşılaştırma yapar. README, bunun zayıf bir baseline olduğunu kendisi belirtir. Agentic rakamlar, tek bir FastAPI ve React repository’sinde, Haiku 4.5 kullanılarak gerçekleştirilen headless Claude Code session’larından elde edilmiştir. Her biri 4 kez olmak üzere 12 ticket çalıştırılmıştır. Bu rakamlar söz konusu kurulum için geçerlidir. Kendi codebase’iniz için forecast değildir. Proje, zaten minimal olan code üzerinde tasarrufun near zero seviyesine düştüğünü de belirtir.

Avantajdan yararlanmak için bir şey kurmam gerekir mi?

Hayır. Ladder metinden oluşur. Agent’ın zaten okuduğu instruction dosyasına eşdeğer bir block yapıştırmak, etkinin büyük bölümünü sağlar. Plugin, bakımı yapılan wording’i, intensity level’ları, review command’ları ve update path’i sunar. Önce copied block’u denemek, kurulumun gerçekten gerekli olup olmadığı sorusuna verilen rung 1 yanıtıdır.

Unattended bir agent’ın gece boyunca gereğinden fazla yapı oluşturmasını nasıl önlerim?

Kuralı bir chat message yerine always-on instruction dosyasına ekleyin. Böylece kural yalnızca turn 3’te değil, uzun bir çalışmanın turn 200’ünde de uygulanır. Ardından hasarı ayrıca sınırlandırın: agent’a tek kopyanız yerine bozmasına izin verilen bir checkout verin ve herhangi bir şey merge edilmeden önce human diff review yapılmasını zorunlu tutun. Minimal diff kuralı, okumanız gereken içerik miktarını azaltır. Hangi değişikliklerin kabul edileceğine karar vermez ve vermemelidir.