From 32501f01936ecfb1aafc15e17b74f638b4069d23 Mon Sep 17 00:00:00 2001
From: Matteo <30387529+max23468@users.noreply.github.com>
Date: Sun, 31 May 2026 15:32:05 +0200
Subject: [PATCH] docs: chiarisci catalogo documentale output

---
 AGENTS.md     | 11 +++++++++++
 docs/INDEX.md |  2 ++
 2 files changed, 13 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 22ea41a..e406df4 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -29,6 +29,9 @@ senza decisione esplicita.
   `docs/INDEX.md`, `docs/CONTEXT.md`, `docs/ROADMAP.md`, `docs/BACKLOG.md`,
   `docs/TOOLCHAIN.md`, `docs/DECISIONS.md`, `docs/DECISIONS_PENDING.md` e
   `docs/decisions/`.
+- Il catalogo documentale canonico è `docs/INDEX.md`: la root resta per
+  ingresso, configurazione, codice e output applicativi dichiarati; `docs/`
+  conserva governance, roadmap, backlog, contesto, toolchain, decisioni e guide.
 - Mantieni scope piccolo e coerente con la richiesta.
 - Non sovrascrivere modifiche non tue.
 - Per lavori non banali usa branch `codex/<tema>` e PR verso `main`; il commit diretto su `main` resta solo per micro docs-only a basso rischio.
@@ -48,6 +51,14 @@ senza decisione esplicita.
 ## Policy dati
 
 - `data/`, `snapshots/` e `reports/` sono output applicativi e possono essere committati dal workflow.
+- I report Markdown in `reports/` e gli snapshot non sono governance di
+  progetto: sono evidenze/output del monitor. Non spostarli in `docs/` e non
+  usarli come source of truth se contraddicono `AGENTS.md`, `docs/INDEX.md` o
+  le decisioni.
+- Le copie `*/skills/react-doctor/SKILL.md` e `skills/react-doctor/SKILL.md`
+  sono artefatti operativi per agenti/tooling; non trattarle come catalogo
+  documentale di progetto e non modificarle durante interventi governance salvo
+  richiesta esplicita.
 - La prima scansione crea baseline silenziosa: report sempre generato, email no se non ci sono cambiamenti o errori.
 - HTML: salva hash, metadati e testo normalizzato; non salvare HTML completo.
 - File pubblici: salva hash binario e metadati.
diff --git a/docs/INDEX.md b/docs/INDEX.md
index 2f3a25b..61156c3 100644
--- a/docs/INDEX.md
+++ b/docs/INDEX.md
@@ -38,6 +38,8 @@ Sentinel usa la root per ingresso operativo, configurazione e codice. Usa
 - `.github/ISSUE_TEMPLATE/`: template issue.
 - `.github/dependabot.yml`: manutenzione dipendenze npm e GitHub Actions.
 - `data/`, `snapshots/`, `reports/`: output applicativi tracciabili.
+- `skills/react-doctor/SKILL.md` e copie sotto cartelle agent/tool nascoste:
+  artefatti operativi di tooling, non documentazione governante.
 - `docs/doppler-setup.md`: configurazione Doppler e stato GitHub verificato.
 
 ## Regole di manutenzione