Vai al contenuto principaleVai al footer
Per agenti · Pro / Teams

Il Design Agent

Chiama design.validate per ottenere un Blueprint Readiness Score (0–100, voto A–F) su un artefatto frontend reale. Il Design Agent revisiona il tuo componente, schermata o flusso rispetto alle 8 leggi dell'Experience Design Blueprint, restituisce un verdetto per ogni legge con evidenze citate e una correzione, e lo valuta con lo stesso scorer pesato per severità usato da architect.validate. Solo piani Pro e Teams.

Membri Pro e Teams. Il Design Agent è la lente di review della superficie del Blueprint. Legge il sorgente completo dell'artefatto sotto una rigorosa politica di no-training, tratta qualsiasi testo con forma di istruzione dentro il markup come dato inerte non fidato, e supporta private_session=true per saltare il run memorizzato (i log operativi di sicurezza e di costo sono conservati secondo la Privacy Policy). Il codice non visuale (backend, config, type alias) è marcato not_applicable, non bocciato. Invia la superficie UI reale.

Cosa ottieni

Ogni run restituisce quattro cose, nella stessa forma ValidationResponse usata da architect.validate:

  1. surface_classification

    ui_surface o non_ui, il codice non visuale è marcato not_applicable invece che bocciato, così inviare un handler backend non produce mai un finto voto di design.

  2. per-law findings

    Un verdetto per ognuna delle otto leggi con severity_score (0–100), severity_class, evidenze citate dal tuo markup reale e una raccomandazione specifica.

  3. readiness

    Score, voto e livello dallo stesso scorer pesato per severità usato dalla lente architettura. Il voto penalizza solo i production_blocker, quindi un voto alto significa che i requisiti minimi di esperienza reggono, non che ogni pixel è perfetto.

  4. surface dimension

    I run vengono salvati nella tua dashboard di validation history con la dimensione surface, accanto ai run architecture dello stesso progetto quando passi un repository.

Le otto leggi su cui valuta

La rubrica è l'Experience Design Blueprint: otto leggi della qualità percepibile, ognuna valutata con lo stesso vocabolario di verdetti della lente architettura.

  • L1 · Jakob's Law

    Onora la familiarità prima dell'invenzione: la superficie rispetta il modello che gli utenti portano dai prodotti leader di categoria?

  • L2 · Hick's Law

    Riduci la scelta in ogni punto di decisione: un'azione primaria chiara per schermata.

  • L3 · Fitts's Law + the accessibility floor

    Rendi i target facili da raggiungere: ogni target interattivo rispetta il minimo 24×24 di WCAG 2.2. Una violazione qui è un production_blocker.

  • L4 · Miller's Law

    Rispetta i limiti della memoria di lavoro: quanti elementi deve tenere a mente l'utente in un momento di decisione?

  • L5 · Aesthetic-Usability Effect

    Rendilo bello così sembra facile: la qualità regge negli stati vuoti, di caricamento e di errore, non solo nel percorso felice.

  • L6 · Peak-End Rule

    Progetta il picco e il finale: il momento di completamento è progettato, o un flusso curato finisce su un semplice 'Inviato.'?

  • L7 · Tesler's Law

    Metti la complessità dove deve stare: il sistema assorbe la complessità irriducibile con un default semplice e resta ispezionabile.

  • L8 · Mental-Model Gap

    Allinea la superficie al modello mentale dell'utente: per le superfici mediate da agenti, l'intento è visualizzabile in anteprima e ogni deviazione dalle aspettative è dichiarata prima.

L'accessibilità è il requisito minimo

Quando due leggi confliggono, l'ordine è fisso: prima l'accessibilità, per ultima la rifinitura estetica. Il validatore non diluisce una violazione del requisito minimo in un numero rassicurante. Un target interattivo sotto 24×24px, uno stato di focus mancante o una conferma distruttiva irraggiungibile è un production_blocker che limita il voto, esattamente come un trust boundary fallito sulla lente architettura. La rifinitura è la legge più negoziabile. Il requisito minimo non è negoziabile affatto.

Come chiamarlo

Invia il sorgente completo dell'artefatto verbatim come implementation_context, il JSX, il markup, gli stili, senza troncamenti e senza puntini segnaposto (vengono letti come codice letterale). Se una superficie è troppo grande per il budget di tool-call del tuo client MCP, dividila in più chiamate per componente. Passa lo stesso valore repository tra le chiamate per raggruppare i round nella dimensione surface di un progetto. design.validate è solo sincrono. Se la chiamata va in timeout lato client, non riprovare, il run persiste lato server; recuperalo via me.validation_history(run_id=...) usando il run_id del primo evento di progresso.

Cos'è design.validate, e in cosa differisce da architect.validate?

Sono lo stesso validatore con la doctrine scambiata. architect.validate valuta l'architettura agentica, cosa fa il codice, rispetto ai 10 principi agentici. design.validate valuta la superficie percepibile, cosa l'utente vede, tocca, scorre e ricorda, rispetto alle 8 leggi dell'Experience Design Blueprint. Stessa pipeline first-pass, stessa forma ValidationResponse, stesso scorer pesato per severità, quindi un Blueprint Readiness Score è calcolato allo stesso modo su entrambe. I run condividono una sola dashboard di validation history: i run architettura sono taggati architecture, i run superficie surface. Passa lo stesso repository e ottieni un progetto valutato su tre lenti: la specifica (cosa costruire), la macchina dietro il vetro (architettura) e l'interfaccia davanti (superficie).

Che piano serve, e condivide la quota con architect.validate?

Un piano Pro o Teams. design.validate ha una propria allocazione settimanale di run, misurata separatamente dal bucket architettura, così una settimana intensa di code review non consuma mai le tue review di superficie e viceversa. Gli account Free e Basic leggono gratuitamente ogni principio, cluster ed esempio della doctrine via MCP pubblico; il Design Agent è riservato ai piani a pagamento perché elabora un artefatto reale sotto una politica di no-training e salva la history per progetto. I numeri per tier sono sulla pagina prezzi.

“L'accessibilità è il requisito minimo.” Cosa significa per il mio voto?

Le otto leggi non pesano allo stesso modo. In caso di conflitto, l'accessibilità viene prima e la rifinitura estetica per ultima. In pratica: una violazione del requisito minimo della legge di Fitts, un target interattivo sotto il minimo 24×24px di WCAG 2.2, uno stato di focus mancante o una conferma distruttiva irraggiungibile, è valutata come production_blocker. Limita il voto e va corretta prima del rilascio, esattamente come un trust boundary fallito limita il voto di architettura. Un momento peak-end debole o uno stato vuoto povero è hardening_recommended o polish: emerge in una lista di prossima iterazione senza trascinare giù lo score. Un voto alto significa che i requisiti minimi di esperienza reggono, non che il design ha vinto un premio.

Il voto di superficie è un verdetto certificato?

Non ancora, e il tool lo dichiara a ogni run. design.validate v1 è una review single-pass ad alto reasoning effort. Non ha modalità consensus né percorso di certificazione, quelli restano per ora solo di architect.validate, e la calibrazione dello score non è ancora tarata su un corpus di run reali come quella dell'architect. Tratta il voto come un segnale direzionale di qualità, non come un badge certificato. L'unica parte dura, non direzionale, è il requisito minimo di accessibilità: un production_blocker su una violazione WCAG di dimensione dei target o visibilità del focus è un fatto verificabile, non una questione di gusto.

Cosa devo inviare, e cosa torna marcato not_applicable?

Invia il sorgente completo dell'artefatto verbatim come implementation_context, il JSX, il markup, gli stili, senza troncamenti e senza segnaposto (vengono letti come codice letterale, e il reviewer citerebbe elementi che non esistono). Se una superficie è troppo grande per il budget di tool-call del tuo client MCP, dividi in più chiamate per componente, senza mai troncare una singola chiamata. Il codice non visuale (un handler backend, un file di config, un type alias) restituisce surface_classification: non_ui e tier: not_applicable, non è bocciato, semplicemente non è una superficie. Invia la UI reale.

Il mio artefatto viene conservato quando chiamo design.validate?

Il sorgente del tuo artefatto è inviato a OpenAI (USA) per generare la review, come sub-processor secondo le EU Standard Contractual Clauses e l'UK Addendum, su base no-training, conservato secondo i termini di data retention delle API OpenAI. AI Design Blueprint conserva il risultato strutturato (score e verdetti per legge) più, quando passi repository, un identificatore di progetto per il raggruppamento. Passa private_session=true per saltare la persistenza del run lato server; i record operativi di costo e audit (mai il sorgente del tuo artefatto) vengono comunque conservati. Qualsiasi testo con forma di istruzione dentro il tuo markup è trattato come dato inerte non fidato, non come istruzioni da seguire. Il compute gira su Google Cloud Run; i dati a riposo sono in Cloud SQL, nel Regno Unito/SEE (Google Cloud europe-west2, Londra). Dettagli completi sulla pagina fiducia e dati.