İterasyon döngüsü

PinAppAI’ın omurgası basit bir döngü: reviewer’lar değişiklik ister, AI ajanın uygular, reviewer’lar sonucu doğrular. Dashboard tam üç sekmedir (Inbox, InReview, Closed) ve her değişiklik talebi (CR) her an bunlardan tam birindedir.

Döngü

reviewer'lar canlı sitede pin bırakır
   │
   ▼
Inbox            ← her yeni CR buraya düşer (#N numarası atanır)
   │
   │  apply workflow: AI ajanın kaynağı düzenler,
   │  /changes/ sayfasını yeniler, turu kaydeder
   ▼
InReview         ← uygulandı, karar bekliyor
   │
   ├── Approve          → Closed (tamam)
   ├── Reject           → Inbox'a döner (sonraki Apply düzenlemeyi geri alır)
   └── Request change   → Inbox'a döner (sonraki Apply yeni metni uygular)

Modelin tamamı bu. Ayrı bir triyaj töreni yoktur: Inbox’taki her şey Apply’a hazırdır ve tek bir apply çalıştırması Inbox’ı boşaltır.

Inbox

Yeni pinler, proje bazında kısa bir numara taşıyan CR’lar olarak gelir (#41, #42): sayfadaki pin işaretinin içinde, /changes/ kartında, commit mesajlarında ve dashboard satırında göreceğin numara aynıdır. Her yerde tek kimlik.

Inbox satırları neden orada olduklarını söyleyen bir rozet taşır: 🆕 yeni, ↩ reddedildi (geri alma gerekli), 🔄 değişiklik istendi (yeni metin gerekli), ⏸ ertelendi. Defer, henüz el atmak istemediğin bir CR’ı park eder. Sen geri alana kadar Apply onu atlar.

Apply

Apply butonu (ya da apply workflow’unu doğrudan Claude Code, Codex, Cursor veya MCP bilen herhangi bir ajanda çalıştırmak, bkz. Workflow nasıl çalıştırılır) ertelenmemiş tüm Inbox CR’larını AI ajanına teslim eder. Ajan:

1. Kaynak dosyalarını düzenler: yeni uygulamalar, reddedilenler için geri almalar, değişiklik istenenler için yeni metinler. Emin olmadığı her şeyi sorar ve sen açıkça onaylamadan hiçbir şey commit edilmez.
2. /changes/ inceleme sayfasını eşleşecek şekilde yeniler.
3. Turu PinAppAI’a kaydeder; uygulanan her CR InReview’a geçer.

Her Apply çalıştırması bir iterasyon olarak kayda geçer: projenin uygulama geçmişi, CR bazında görünür (“From iter #3”).

InReview

Uygulanmış CR’lar burada karar bekler. Reviewer’lar canlı sayfadan (yeşil pin / inceleme paneli) ya da /changes/ üzerinden karar verir; admin de bu sekmeden karar verebilir. İlk hamle kazanır: kararı önce veren sahiplenir.

Sahiplenmek karara mahkum olmak demek değil. O reviewer, change request yeniden uygulanana kadar kendi kararını değiştirebilir; yanlışlıkla basılan bir Reject iki saniyelik bir düzeltmeye dönüşür, admin’e iş düşmez. Başka bir reviewer kararın üzerine yazamaz ama onun kararı da çöpe gitmez: change request’in geçmişine işlenir, yani fikir ayrılığı kaybolmak yerine görünür kalır.

• Approve CR’ı kapatır.
• Reject ya da Request change CR’ı uygun rozetle Inbox’a geri gönderir; sonraki Apply geri almayı ya da yeni metni halleder. Aynı CR, aynı #N. Hiçbir şey çatallanmaz.

Closed

Uçtaki CR’lar: ✓ tamam ya da ✗ wontfix. İş bitmemiş çıkarsa Reopen onu Inbox’a geri gönderir.

AI nerede devreye girer

Dashboard’un yaptığı her şey MCP sunucusu üzerinden AI ajanına da açıktır: apply döngünün motorudur; yol arkadaşı workflow’lar kurulumu, /changes/ üretimini, analizi ve proje sıfırlamayı kapsar.