From 5990e61d18d6dc12242743320b62b89ab4d0994e Mon Sep 17 00:00:00 2001 From: Matteo <30387529+max23468@users.noreply.github.com> Date: Sun, 31 May 2026 01:20:19 +0200 Subject: [PATCH 1/2] docs: close AGENTS decision gaps --- AGENTS.md | 33 +++++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 3504f14..68bef38 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,6 +5,15 @@ Rispondi sempre in italiano, in modo pratico, diretto e operativo. Sentinel è un tool custom generico per monitorare cambiamenti su siti web pubblici. Il primo monitor configurato è Ortix. +Priorità: istruzioni di sistema/developer, questo `AGENTS.md`, eventuali +`AGENTS.md` più profondi che prevalgono per il loro scope, documenti canonici +della repo, richiesta utente, convenzioni reali di codice/test/configurazione e +assunzioni solo marginali. + +Sentinel non è una piattaforma di crawling generalista, non è un archivio +integrale di siti terzi e non deve diventare una dashboard o servizio multi-user +senza decisione esplicita. + ## Stack - Runtime: Node.js + TypeScript. @@ -29,6 +38,12 @@ Il primo monitor configurato è Ortix. - Non committare segreti, password SMTP, file `.env` o cache locali. - Le password email devono arrivare solo da variabili d'ambiente, GitHub Secrets o Portachiavi. - Valuta impatto su documentazione, changelog, versione, release e deploy prima di chiudere, anche quando il risultato è `N/A`. +- Usa Conventional Commit coerenti con l'impatto reale. Non aggiungere workflow, + bot, release flow, deploy automation o branch protection senza decisione + esplicita. Usa PR template, issue template, PR title check o controllo + equivalente quando lavori via GitHub. +- Dopo merge/pubblicazione controlla `git branch -vv` e `git worktree list`, poi + pulisci branch/worktree non più necessari o dichiara cosa resta aperto. ## Policy dati @@ -37,6 +52,13 @@ Il primo monitor configurato è Ortix. - HTML: salva hash, metadati e testo normalizzato; non salvare HTML completo. - File pubblici: salva hash binario e metadati. - Mantieni al massimo gli ultimi 3 snapshot testuali per URL. +- Non committare cache, log, dump, export, screenshot sensibili, `.DS_Store` o + altri file temporanei non previsti. Durante migrazioni, rinomini o merge + documentali non perdere contenuti utili: aggiorna link e indici, preserva ciò + che resta valido e dichiara nel riepilogo ciò che viene rimosso perché superato. +- Per siti pubblici, provider email, API, prezzi, limiti o policy variabili, + verifica fonti ufficiali correnti e distingui fatto, fonte, assunzione e + decisione interna. ## Ortix MVP @@ -86,14 +108,21 @@ Tag e GitHub Release sono ammessi solo per release del tool o della dashboard secondo `docs/decisions/0003-tag-e-github-release.md`. Non crearli per semplici scan, report, snapshot o aggiornamenti data-only. +Release Please non è adottato: non delegare changelog, versioni, tag o GitHub +Release a bot automatici senza nuova decisione esplicita. + La issue GitHub `Codex feedback inbox` è il canale operativo per i commenti Codex sulle PR ed è aggiornata dal workflow `Codex PR comments`. Controllala -prima di PR ready, merge o pubblicazione non banale. +prima di PR ready, merge, pubblicazione, deploy o release non banali. + +Sentinel non ha UI React oggi. Se verrà introdotta una dashboard, aggiungi +verifiche browser, responsive, accessibilità e stati vuoti/errore/loading +proporzionati prima di considerarla completa. ## Risposta finale e completamento Chiudi con cosa è cambiato o scoperto, file principali se utili, verifiche -eseguite o non eseguite con motivo, stato publish/release/deploy, branch/worktree +eseguite o non eseguite con motivo, stato publish, release e deploy, branch/worktree coinvolti, rischi residui e prossimo passo reale. Un lavoro è completo solo se scope, verifiche proporzionate, inbox, output applicativi, publish/release/deploy e cleanup sono gestiti o dichiarati non applicabili. From 872db5c2efa386f27197c172c790610e5941700b Mon Sep 17 00:00:00 2001 From: Matteo <30387529+max23468@users.noreply.github.com> Date: Sun, 31 May 2026 01:33:10 +0200 Subject: [PATCH 2/2] docs: fix nested AGENTS precedence --- AGENTS.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 68bef38..40c112a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,8 +5,8 @@ Rispondi sempre in italiano, in modo pratico, diretto e operativo. Sentinel è un tool custom generico per monitorare cambiamenti su siti web pubblici. Il primo monitor configurato è Ortix. -Priorità: istruzioni di sistema/developer, questo `AGENTS.md`, eventuali -`AGENTS.md` più profondi che prevalgono per il loro scope, documenti canonici +Priorità: istruzioni di sistema/developer, eventuali `AGENTS.md` più profondi +che prevalgono per il loro scope, questo `AGENTS.md`, documenti canonici della repo, richiesta utente, convenzioni reali di codice/test/configurazione e assunzioni solo marginali.