Feedback per agenti IA

Un feedback normale produce un ticket per un umano. Il feedback pronto per gli agenti (agent-ready feedback) produce contesto che l'IA può azionare direttamente: il selettore dell'elemento, uno screenshot, più l'obiettivo e i vincoli dell'artefatto, non solo una descrizione a testo libero.

Uno screenshot isolato con un "sistema questo" costringe l'agente a indovinare obiettivo e intenzione, e ogni tentativo costa una rigenerazione. Il feedback strutturato elimina l'indovinello: l'agente modifica l'elemento giusto per rispettare l'obiettivo indicato.

In modalità artifact-review, Patchrooms allega a ogni commento l'obiettivo, i vincoli e lo strumento, insieme al selettore e allo screenshot. Il lavoro di strutturare avviene una volta, nel momento del clic, non ogni volta che qualcuno passa il bug a un agente.

• Selettore del DOM dell'elemento su cui hai cliccato.
• Screenshot, URL, viewport, browser ed eventuali errori di console.
• Commento scritto o nota vocale trascritta in automatico.
• Stato per report: nuovo, in triage, in corso, chiuso.

Per i loop che girano senza un umano che incolla nulla, un server MCP per il feedback espone list_reports e get_report (con screenshot inline) perché l'agente legga la coda direttamente, e set_status per chiudere ciò che sistema. Lettura e chiusura funzionano oggi; connettori nativi per Slack, Linear o Jira non ancora.

La secret key (pr_sk_...) autentica l'agente contro l'MCP e non si espone mai nel frontend. La documentazione dell'MCP è in inglese su docs.patchrooms.com.

Preferisci incollare il contesto tu stesso? Ogni report si esporta come Markdown che leggi e incolli in Claude Code, Cursor, Codex, Windsurf o Cline. Il testo che legge l'agente resta in inglese (è ciò che il modello consuma). Ecco come si presenta un export:

## 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

La revisione di artefatti IA (AI artifact review) è il loop: generare, revisionare sul posto e sistemare. Ogni commento atterra in una dashboard con uno stato, così il team vede cosa è risolto e cosa resta aperto invece di rileggere la cronologia della chat.

È il checkpoint prima che inizi la code review: qualcuno che guarda ciò che l'agente ha davvero renderizzato, non il diff. Approfondisci nel agent-ready feedback e nei workflow.