Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

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

About 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:

  1. Un file di spec/PRD passato dall'utente o evidente nel progetto (docs/, specs/, plans/, ~/.claude/plans/)
  2. GitHub issue referenziata (commit message, branch name) — fetch via gh
  3. Un documento di handoff esistente (es. ./tmp/handoff*.md)
  4. Nessuno dei precedenti → deducilo dalla conversazione corrente: ricostruisci la richiesta originale in 5-10 righe e mostrala all'utente per conferma
  5. 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:

ArtefattoCheck
Codicetest, lint, build, eseguire davvero il codice sul caso d'uso del brief
Documento/reportlink raggiungibili, numeri ricalcolati dalla fonte, claim fattuali riscontrati
Dati/migrazioneconteggi prima/dopo, invarianti, query di controllo
Config/infravalidazione 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àBackendRequisito
1Codex CLI (codex exec)login ChatGPT
2Gemini (API REST)GEMINI_API_KEY
3OpenRouter (API REST)OPENROUTER_API_KEY
4Ollama (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à:

  1. **Veri
Read the complete source ↗