From 3e172b817a9bc08c882e89de3aa4a38c6ab5c4a1 Mon Sep 17 00:00:00 2001 From: sck_0 Date: Tue, 27 Jan 2026 09:32:28 +0100 Subject: [PATCH] chore: clarify validation chain to avoid CI drift --- .github/MAINTENANCE.md | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/.github/MAINTENANCE.md b/.github/MAINTENANCE.md index c22f55c5..f8da9d22 100644 --- a/.github/MAINTENANCE.md +++ b/.github/MAINTENANCE.md @@ -22,12 +22,23 @@ Committing is NOT enough. You must PUSH to the remote. ### 2. 🔄 SYNC GENERATED FILES (Avoid CI Drift) -If you touch `skills/`, you **MUST** run the validation chain. +If you touch **any of these**: -- Running `validate_skills.py` is NOT optional. -- Running `generate_index.py` is NOT optional. -- Running `update_readme.py` is NOT optional. - _If CI fails because of drift, you have failed._ +- `skills/` (aggiungi/rimuovi/modifichi skill) +- la sezione **Full Skill Registry** di `README.md` +- i **conteggi/claim** sul numero di skill (`256+ Agentic Skills...`, `(256/256)`, ecc.) + +…allora **DEVI** eseguire la Validation Chain **PRIMA** di committare. + +- Eseguire `validate_skills.py` **NON è opzionale**. +- Eseguire `generate_index.py` **NON è opzionale**. +- Eseguire `update_readme.py` **NON è opzionale**. + +Se la CI fallisce con: + +> `❌ Detected uncommitted changes in README.md or skills_index.json` + +significa che **non hai eseguito o committato** correttamente la Validation Chain. ### 3. 📝 EVIDENCE OF WORK