Yapay Zeka Kodlama Yardımcısı Neden Projenizi Unutuyor? (ve Bunu Nasıl Düzeltebilirsiniz)

Hepimiz yaşadık bunu. Çok günlük bir proje üzerinde yapay zeka kodlama asistanı ile çalışıyorsunuz. Birinci gün harika geçiyor—API'yi tasarlıyor, düzgün testler yazıyor, her şeyi dokümante ediyor. İkinci gün? Yeni bir sohbet oturumu, kafası karışık bir asistan ve siz tüm proje yapısını tekrar açıklayıp duruyorsunuz. Üçüncü dördüncü günlere gelince, iki oturum önce ne kararlaştırıldığını çıkarmaya çalışmak için 70.000 token'lik chat transkriptlerini okuyorsunuz.

Problem bir bağlam penceresi sorunu gibi hissettirse de, aslında daha temel bir şey: proje durumunu yanlış yerde saklıyoruz.

Chat Tabanlı Belleğin Gizli Maliyeti

Sohbet konuşmaları insanlar ve yapay zeka arasında işbirliği yapmak için muhteşemdir. Proje veritabanı olarak kullanmak için ise korkunçtur.

Yapay zeka araçlarını kullanan geliştirici olanlar için neden önemli olduğunu açıklamak gerekirse:

• Sohbet tek yazma, çok okuma sistemdir. Bir karar ekranın ötesine kayıp gittikten sonra onu bulmak binlerce token'i taramanızı gerektirir.
• Tek bir gerçek kaynağı yoktur. API spesifikasyonu oturum üçte mi beşte mi değişti? Gerçekten inşa ettiğiniz versiyon hangisi?
• Yeni asistanlar bağlama sahip değildir. Yeni bir sohbet oturumu, ne kadar tarihi olursa olsun sıfırdan başlamak demektir.
• Durum sapması birikir. Bir asistan test stratejisine karar verir. Diğeri uygulamayı değiştirir. Üçüncüsü docsları "tamamlandı" olarak işaretler oysa yarım kalmıştır. Hiç kimse bu çelişkileri takip etmez.

Yapay zekayla desteklenen geliştirmenin asıl darboğazı asistanın kod yazıp yazamayacağı değildir—modern LLM'ler gerçekten bunda iyidir. Darboğaz asistanın ne inşa ettiğinizi ve neden anlaması olup olmayacağıdır.

Gerçekten İşe Yarayan Sıkıcı Çözüm

Ya proje durumunu kodu sakladığımız gibi saklasaydık: depo içinde versiyon kontrollü dosyalar olarak?

Bir wiki olarak değil. Ayrı bir proje yönetim aracı olarak da değil. Sadece hafif metadata blokları içeren temiz, yapılandırılmış Markdown dosyaları.

Şöyle düşünebilirsiniz:

# Proje Mimarisi Kararı

Durum: aktif
Tip: spesifikasyon
Proje: ödeme-servisi
Güncelleme: 2024-01-15

İlişkili:
- uygular: charter-ödeme-api
- eşleşir: uygulama-kaydı-ödeme-çekirdeği

## Özet

Stripe'ın doğrudan API'sini kullanıyoruz çünkü wrapper kütüphanesi yerine...

## Kilit Kararlar

- Tüm işlemler için idempotency anahtarları
- Üstel geri alma ile asenkron webhook işlemesi
- KVD asla yerel depolama ile temas etmez

## Açık Sorular

- Oran limiti durumunu cache'lemeli miyiz?

Bu kasıtlı olarak sade tutulmuştur. Özel sözdizimi yok. Veritabanı yok. İşi karıştıracak şey yok. Sadece:

• Bir başlık
• Durum hakkında metadata (aktif, tamamlandı, arşivlendi)
• Rol (spesifikasyon, log, karar, rehber)
• Diğer kayıtlarla ilişkiler
• Asıl içerik

Sihir formatta değildir—bunlarla yapabileceğiniz şeylerde saklıdır. Bir CLI aracı şunları yapabilir:

• Oluştur tutarlı yapıya sahip yeni kayıtlar
• Arşivle tamamlanmış olanları silmeden
• Taşı kayıtları ve tüm ilişkileri otomatik güncelle
• Listele proje genelinde filtrelerle herşeyi
• Doğrula ilişkilerin gerçek kayıtlara işaret ettiğini
• Oluştur otomatik olarak dizin—manuel güncelleme yok

Bunu AI İş Akışları İçin Neden Değiştirici Kılıyor

Buradaki kritik kayma şudur: yeni bir asistandan "sohbeti gözden geçir ve ne yaptığımızı anla" demek yerine, ona bir CLI komutu verirsiniz.

docs listele --proje=ödeme-servisi --tip=spesifikasyon
docs listele --durum=aktif
docs kontrol  # tüm ilişkileri doğrula

Asistan sohbet tarihçesinden kazı yapmak yerine proje durumunu sorgulay biliyor. Görebiliyor:

• Neye karar verildi
• Şu anda ne yapılıyor
• Neye takılı kalındığını veya beklendiğini
• Hangi dokümantasyonun yetkili olduğunu versus tarihi olduğunu

Daha önemlisi: asistan doğrudan dosya düzenlemek yerine yapılandırılmış komutlarla durumu değiştirebiliyor.

Asistanın metadata'yı düzgün düzenlemesini umduğunuz yerde, ona fiilleri verirsiniz:

docs oluştur --tip=log "Oran sınırlaması uygulandı"
docs arşivle --kayıt=spec-v2-deprecated
docs tazele --kayıt=spec-ödeme-api  # zaman damgasını güncelle

Bu komutlar değişmez değerleri kodlar. Durum, dosya konumu, ilişkiler ve oluşturulan dizin hep beraber hareket eder. Asistan sistemi yanlışlıkla bozamaz çünkü araç bunu izin vermez.

Ortaya Çıkan Desen: Yeni Asistan, Bilinen Durum

İşte ilginç hale geldiği nokta: "yeni asistan deseni."

Normalde, kodlama asistanı ile yeni bir oturuma başlamak bağlam kaybı demektir. Yapılandırılmış durumla, şu demektir:

1. Asistan yeni bir sohbet oturumuna uyanıyor
2. İlk işi: ne'nin aktif olduğunu anlamak için docs listeleyi çalıştır
3. Üç tamamlanmış dönüm noktası ve devam eden birini görür
4. Dün nelerin denendi olduğunu anlamak için uygulama kaydını okur
5. Ne inşa etmesi gerektiğini görmek için spesifikasyonu kontrol eder

Sohbet arkeolojisi yok. Dağınık mesajlardan kararları yeniden inşa etme yok. Sadece: işte olan şey, işte yapılması gereken sonraki şey.

Eski sohbet? Artık atılabilir. Kapatabileceğiniz bir şey. Durum depoda, ait olduğu yerde yaşıyor.

Buna Gerçekten Ne Zaman İhtiyaç Duyarsınız

Muhtemelen bunu önemsiyorsunuz eğer:

• Yapay zeka eşleştirilmiş programlama araçlarıyla inşa ediyor ve oturumlar birden fazla gün uzanıyor
• Yapay zeka asistan iş akışlarını yönetiyor ve tam bağlam transferi olmadan devam etmesi gerekiyor
• CI/CD ardışık düzenlerini çalıştırıyor ve proje tutarlılığını doğrulaması gerekiyor
• Takımlarla çalışıyor ve neye karar verildiğine karşı ne'nin hala açık olduğuna dair ortak bir anlayış gerekiyor
• Hızlı yinelemeler yapıyor ve mevcut spesifikasyonun ne olduğunu takip kaybediyor

Bu desen Git, testleri veya kod incelemesini değiştirmez. Bu, yapay zekayla desteklenen geliştirmeyi zamanla gerçekten tutarlı kılan tutkallama katmanıdır.

Acı Gerçek

Bu yaklaşımın en iyi tarafı ne kadar sıkıcı oluşudur. Yeni bir veritabanı paradigması icat etmiyorsunuz. Özel bir IDE inşa etmiyorsunuz. Geliştiricierin zaten bildikleri araçlardan (Markdown, Git, CLI) yararlanıyor ve bunları gerçekten iyi oldukları şeyler için kullanıyorsunuz.

Kenarboşluğundaki durumlar kavramı kanıtlamaktadır. Asistan yanlışlıkla bir ilişkiyi bozar mı? Doğrulama bunu yakalar. Arşivlenmiş bir kaydı kaçırır mı? Listele komutu gösterir. Durum iki oturum çatışınca kayar mı? Dizin sözleşmedir—ya geçerlidir ya da değildir.

Bu, geriye dönüş bakımından açık görünen türden altyapıdır. Fakat bu "asistan az çok çalıştı" ile "asistan projeyi anladı ve sevk etti" arasındaki farkın ne olduğudur.