Skip to content

docs: chiarisci catalogo documentale output #23

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
max23468 merged 1 commit into from
May 31, 2026
Merged

docs: chiarisci catalogo documentale output #23

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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.
Expand Down
2 changes: 2 additions & 0 deletions docs/INDEX.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading