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:
spec_classificationspec_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.
per-law findingsUn verdetto per ognuna delle otto leggi con severity_score (0–100), severity_class, evidenze citate dal tuo testo reale e una raccomandazione specifica.
readinessScore, 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.
spec dimensionI 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 outcomeNomina chi è bloccato e il cambiamento osservabile che dimostra il problema risolto, prima di nominare qualsiasi meccanismo.
S2 · Scope one bounded changeUn solo cambiamento coerente con un confine nominato e una lista esplicita di ciò che è fuori scope.
S3 · Make every requirement testably acceptableOgni requisito porta un segnale di accettazione osservabile che qualcuno può verificare. Un requisito portante senza segnale è un production_blocker.
S4 · Record the decision trailLe alternative considerate, perché hanno perso, e le domande aperte con un owner: il ragionamento sopravvive all'autore.
S5 · Complete the handoffOgni 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 upfrontI principi e i vincoli che il lavoro deve rispettare sono nominati nella specifica, non scoperti in review.
S7 · Keep decomposition traceableI task risalgono ai requisiti, così non viene rilasciato nulla che nessun requisito abbia chiesto.
S8 · Name risk and reversibilityI 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.
Also in this section