Handoff'u Kaldırdık: Bir ekranın production'a yolculuğu 14–21 günden 3 güne nasıl indi?
Prototype to Code serisi · Bölüm 1
PeopleBox Onyx'te bir ekranın tasarımdan production'a geçmesi eskiden 14 ila 21 gün sürüyordu. Bugün bu süre 3 gün.
Aradaki fark daha hızlı çizen tasarımcılar ya da daha hızlı yazan geliştiriciler değil. Arada bir adımı tamamen kaldırdık: çeviri.
Eski yol: her geçişte bilgi kaybı
Klasik akışı hepimiz biliyoruz. Tasarımcı Figma'da ekranı çizer, ölçüleri ve davranışları bir handoff dokümanına döker. Geliştirici bu çizimi alır ve sıfırdan koda çevirir. İlk review'da farklar ortaya çıkar: boşluk farklıdır, hover durumu unutulmuştur, boş ekran hiç düşünülmemiştir. Tasarımcı not düşer, geliştirici düzeltir, bir tur daha döner.
Bu döngünün asıl maliyeti iş gücü değil. Aynı ekranı iki kez üretiyoruz: bir kez resim olarak, bir kez kod olarak. İkisinin birbirine benzemesi için de haftalarca uğraşıyoruz.
Yeni fikir: tasarımcı çizim değil, çalışan kod teslim etsin
Sorduğumuz soru şuydu: tasarımcının ürettiği şey doğrudan geliştiricinin kullanacağı kod olsaydı ne olurdu?
Bunun için tasarımcıya bir repo teslim ettik. İçinde geliştiricinin kullandığı component kütüphanesinin aynısı var. Tasarımcı Claude Code ile çalışıyor: Figma linkini ya da ekran görüntüsünü veriyor, ne istediğini anlatıyor ve çalışan bir ekran ortaya çıkıyor. Bu ekran tıklanıyor, veri tutuyor, sayfa yenilense de kaybolmuyor.
«Ama tasarımcı kod yazmayı bilmiyor ki» itirazı haklı. Zaten kodu yazan tasarımcı değil. Tasarımcının işi karar vermek, bakmak ve onaylamak. Kodu AI yazıyor. AI'ın neyi nasıl yazacağını da repoya yazılmış kurallar belirliyor.
Neden işe yaradı: üç parça
- Ortak dil. Tasarımcı ile geliştirici aynı component'leri kullanıyor. Bir buton, bir modal, bir tablo iki tarafta da aynı şey.
- Yazılı kurallar. Renklerin hangi token'dan geleceği, ikonun hangi kütüphaneden seçileceği, hangi klasöre dokunulamayacağı gibi kurallar bir insanın hafızasında değil, repoda duruyor. AI her işte onları okuyor.
- Otomatik denetim ve insan onayı. Tasarımcının açtığı her PR, kurallara göre otomatik denetleniyor. Merge kararını ise her zaman bir insan veriyor.
Altı ayın özeti
Nisan 2026'dan bu yana bu repoda 152 commit, 46 merge edilmiş PR ve 40 tasarım branch'i birikti. Bunların büyük kısmı, tasarımcının kendi açtığı ve geliştiricinin yeniden yazmadan devraldığı işler.
Seride neler var
- Bölüm 2: Tasarımcıya teslim ettiğimiz repo
- Bölüm 3: Kuralları AI'a öğretmek
- Bölüm 4: Tasarımcının bir günü: 4 skill, tek zincir
- Bölüm 5: Geliştiriciye teslim ve güven
- Bölüm 6: Kazandıklarımız ve tuzaklar
Bir sonraki bölümde işin temeline iniyoruz: tasarımcıya teslim ettiğimiz repo neye benziyor ve neden bazı klasörlere kilit vurduk?
Musa Turan, PeopleBox'ta AI Software Engineer olarak LLM ve AI sistemleri üzerinde çalışıyor. «Prototype to Code» serisinde, PeopleBox Onyx'te tasarımcının çalışan kod teslim ettiği akışı anlatıyor.