AI ajanları için feedback

Sıradan bir feedback, bir insan için bir ticket üretir. Ajana hazır feedback (agent-ready feedback) ise yapay zekânın doğrudan işleyebileceği context üretir: öğenin selector'ı, bir ekran görüntüsü ve artefaktın hedefiyle kısıtları; sadece serbest metin bir açıklama değil.

Tek başına bir ekran görüntüsü ve "şunu düzelt" ajanı hedefi ve niyeti tahmin etmeye zorlar; her tahmin bir yeniden üretim demektir. Yapılandırılmış feedback bu tahmini ortadan kaldırır: ajan, belirtilen hedefi karşılamak için doğru öğeyi düzenler.

artifact-review modunda Patchrooms her yoruma; selector ve ekran görüntüsünün yanında hedefi, kısıtları ve aracı iliştirir. Yapılandırma işi bir kez, tıklama anında olur; birileri bug'ı bir ajana her verdiğinde tekrar tekrar değil.

• Tıklanan öğenin DOM selector'ı.
• Ekran görüntüsü, URL, viewport, tarayıcı ve varsa konsol hataları.
• Yazılı yorum ya da otomatik yazıya dökülen sesli not.
• Rapor başına durum: yeni, triyaj, devam ediyor, kapandı.

Kimsenin bir şey yapıştırmadan dönen loop'lar için, feedback için bir MCP sunucusu list_reports ve get_report'u (inline ekran görüntüleriyle) sunar; böylece ajan kuyruğu doğrudan okur, set_status ile düzelttiğini kapatır. Okuma ve kapatma bugün çalışıyor; Slack, Linear ya da Jira için native connector'lar henüz yok.

Secret key (pr_sk_...) ajanı MCP'ye karşı doğrular ve asla frontend'de görünmez. MCP dokümantasyonu İngilizce olarak docs.patchrooms.com adresinde.

Context'i kendin yapıştırmayı mı tercih edersin? Her rapor, okuyup Claude Code, Cursor, Codex, Windsurf veya Cline'a yapıştırdığın bir Markdown olarak dışa aktarılır. Ajanın okuduğu metnin kendisi İngilizce olur (model onu tüketir). Bir dışa aktarım şöyle görünür:

## Report: Checkout review
**Tool:** claude-code   **Goal:** reduce checkout friction
**Constraint:** keep the layout single-column

- **Element:** `input#coupon-code`
- **Comment:** Remove the coupon field; almost no one uses it.
- **Screenshot:** blob/scr_5da7.png
- **URL:** https://preview.example.com/checkout

AI artefakt incelemesi (AI artifact review) şu loop'tur: üret, yerinde incele ve düzelt. Her yorum bir durumla birlikte bir dashboard'a düşer; böylece ekip chat geçmişini yeniden okumak yerine neyin çözüldüğünü ve neyin hâlâ açık olduğunu görür.

Bu, code review başlamadan önceki checkpoint'tir: diff'e değil, ajanın gerçekten render ettiği şeye bakan biri. Daha fazlası: agent-ready feedback ve workflows.