verify-agent
Adversarial cross-model verification of work produced by an AI agent — code, documents, data, config, anything. A different model attacks the work against its brief, Claude arbitrates. Triggers on /verify-agent — or natural language like "verifica il lavoro che ha fatto l'agente", "è corretto quello che ha fatto Claude/Codex?", "fai revisionare questo lavoro da un altro modello", "controlla che il task sia stato fatto bene".
DarioFontanel · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add DarioFontanel/verify-agent --skill verify-agentAbout this skill
name: verify-agent description: Adversarial cross-model verification of work produced by an AI agent — code, documents, data, config, anything. A different model attacks the work against its brief, Claude arbitrates. Triggers on /verify-agent — or natural language like "verifica il lavoro che ha fatto l'agente", "è corretto quello che ha fatto Claude/Codex?", "fai revisionare questo lavoro da un altro modello", "controlla che il task sia stato fatto bene".
Verifica adversariale cross-model del lavoro prodotto da un agente. Principio fondante: nobody grades their own work — il modello che ha prodotto il lavoro (o un suo clone) non può correggerselo; serve un modello di famiglia diversa, promptato per attaccare, non per approvare.
Ruoli fissi:
- Reviewer (modello esterno, read-only): cerca di confutare che il lavoro rispetti il brief.
- Arbitro (Claude, questa sessione): verifica meccanicamente ogni finding, corregge o confuta con evidenza. Un finding è un claim, non una verità — anche i reviewer allucinano.
Visibilità: l'utente segue il processo da ./tmp/verify/<slug>/. Al kickoff annuncia in chat il path della cartella; a ogni passaggio (brief congelato, check meccanici, round del reviewer lanciato/concluso, verifica dei findings) una riga in chat: cosa è appena successo e quale file lo documenta. Mentre il reviewer gira, indica il file da seguire in diretta (tail -f .../roundN-<backend>.jsonl).
Process
1. Pin: artefatto + brief
Artefatto = cosa va verificato. Se l'utente non lo indica: il lavoro appena prodotto in sessione (diff non committato, file appena creati). Se ambiguo, chiedi.
Brief = il contratto contro cui si verifica. Cercalo in quest'ordine:
- Un file di spec/PRD passato dall'utente o evidente nel progetto (
docs/,specs/,plans/,~/.claude/plans/) - GitHub issue referenziata (commit message, branch name) — fetch via
gh - Un documento di handoff esistente (es.
./tmp/handoff*.md) - Nessuno dei precedenti → deducilo dalla conversazione corrente: ricostruisci la richiesta originale in 5-10 righe e mostrala all'utente per conferma
- Nessuna conversazione (es. lavoro fatto da un altro agente in un'altra sessione) → chiedi all'utente cosa era stato chiesto
Congela tutto in ./tmp/verify/<slug>/BRIEF.md: brief + manifest dell'artefatto (lista file / comando diff). I reviewer sono CLI esterne: devono trovare tutto su disco. <slug> = nome breve del task, kebab-case. Verifica che ./tmp sia ignorata da git; se non lo è, segnalalo all'utente lasciando .gitignore com'è.
Insegnamento chiave: il brief è il contratto. Senza un brief chiaro nessuna review può dire "è corretto" — può solo dire "è plausibile".
2. Check meccanici (prima di ogni opinione)
Prima di chiedere pareri a un LLM, dimostra ciò che è dimostrabile. Per tipo di artefatto:
| Artefatto | Check |
|---|---|
| Codice | test, lint, build, eseguire davvero il codice sul caso d'uso del brief |
| Documento/report | link raggiungibili, numeri ricalcolati dalla fonte, claim fattuali riscontrati |
| Dati/migrazione | conteggi prima/dopo, invarianti, query di controllo |
| Config/infra | validazione sintassi, dry-run, diff con stato precedente |
Ogni check fallito è già un finding (severità BLOCKER) — non serve un reviewer per quello. Registra esiti in REVIEW-LOG.md (Round 0). Se l'artefatto richiede processi vivi (dev server): i processi già attivi ma non avviati in questa sessione appartengono ad altri — lasciali vivere e usa una porta libera dedicata.
3. Review cross-model adversariale
Scelta backend — default il primo disponibile; l'utente può indicarne uno o più ("verifica con gemini e codex"):
| Priorità | Backend | Requisito |
|---|---|---|
| 1 | Codex CLI (codex exec) | login ChatGPT |
| 2 | Gemini (API REST) | GEMINI_API_KEY |
| 3 | OpenRouter (API REST) | OPENROUTER_API_KEY |
| 4 | Ollama (locale) | modello locale — vedi warning in references/backends.md |
Comandi di invocazione, modelli e caveat: references/backends.md.
Cosa riceve il reviewer: BRIEF.md + artefatto (diff o file) + esiti dei check meccanici. MAI il ragionamento di Claude, la conversazione, o giustificazioni sul perché il lavoro è fatto così — solo lavoro e contratto.
Prompt del reviewer (adattare i riferimenti ai file, non il tenore):
Sei un reviewer adversariale. Un altro agente AI ha prodotto il lavoro descritto
sotto. Il tuo UNICO compito è provare a dimostrare che il lavoro NON rispetta
il brief. Non sei qui per approvare: sei qui per trovare problemi.
BRIEF (il contratto): <contenuto di BRIEF.md>
ARTEFATTO: <diff o contenuto file>
CHECK MECCANICI GIÀ ESEGUITI: <esiti round 0>
Attacca su questi assi, in ordine:
1. SPEC — requisiti del brief mancanti o implementati solo in parte;
comportamento presente ma NON richiesto (scope creep).
2. CORRETTEZZA — punti dove il lavoro fa la cosa sbagliata, con quali input
fallisce, edge case ignorati, claim falsi.
3. EFFETTI COLLATERALI — cose toccate fuori dallo scope del brief: file
modificati/cancellati che non c'entrano, segreti esposti, regressioni.
Regole:
- Ogni finding: severità (BLOCKER | MAJOR | MINOR), evidenza ESATTA
(quote/file/riga), e un passo di verifica meccanica che chiunque può
eseguire per confermarlo.
- Niente opinioni di stile: solo violazioni del brief o errori dimostrabili.
- Se dopo un attacco genuino non trovi nulla: rispondi "PASS" ed elenca
cosa hai attaccato e perché ha retto. Un PASS senza lista è invalido.
Formato output:
## Findings
### [SEVERITÀ] titolo breve
- Evidenza: ...
- Come verificarlo: ...
(oppure)
## PASS
- Attaccato: ... → ha retto perché ...
Con più backend: lanciali in parallelo, poi deduplica i finding (stesso file+problema = uno solo, tieni la severità più alta) prima della verifica dei findings.
4. Verifica dei findings e loop (max 3 round)
Per ogni finding, in ordine di severità:
- **Veri