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

Il PM Agent

Chiama spec.validate per ottenere un Blueprint Readiness Score (0–100, voto A–F) su una specifica scritta prima che qualcuno ci costruisca sopra. Il PM Agent revisiona la tua proposta, il documento di requisiti o un change bundle in stile OpenSpec rispetto alle 8 leggi dello Spec Quality Blueprint, restituisce un verdetto per ogni legge con evidenze citate e una correzione, e lo valuta con lo stesso scorer pesato per severità usato dalle altre due lenti. Solo piani Pro e Teams.

Membri Pro e Teams. Il PM Agent è la lente di review del cosa-costruire del Blueprint, il posto PM del trio di validator, applicata prima che il codice esista: architect.validate valuta l'architettura agentica costruita, design.validate valuta la superficie renderizzata, spec.validate valuta l'intento scritto da cui il team costruirà. Legge il testo completo della specifica sotto una rigorosa politica di no-training, tratta qualsiasi testo con forma di istruzione dentro il documento 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). Codice sorgente e artefatti UI sono marcati not_applicable, non bocciati. Invia la specifica reale.

Cosa ottieni

Ogni run restituisce quattro cose, nella stessa forma ValidationResponse usata dalle altre due lenti:

  1. spec_classification

    spec_document o non_spec, codice sorgente e artefatti UI sono marcati not_applicable invece che bocciati, così inviare un file di codice non produce mai un finto voto di specifica; la risposta ti indirizza invece ad architect.validate o design.validate.

  2. per-law findings

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

  3. readiness

    Score, voto e livello dallo stesso scorer pesato per severità usato dalle lenti architettura e superficie, così tutte e tre valutano su una sola rubrica. Il voto penalizza solo i production_blocker: un voto alto significa che i requisiti minimi della specifica reggono, non che il documento è esaustivo.

  4. spec dimension

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

Le otto leggi su cui valuta

La rubrica è lo Spec Quality Blueprint: otto leggi dell'intento costruibile, ognuna valutata con lo stesso vocabolario di verdetti delle altre lenti.

  • S1 · State the right problem as an outcome

    Nomina chi è bloccato e il cambiamento osservabile che dimostra il problema risolto, prima di nominare qualsiasi meccanismo.

  • S2 · Scope one bounded change

    Un solo cambiamento coerente con un confine nominato e una lista esplicita di ciò che è fuori scope.

  • S3 · Make every requirement testably acceptable

    Ogni requisito porta un segnale di accettazione osservabile che qualcuno può verificare. Un requisito portante senza segnale è un production_blocker.

  • S4 · Record the decision trail

    Le alternative considerate, perché hanno perso, e le domande aperte con un owner: il ragionamento sopravvive all'autore.

  • S5 · Complete the handoff

    Ogni giunzione toccata dal lavoro ha il suo contratto nominato: forme degli eventi, stati, identificatori. Se l'engineer o il designer deve chiedere, la specifica non è finita.

  • S6 · Cite the doctrine upfront

    I principi e i vincoli che il lavoro deve rispettare sono nominati nella specifica, non scoperti in review.

  • S7 · Keep decomposition traceable

    I task risalgono ai requisiti, così non viene rilasciato nulla che nessun requisito abbia chiesto.

  • S8 · Name risk and reversibility

    I passi che cambiano stato o sono visibili all'utente nominano il percorso di rollback e il gate umano. Un passo irreversibile senza gate nominato è un production_blocker.

La testabilità è il requisito minimo

Quando due leggi confliggono, l'ordine è fisso: l'accettazione testabile batte la completezza, la disciplina di scope batte l'ambizione, e la completezza dell'handoff batte la comodità dell'autore. Il validatore non diluisce una violazione del requisito minimo in un numero rassicurante. Un requisito portante senza segnale di accettazione osservabile, o un passo irreversibile senza gate umano nominato, è un production_blocker che limita il voto, esattamente come un trust boundary fallito sulla lente architettura.

Come chiamarlo

Invia il testo completo della specifica verbatim come implementation_context; per un change OpenSpec, concatena proposal.md, design.md, tasks.md e le delta spec. Senza troncamenti e senza puntini segnaposto (vengono letti come contenuto letterale). Passa lo stesso valore repository tra le chiamate per raggruppare i round nella dimensione spec di un progetto. spec.validate è solo sincrono e single-pass nella v1 (niente certificazione o modalità consensus per ora; restano solo su architect.validate). 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. Una nota onesta di calibrazione: il prompt di scoring v1 rispecchia la struttura del contratto dell'architect ma non è ancora tarato su un corpus di run reali come architect.validate, quindi tratta il voto come segnale direzionale di qualità, non come verdetto certificato.

Cos'è spec.validate, e come si collega ad architect.validate e design.validate?

Sono lo stesso validatore con la doctrine scambiata, tre lenti di un unico prodotto. spec.validate valuta l'intento scritto da cui il team costruirà, una proposta, un documento di requisiti o un change bundle in stile OpenSpec, rispetto alle 8 leggi dello Spec Quality Blueprint, prima che il codice esista. architect.validate valuta l'architettura agentica costruita rispetto ai 10 principi agentici; design.validate valuta la superficie renderizzata rispetto alle 8 leggi di experience design. Stessa pipeline first-pass, stessa forma ValidationResponse, stesso scorer pesato per severità, quindi un Blueprint Readiness Score è calcolato allo stesso modo su tutte e tre. I run condividono una sola dashboard di validation history, taggati spec, architecture e surface. Passa lo stesso repository e ottieni un progetto valutato sull'intero trio: cosa costruire, come è costruito e cosa incontra l'utente.

Che piano serve, e condivide la quota con le altre lenti?

Un piano Pro o Teams. spec.validate ha una propria allocazione settimanale di run, misurata separatamente dai bucket architettura e design, così una settimana intensa di code review non consuma mai le tue review di specifica. A differenza del bucket architettura non esiste un topup pack per spec: una quota esaurita si recupera al rinnovo settimanale o con un upgrade di piano. Gli account Free e Basic leggono gratuitamente ogni principio, cluster ed esempio della doctrine via MCP pubblico; il PM 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.

“La testabilità è il requisito minimo.” Cosa significa per il mio voto?

Le otto leggi non pesano allo stesso modo. In caso di conflitto l'ordine è fisso: l'accettazione testabile batte la completezza, la disciplina di scope batte l'ambizione, e la completezza dell'handoff batte la comodità dell'autore. In pratica: un requisito portante senza segnale di accettazione osservabile, o un passo irreversibile che cambia stato senza gate umano nominato né percorso di rollback, è valutato come production_blocker. Limita il voto e va corretto prima di costruire, esattamente come un trust boundary fallito limita il voto di architettura e una violazione WCAG limita il voto di superficie. Un decision trail povero o una citazione della doctrine mancante è hardening_recommended o polish: emerge in una lista di prossima iterazione senza trascinare giù lo score. Un voto alto significa che i requisiti minimi della specifica reggono, non che il documento è esaustivo.

Il voto della specifica è un verdetto certificato?

Non ancora, e il tool lo dichiara a ogni run. spec.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 testabilità: un requisito che nessuno può verificare, o un passo irreversibile senza gate nominato, è un fatto verificabile del documento, non una questione di gusto.

Cosa devo inviare, e cosa torna marcato not_applicable?

Invia il testo completo della specifica verbatim come implementation_context. Per un change OpenSpec, concatena proposal.md, design.md, tasks.md e le delta spec in un'unica chiamata, senza troncamenti e senza segnaposto (vengono letti come contenuto letterale, e il reviewer valuterebbe un documento che non è il tuo). Codice sorgente e artefatti UI restituiscono spec_classification: non_spec e tier: not_applicable, non sono bocciati, semplicemente non sono specifiche; inviali invece ad architect.validate o design.validate. Invia il documento reale da cui il team costruirà.

La mia specifica viene conservata quando chiamo spec.validate?

Il testo della tua specifica è 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 testo della tua specifica) vengono comunque conservati. Qualsiasi testo con forma di istruzione dentro il tuo documento è 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.