# osmani-lunt-wang-code-review-claude-code-2026-10-15

## Veille

Articolo tecnico di **Addy Osmani**, **Morgan Westlee Lunt** e **Qing Wang** (il team di **Claude Code**, **Anthropic**) sul blog *claude.dev*, pubblicato il **15 ottobre 2026**; ~3.200 parole. Descrive il flusso di code review del team, in cui Claude scrive circa il **90%** del codice per Claude Code. Da giugno a settembre, le PR unite sono **più che raddoppiate** e la quota di revert è scesa di **oltre il 40%**; nel monorepo di Anthropic, le modifiche giornaliere sono passate da **~2.500** (maggio) a **oltre 30.000** (settembre).

## Titre Article

How the Claude Code team does code review

## Date

2026-10-15

## URL

https://claude.dev/blog/solving-code-review-at-anthropic/

## Keywords

code review, code review, agentic code review, Claude Code, Code Review for Claude Code, REVIEW.md, CLAUDE.md, approvazione graduata per rischio, classificatore di rischio, revisione di sicurezza, coda di merge, feature flags, rollout progressivo, rollback, eval sugli incidenti, rumore del revisore, convergenza della revisione, limite ai giri, tempo umano, tasso di revert, responsabilità dell'autore, spiegazione del codice, verifica

## Authors

Addy Osmani, Morgan Westlee Lunt, Qing Wang — équipe Claude Code (Anthropic) ; blog *claude.dev*, catégorie Engineering.

## Ton

Debriefing di team, in prima persona plurale, in un registro fattuale e operativo. Il testo pone una domanda (come revisionare al volume in cui gli agenti producono), ridefinisce lo scopo della revisione, poi segue la vita di una modifica livello per livello, prima di descrivere il miglioramento del revisore, il posto degli umani e la diffusione del contesto. Si basa su dati interni (volumi, tasso di revert, quota di PR commentate, giri di revisione) e cinque diagrammi. Segnala i propri limiti: ancora nessun *circuit breaker* che inasprisca l'approvazione quando gli indicatori cambiano, nessun processo formale di condivisione del contesto, una PR che ha attraversato più di cinquanta giri. Si chiude con un elenco di adozione a fasi e una richiesta di feedback ai team che lasciano gli agenti aprire PR. I prodotti Anthropic citati (Code Review, `/code-review`, `/security-review`, GitHub Action) sono presentati come i componenti di base disponibili.

## Pense-betes

- **Obiettivo**: la domanda non è più *"un umano ha letto il codice?"* ma *"cosa può andare storto, e quale controllo dovrebbe individuarlo?"*. La revisione diventa continua, come un correttore ortografico.
- **Metriche**: approvazioni umane per PR (mediana, p95), commenti umani, tempo di attesa su una persona; salvaguardia = tasso di revert e tasso di incidenti.
- **Prima della PR**: Claude mostra l'output (test, build, screenshot); un subagent revisiona il diff in un contesto nuovo; skill interne per la caccia ai bug, la semplificazione, l'E2E. Boris Cherny stima che la verifica rende il risultato **da 2 a 3 volte** migliore.
- **REVIEW.md**: scritto dai proprietari del codice; breve; indica come si presenta un fallimento (doc: *"mente"*, config: *"instrada male"*), limita i nit, richiede file e riga come evidenza.
- **Revisione IA**: PR con commenti sostanziali **16% → 54%**; livelli Quick / Standard / Deep; voto dei verificatori; tag Important / Nit / Pre-existing; ogni riscontro deve essere affrontato.
- **Livelli**: basso (doc, flag) = zero umani; medio = uno; alto = due. È la modifica a fissare il livello, non l'autore; l'approvazione di un agente non sostituisce mai quella di un umano; approvazione legata a un commit.
- **Convergenza**: il 59% delle segnalazioni ripetute riguardava codice presente già dal primo passaggio. Dopo le correzioni: pass in un giro **65% → 78%**, cinque giri o più **8,9% → 1,5%**, media **2,08 → 1,32**.
- **"You land it, you own it"**: modifiche piccole, tutto reversibile, la superficie d'impatto fissa il requisito, nessuna colpa.
- **Contesto condiviso**: una spiegazione generata da Claude della porzione di codice da modificare, piuttosto che leggere diff banali.
- Vicino a [[houck-dx-what-are-code-reviews-for-2026-08-05]] e [[sfeir-code-review-anneau-contraintes-2026-07-30]].

## RésuméDe400mots

Il team Claude Code di Anthropic descrive come effettua la revisione di codice prodotto per circa il 90% da Claude. Il volume è esploso: nel monorepo di Anthropic, le modifiche giornaliere sono passate da circa 2.500 in maggio a oltre 30.000 in settembre, e la revisione manuale riga per riga non è più sostenibile. Da giugno a settembre, le PR unite su Claude Code sono più che raddoppiate, mentre la quota di revert è scesa di oltre il 40%.

La revisione svolge due funzioni: individuare i difetti e diffondere la conoscenza del codice. Per la prima, il team sostituisce la domanda "l'ha letto un umano?" con "quale controllo dovrebbe individuare ciò che può andare storto?". L'obiettivo: la maggior parte delle PR viene unita con al massimo un umano, senza aumento di revert o incidenti, che fungono da salvaguardia.

Una modifica passa attraverso diversi livelli. Prima della PR, Claude esegue test, build e linter e ne mostra l'output, poi un subagent revisiona il diff in un contesto nuovo. CLAUDE.md descrive il progetto; REVIEW.md, scritto dai proprietari del codice, indica al revisore cosa conta. Su ogni PR, diversi agenti cercano bug in parallelo, altri votano su ciascun riscontro, e solo i riscontri confermati vengono pubblicati, ordinati per gravità. Una revisione di sicurezza separata e la CI bloccano l'unione finché resta aperto un problema. Un classificatore determina il livello di rischio, e quindi il numero di approvatori umani (zero, uno o due); alcuni percorsi richiedono sempre una persona, e l'approvazione di un agente non conta mai come quella di un umano. Coda di merge, feature flags, uso interno in anticipo, un canale latest prima dello stable e rollback rapido completano l'impianto.

Il revisore migliora in un ciclo. Le PR che hanno causato incidenti, confermate da esperti, formano un eval rigiocato ogni giorno. Il rumore è misurato dal modo in cui reagiscono gli autori, poiché un agente corregge ogni nit e rilancia un giro. Una PR ha attraversato più di cinquanta giri in una sola notte; il team ha fissato un limite di tre giri, ha limitato la nuova revisione al solo nuovo diff e ha eliminato le ripetizioni, portando la media da 2,08 a 1,32 giri.

Gli umani mantengono cinque decisioni: se costruirlo, il codice rischioso, l'architettura, la lettura delle evidenze e la responsabilità del risultato. Per comprendere il codice, a Claude viene chiesta una spiegazione della porzione rilevante. La norma "you land it, you own it" si basa su modifiche piccole e reversibili. L'articolo si chiude con un elenco di adozione a fasi.

## GrapheDeConnaissance

- Addy Osmani —publie→ article How the Claude Code team does code review (DOCUMENT, 0.98)
- Morgan Westlee Lunt —publie→ article How the Claude Code team does code review (DOCUMENT, 0.98)
- Qing Wang —publie→ article How the Claude Code team does code review (DOCUMENT, 0.98)
- Anthropic —mesure→ changements quotidiens du monorepo : ~2 500 en mai → plus de 30 000 en septembre 2026 (MESURE, 0.95)
- Claude Code —mesure→ PR fusionnées ×2+ et part revertée −40 %+ de juin à septembre 2026 (MESURE, 0.95)
- Anthropic —affirme_que→ « un humain a-t-il lu le code ? » est un proxy imprécis de « quel contrôle doit attraper ce qui peut mal tourner ? » (AFFIRMATION, 0.93)
- revue de code agentique —réduit→ temps de revue humain (CONCEPT, 0.9)
- revue de code agentique —utilise→ Code Review for Claude Code (TECHNOLOGIE, 0.92)
- revue de code agentique —utilise→ REVIEW.md (DOCUMENT, 0.92)
- revue de code agentique —utilise→ CLAUDE.md (TECHNOLOGIE, 0.9)
- revue de code agentique —utilise→ approbation graduée par le risque (METHODOLOGIE, 0.92)
- revue de code agentique —utilise→ /security-review (TECHNOLOGIE, 0.88)
- Code Review for Claude Code —mesure→ PR internes avec commentaires substantiels : 16 % → 54 % (MESURE, 0.93)
- approbation graduée par le risque —utilise→ classifieur de risque (TECHNOLOGIE, 0.9)
- eval d'incidents —améliore→ Code Review for Claude Code (TECHNOLOGIE, 0.88)
- plafond de rondes de revue —réduit→ itérations revue-correction (CONCEPT, 0.9)
- plafond de rondes de revue —mesure→ rondes moyennes avant passage : 2,08 → 1,32 ; cinq rondes ou plus : 8,9 % → 1,5 % (MESURE, 0.93)
- Boris Cherny —affirme_que→ donner à Claude un moyen de vérifier son travail rend le résultat 2 à 3 fois meilleur (AFFIRMATION, 0.9)
- Anthropic —recommande→ ne jamais laisser l'approbation d'un bot remplacer celle d'un humain requis (AFFIRMATION, 0.93)
- Anthropic —recommande→ mesurer le temps humain avec taux de revert et d'incident comme garde-fou (AFFIRMATION, 0.92)
- You land it, you own it —s_applique_à→ Claude Code (TECHNOLOGIE, 0.88)
- Claude Code —utilise→ merge queue (TECHNOLOGIE, 0.88)
- Claude Code —utilise→ feature flags (TECHNOLOGIE, 0.88)
- article How the Claude Code team does code review —référence→ Boris Cherny (PERSONNE, 0.92)

---
Canonical: https://www.thekb.eu/it/fiches/osmani-lunt-wang-code-review-claude-code-2026-10-15/