Idea principale

Graphify, uno strumento che trasforma un repository di codice in un grafo della conoscenza, concatena due fasi: una costruzione, in cui un'IA legge ogni file per dedurne gli elementi e le loro relazioni, e poi un'esplorazione — suddivisione in gruppi, mappa interattiva, report, ricerca di percorsi. La seconda fase non legge i file: legge un grafo nel formato standard della libreria NetworkX, e non controlla da dove arrivi.

Questa indifferenza alla provenienza divide lo strumento in due parti separabili. Si può tenere l'esplorazione e sostituire la costruzione con qualsiasi produttore dello stesso formato: uno script di 160 righe che legge i collegamenti interni di un wiki Obsidian basta ad alimentare tutta la parte a valle, senza chiave API.

Il punto di inserimento non è scelto a caso: è il formato di scambio tra le fasi, ed è proprio lì che la fase più costosa consegna il suo risultato.

Perché è importante

Offre un modo di leggere uno strumento prima di adottarlo o scartarlo: cercare il formato che circola tra le sue fasi. Uno strumento pensato per un altro uso diventa riutilizzabile non appena si sa produrre, per un'altra strada, ciò che produceva la sua fase a monte.

Sposta anche la questione del costo. Ciò che si paga in uno strumento del genere non è lo strumento intero, è la fase che non si sa sostituire.

Sfumature e limiti

Un formato accettato non è un formato capito. Lo strumento continua ad aspettarsi ciò che produceva la sua fase d'origine: su delle note segnala 12 884 avvisi perché i collegamenti non hanno un file sorgente, una nozione che ha senso solo per il codice. L'uso alternativo funziona, ma accanto al contratto implicito dello strumento, e un aggiornamento può romperlo senza preavviso.

Domande aperte

• Una fase a valle che non è mai stata testata su un grafo venuto da altrove produce risultati sbagliati senza segnalarlo, o solo degli avvisi?