From 7c8b3ccf33eef52fe933d90ae60e7624a1ebb30b Mon Sep 17 00:00:00 2001
From: Matteo <30387529+max23468@users.noreply.github.com>
Date: Sun, 31 May 2026 23:25:38 +0200
Subject: [PATCH] docs: align verification lanes

---
 AGENTS.md         | 13 +++++++++++++
 docs/TOOLCHAIN.md | 10 ++++++++++
 2 files changed, 23 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 89c1116..a817774 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -100,6 +100,19 @@ npm run build
 
 Usa la corsia `veloce` per docs/governance a basso rischio, `standard` per codice/config ordinari e `completa` per runtime schedulato, dati/output, sicurezza, release o deploy.
 
+Mappa il rischio prima dei comandi:
+
+- sola analisi o nessuna modifica: nessun test applicativo, dichiarare fonti e
+  limiti;
+- docs-only: review documentale e `git diff --check` quando utile;
+- documenti operativi critici, workflow o config: review mirata del runbook o
+  workflow modificato;
+- test-only, runtime piccolo o UI localizzata: `npm test`, `npm run build` o
+  check mirati in base al diff;
+- runtime schedulato condiviso, dati/output, provider email, deploy/config,
+  release/versioning o UI dashboard sostanziale: gate completo proporzionato,
+  smoke/manual run quando serve e React Doctor nei casi previsti.
+
 Se un controllo fallisce o non è eseguibile, dichiaralo esplicitamente con impatto e prossimo passo.
 
 ## Release e deploy
diff --git a/docs/TOOLCHAIN.md b/docs/TOOLCHAIN.md
index 5f6f543..8eed1b6 100644
--- a/docs/TOOLCHAIN.md
+++ b/docs/TOOLCHAIN.md
@@ -59,6 +59,16 @@ Questa pagina descrive runtime, comandi e guardrail effettivi di Sentinel.
 - test email Gmail: `npm run sentinel -- test-email --profile gmail`.
 - test email iCloud: `npm run sentinel -- test-email --profile icloud`.
 
+## Verifiche per scope
+
+| Tipo modifica | Corsia | Verifiche minime |
+| --- | --- | --- |
+| Sola analisi | veloce | Nessun test applicativo; dichiarare fonti e limiti |
+| Docs-only | veloce | Review documentale e `git diff --check` quando utile |
+| Workflow/config o documenti operativi critici | standard | Review mirata e comando collegato al file modificato |
+| Test-only, CLI o dashboard piccola | standard | `npm test`, `npm run build` o test mirati |
+| Runtime schedulato, dati/output, provider email, deploy/config, release/versioning o UI sostanziale | completa | Gate completo proporzionato, smoke/manual run quando serve, React Doctor se applicabile |
+
 ## Pubblicazione, release e deploy
 
 - La pubblicazione codice passa da commit, push e PR/merge su GitHub; su richiesta