27 Mart 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." 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.

Bu, projeniz için ne anlama geliyor

Çalışan bir kodlama ajanı 90 dakikada kurulabiliyorsa, bir ajansın altı haftalık teklifinin size aslında neyi faturalandırdığını sorun. Cevap genellikle koordinasyon yüküdür — toplantılar, devirler, yönetim katmanları. Önce-mimari yaklaşım ve ağır işi yapan yapay zeka ajanlarıyla biz saat değil sonuç fiyatlandırırız: 5.000 €–60.000 € arası kapsamı net sistemler, ilk sürüm 4–12 haftada yayında.

Fikirden teslim edilmiş sisteme giden adımlar sürecimizde belgeli; tipik olarak ne inşa ettiğimiz çözümler sayfamızda.