March 27, 2026 - 90 Dakikada Bir Kodlama Ajanı Kurmak: Mimarinin Oyunu Neden Kazandırdığı
Yazılım geliştirmede artık hız dar boğaz değil. Ama yapısız hız sadece başarısızlığa giden daha hızlı bir yoldur.
"Yazılım geliştirmede artık hız dar boğaz değil. Ama yapısız hız sadece başarısızlığa giden daha hızlı bir yoldur." Teorik bir alıştırma değil, yapay zeka destekli geliştirmenin gerçek dünya stres testi olarak ele aldığım bu çalışmada 90 dakika içinde Rust ile tamamen işlevsel bir kodlama ajanı inşa ettim. Ortaya çıkan sonuç, ajanlık tabanlı geliştirmeye bakışımı kökten değiştirdi.
İki Aşamalı Yöntem: İnşa Etmeden Önce Anla
Çalışmayı iki net aşamaya böldüm. 1. Aşama — Çıkarım: Tek bir satır kod kopyalamadan açık kaynaklı bir ajanın (OpenCode) mimari mantığını inceledim ve anladım. Hedef kodun kendisi değil, arkasındaki prensiplerdi. 2. Aşama — Temiz Sayfa: Yalnızca çıkarılan spesifikasyonlara dayanarak sıfırdan yeniden inşa ettim. Miras alınan teknik borç yok, uzlaşı yok. Bu ayrım kritiktir: önce anlayıp sonra inşa edenler temiz mimariyi zorunlu kılar.
Canlı Stres Testi: Dakikalar İçinde Eksiksiz Bir Landing Page
Ajanı test etmek için "Quickcode" adlı bir proje için eksiksiz bir landing page oluşturmasını istedim. Sonuç: karanlık mod arayüzü, değer önerileri, özellik kartları, pazarlama metni — hepsi manuel düzenleme olmadan. Bu bir tesadüf değildi. LLM'nin kodu tutarlı biçimde genişletmesine olanak tanıyan, temiz tanımlanmış mimarinin doğrudan sonucuydu.
Token Ekonomisi: Bağlam Neden Yazma Hızından Daha Önemli
En önemli içgörülerden biri: bağlam verimliliği yazma hızını geçer. İyi yapılandırılmış, tutarlı spesifikasyonlar halüsinasyonları ve düzeltme döngülerini en aza indirir. Bir LLM'e gönderilen her token sinyal olmalı, gürültü değil. Bu şu anlama geliyor: kesin mimari belgeler, net arayüz tanımları, tutarlı adlandırma kuralları. Bu disiplini getirenler daha düşük token tüketimiyle daha yüksek kaliteli çıktı elde eder.
Önce Mimari — Ve İnsan Uzmanlığının Neden Vazgeçilmez Kaldığı
Temel prensip: temiz yapısal temeller LLM'lerin kodu tutarlı biçimde genişletmesini sağlar. Zayıf başlangıç tasarımı entropinin üstel ölçekte büyümesine yol açar. Teknik uzmanlık, işlevsel kodu sürdürülebilir sistemlerden ayıran şeydir. Ajanlık tabanlı geliştirme deneyimli mühendisler için temel bir beceri haline geliyor. Mimari hakimiyeti bir çarpan olarak işlev görür — özellikle yoğun, zaman kısıtlı senaryolarda. Sonuç: araçlar güçlenmeye devam ediyor. Ama oyunu hâlâ mimari kazanıyor.