agentleFS
Lucas-GrilliLucas-Grilli/SMM_OS/.claude/skills/pulizia-sistema/SKILL.md

pulizia-sistema

Skill2 starsChanged 3 months agoMITView on GitHub

Controlli meccanici sul secondo cervello (link rotti, file orfani, path stale, naming non conforme, discrepanze data macro/micro) più, a cadenza periodica, il livello di giudizio (duplicazioni di contenuto, scollamento regole↔realtà, pattern ripetuti nel feedback). Usare per "fai pulizia sistema", "controlla il sistema", "verifica il vault".

The file

Files
SKILL.md

Pulizia sistema

v2.0

Obiettivo: intercettare rotture strutturali con un controllo ripetibile invece di scoprirle per caso, più il giudizio che il solo controllo meccanico non vede. Segnala, non corregge — le correzioni si decidono con l'utente dopo il report.

Passi

Meccanici (1-7, deterministici — nessuna interpretazione, solo confronto tra file):

  1. Data reale con un comando — mai dedotta dalle ultime entry dei file.
  2. Mappa la struttura — Glob (non Read) di tutti i CLAUDE.md, memory.md, archive.md, index_*.md/*_index.md del sistema, ogni livello di 10_clienti/ incluso. Solo struttura, non contenuto: è la lista su cui girano i controlli sotto.
  3. Link rotti o ambigui — per ogni wikilink [[ ]] o link a path nei file mappati: verifica (Glob sul nome file) che risolva a esattamente un file. Segnala sia i link a niente sia gli ambigui (più file con lo stesso nome).
  4. File orfani — file dentro una cartella indicizzata (02_wiki/*, 03_skills/, ecc.) che non compare in nessun index della sua categoria: irraggiungibile dalla cascata anche se esiste su disco (Regola 1 di CLAUDE.md).
  5. Path stale — riferimenti a path che non esistono più su disco (cartelle rinominate, spostate, appiattite). Confronta i path scritti nei file con l'albero reale.
  6. Naming non conforme — file che non rispettano le convenzioni correnti (kebab-case per note wiki, doppio livello *_index.md/index_<categoria>.md per cartelle — elenco completo in 99_system/manuale-operativo.md).
  7. Discrepanze macro/micro — per ogni progetto in tabella "Clienti Attivi" di memory.md root: confronta la data "Ultimo aggiornamento" con quella nel memory.md del progetto. Ogni mismatch è un candidato di propagazione mancata.

Di giudizio (8-10, richiedono lettura e interpretazione — solo nel giro periodico, non a ogni esecuzione):

  1. Duplicazioni di contenuto — stesso fatto scritto in più di un memory.md invece che in un solo posto con puntatore altrove (Regola 4 di CLAUDE.md).
  2. Scollamento regole↔realtà — confronta le regole scritte (CLAUDE.md a ogni livello, 99_system/manuale-operativo.md) con la pratica osservata in 00_context/dump/ (ultimo periodo) e nei memory.md. Segnala dove una regola non si segue più, o dove la pratica ha superato la regola senza che questa sia stata aggiornata.
  3. Pattern ripetuti — legge 00_context/dump/ (ultimo periodo) e 99_system/feedback_sistema.md: correzioni o feedback che tornano più volte sullo stesso punto sono candidati a diventare regola nuova in CLAUDE.md, invece di restare promemoria sparso.

Report finale — elenco per categoria (link rotti, orfani, path stale, naming, discrepanze data, duplicazioni, scollamento regole↔realtà, pattern ripetuti), ognuno con file e riga coinvolti. Nessuna modifica applicata in questa esecuzione.

Regole dure

  • Segnala, non corregge. Le correzioni si decidono con l'utente dopo il report, passaggio per passaggio o in blocco — mai applicate d'iniziativa.
  • Su richiesta → solo Passi 1-7. Il giro di giudizio (8-10) ha senso a cadenza periodica: pesa di più, richiede interpretazione e non solo confronto.
  • Prerequisito: l'intera cartella del sistema (root) montata, non un progetto specifico. Per i Passi 8-10 servono anche 00_context/dump/ e 99_system/feedback_sistema.md raggiungibili.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.