Rivedi ciò che conta.

Conosci l'impatto prima che il codice esista. Rivedi solo ciò che ha bisogno di te.

Il codice scritto dall'IA diventa prevedibile quando l'agente annuncia prima il suo lavoro. Probe misura il rischio del piano prima che venga scritto codice, poi verifica che la modifica abbia fatto esattamente ciò che era stato annunciato. Una modifica che segue un piano a basso rischio e supera i suoi controlli può essere unita senza che una persona legga il diff; tutto il resto va in revisione, con i motivi.

1. Pianifica e verifica l'intento

   probe plan fa simulare all'agente la modifica in sola lettura. Regole fisse, non il modello, segnalano percorsi critici, modifiche ad API pubbliche e dipendenze, codice molto usato o non testato. Un piano segnalato passa a una persona prima che venga scritto codice.

2. Un agente implementa il piano

   Il piano diventa un contratto: i file, i simboli e le dipendenze che l'agente può toccare. Implementa quello, e solo quello.

3. Verifica la conformità

   probe review --plan rivaluta il piano, esegue i controlli nella sandbox e confronta il diff con il contratto: ogni file non pianificato, modifica API non annunciata, percorso critico o dipendenza viene riportato.

4. Unisci, oppure rivedi

   Modifica conforme, piano a basso rischio, controlli superati, nient'altro segnalato: nessuna revisione umana necessaria, uscita 0, la pipeline esegue il merge. Altrimenti uscita 2: una persona rivede la pull request, partendo dai motivi elencati.

# 1. before coding: plan, and let a human validate a flagged plan
probe plan --intent-file task.md --ci
# 2. the agent implements .probe/PLAN.json
# 3-4. in CI: conformance, checks and the gate (exit 0 = merge, 2 = review)
probe review --base origin/main --plan .probe/PLAN.json --ci
Plan conformance: conforming; 0 high, 0 medium, 0 low differences from the plan.
Plan gate: no human review required (low-risk plan, conforming change, checks passed, nothing else requests review).

Il gate è una decisione di processo, non una prova di correttezza: la tua policy attendibile decide cosa è critico e quali test vengono eseguiti, e qualsiasi dubbio manda la modifica a una persona. Come decide il gate.

Cosa apri al posto del diff grezzo

Estratto di .probe/CONFIDENCE_REPORT.md, prodotto da probe review HEAD~1..HEAD --reviewer=false --ci (v0.3.0) su un piccolo repository di e-commerce. Il commit ha aggiunto helper per il catalogo con relativi test, rielaborato i rimborsi e toccato le autorizzazioni. Non è stato usato alcun provider di IA.

## Change Summary
120 additions / 5 deletions · 5 files changed
Exit code: 2. No confidence percentage is assigned.

## Automated Checks1
- PASS test      (check-1; exit 0; 5982 ms)
- PASS typecheck (check-2; exit 0; 4866 ms)
- PASS build     (check-3; exit 0; 2835 ms)
- PASS coverage  (check-4; exit 0; 6416 ms)

## Reproduced Issues2
No issue was reproduced by a passing baseline
and failing candidate experiment.

## Suggested Human Review3
- high auth/auth.go:7 (new): Authentication or
  authorization function body changed
- high payment/refund.go:21–22 (new): Payment-sensitive
  function body changed
- high payment/refund.go:25–26 (new): Exported Go
  declaration added; Payment-sensitive function body changed
- high payment/refund.go:21 (old): Configured sensitive
  path changed; No nearby test file changed;
  Possible input validation removed
- medium catalog/format.go:9 (new): Exported Go
  declaration added
  … 11 more medium signals in catalog/

## Review Surface4
Focused review: 19 / 125 changed lines.

## Changed-line Execution5
Of 67 added Go lines, 44 were executed at least once,
0 were not executed, 23 are not inside any
instrumented block.