Metodo KB

Framework metodologico e osservatorio cross-repo per knowledge base personali e professionali mantenute con LLM.

Questo repository ha due funzioni complementari. La prima è custodire il metodo portabile: forma dei nodi, struttura di progetto, strumenti di manutenzione, principi guida e ciclo di lavoro. La seconda è osservare come il metodo viene applicato nei progetti adottanti, confrontando componenti, strumenti, skill, nodi, task e segnali di salute delle KB.

Il metodo è portabile tra progetti di natura diversa. Il nucleo è universale — principi, struttura KB, ciclo operativo — mentre le personalizzazioni sono esplicite: ogni progetto estende il metodo con principi, fonti di verità e strumenti propri del dominio. Le differenze tra progetti non sono rumore: sono materiale di analisi per capire cosa generalizzare, cosa lasciare locale e cosa trasformare in task operativo.

Funzioni del repo

• Metodo portabile: nodi in kb/ che descrivono ricetta metodologica, i tre giganti del metodo (Zettelkasten, pattern Karpathy, ciclo di azione di Norman), struttura di progetto, strato output (ponte), strumenti, fedeltà cognitiva e principi.
• Osservatorio cross-repo: confronto periodico tra i progetti adottanti per rilevare convergenze, drift, duplicazioni, lacune e specificità locali.
• Strumenti comuni: scripts/kb_tools.py come backend portabile per audit strutturale, backlink, copertura README, migrazione, candidati terminologici e segnali generici sui progetti code-based.
• Coda di lavoro metodologica: task in todo/ per valutazioni che possono produrre aggiornamenti del metodo, strumenti comuni o task da aprire nei singoli repository.

Progetti adottanti

Progetto	Ambito
nixos	Configurazione dichiarativa NixOS multi-host
bi	Business intelligence e sincronizzazione dati
economia	Gestione finanziaria, patrimoniale e legale personale
salute	Benessere, pratica, filosofia e salute personale

Tasks aperti

Priorità	Target	Task	Dipende da
Alta	salute	Osservazioni dal pilota salute/quadro/	Uso reale di quadro/ nel tempo
Media	bi	Regress check CLAUDE.md bi	—
Media	economia	Formalizza pattern file-dominio	—
Media	economia	Portabilità skill revisione-tasks	—
Media	multi	Confronto skill audit-kb e commit cross-repo	—
Bassa	nixos	Superficie portabile kb_tools.py: comandi avanzati	—
Bassa	salute	README narrativo di salute: quando è accettabile?	—

I task con contesto operativo vivono in todo/ e vengono rimossi quando completati.

Come collegare un nuovo progetto

1. Crea il symlink: ln -s ../metodo/kb metodo dalla root del progetto.
2. Aggiungi una riga alla tabella dei progetti adottanti.
3. Nel README del progetto, referenzia metodo/metodo-kb.md come nodo centrale del metodo e aggiungi una sezione con i principi specifici del progetto.
4. Aggiorna i path in CLAUDE.md del progetto: kb/metodo-kb.md → metodo/metodo-kb.md (e analogamente per gli altri nodi metodologici).

Nodi

Metodo generale

• metodo-kb — Hub del metodo: ricetta metodologica, ciclo operativo, tipi documentali, regole di revisione
• nodo — Unità atomica della KB: struttura, naming, frontmatter, footer Connessioni
• knowledge-base — KB basata su LLM: artefatto cumulativo, divisione del lavoro umano/LLM
• struttura-progetto — Pilastri e componenti operativi: README, CLAUDE.md, AGENTS.md, log.md, todo, skill e strumenti
• strumenti-kb — Script versionati portabili e profili avanzati per audit, backlink, migrazione, copertura e candidati terminologici
• osservatorio-metodo — Meta-analisi periodica dei progetti adottanti: componenti, strumenti, skill, nodi, salute e task locali
• confronto-progetti-adottanti — Sintesi della situazione attuale dei quattro progetti che adottano il metodo
• fedelta-cognitiva — Verifica della KB oltre il lint: anti-drift, checklist semantica, adattamento al dominio
• design-principles — Principi guida: universali, code-based e specifici di progetto
• zettelkasten — Metodo Zettelkasten: nodi atomici interconnessi, struttura emergente
• pattern-karpathy — Pattern wiki personale mantenuta da LLM: ingest, query, lint e filing back
• ciclo-azione — Modello di Norman come terzo gigante del metodo: sette stadi, due gulf (execution, evaluation), quattro proprietà cardine (visibilità, feedback, mapping, constraint) come criteri di L2
• ponte — Strato output del metodo: L1 macchina, L2 decisione umana, L3 azione nel mondo; risoluzione del conflitto Zettelkasten/Karpathy (la sintesi vive nello strato output, non nei nodi)
• connessione — Strategie di collegamento tra nodi: inline vs footer, motivazioni della scelta

Componenti della ricetta

• agents — Wrapper agent-agnostico: ingresso comune verso README e CLAUDE
• claude — Costituzione operativa per agenti: regole d'azione, vincoli e bootstrap
• readme — Bootstrap del progetto: orientamento, task, indice e accessi cognitivi
• indice — Catalogo statico dei nodi: recupero rapido distinto dalla mappa
• task-aperti — Supervisione corrente del lavoro futuro nel README
• mappa — Modello del dominio: entità, fonti di verità, flussi e nodi
• todo — Dettagli operativi e contesto dei singoli task aperti
• log — Memoria interpretativa: perché decisioni e sessioni contano
• git-history — Storia verificabile dei cambiamenti e dei diff
• skill — Workflow ricorrenti codificati per agenti
• fonte-di-verita — Fonti contro cui verificare ciò che la KB dice