Da zero: marketplace e wiki condivisa

1. Marketplace — registra e installa i plugin. Nel terminale, dentro Claude Code:

   # registra il marketplace Sistec (una volta)
   /plugin marketplace add marc04AM/sistec-plugin-marketplace
   
   # installa i plugin che servono — es. hmi-developer
   /plugin install hmi-developer@sistec-plugin-marketplace
   
   # verifica
   /plugin list --enabled

   Le skill del plugin diventano disponibili subito, in ogni progetto, senza altra configurazione. Repository: github.com/marc04AM/sistec-plugin-marketplace.
2. Wiki — sincronizza la cartella e costruisci l'indice di ricerca. Apri la libreria SistecAM-AIStack (da Teams o da browser) → Sincronizza. OneDrive crea una copia locale che si aggiorna da sola. Il percorso locale dipende dall'account Windows — di solito C:\Users\<utente>\Sistec srl\Sistec AM-AI Stack - sistec-wiki. Annotalo: serve ai passi successivi.

   Le pagine ora ci sono, ma non sono ancora interrogabili: la wiki si consulta con qmd (ricerca per parole chiave + semantica), e l'indice non arriva da SharePoint — si costruisce su ogni PC. Richiede Node.js:

   # installa qmd (una volta per PC)
   npm i -g @tobilu/qmd
   
   # registra la wiki e costruisci l'indice — usa IL TUO percorso del passo 2
   cd "C:\Users\<utente>\Sistec srl\Sistec AM-AI Stack - sistec-wiki"
   qmd collection add wiki/ --name wiki
   qmd update && qmd embed
   
   # verifica: deve restituire dei percorsi di file
   qmd search "sistec" -n 5 --files

   Il primo embed scarica ~1,6 GB di modelli in ~\.cache\qmd\models\: su rete aziendale mettici qualche minuto. Da qui in poi i comandi sono nudi — nessuna variabile d'ambiente da impostare.
3. settings.json — autorizza la lettura della wiki. Apri (o crea) C:\Users\<utente>\.claude\settings.json e aggiungi la riga allow con il percorso locale annotato al passo 2:

   {
     "permissions": {
       "allow": [
         "Read(C:\\Users\\<utente>\\Sistec srl\\Sistec AM-AI Stack - sistec-wiki\\**)",
         "Bash(qmd:*)"
       ]
     }
   }

   Senza la prima riga, Claude Code chiede conferma a ogni lettura della wiki; senza la seconda, a ogni ricerca. Con l'allow, una volta e basta. File personale, non di progetto.
4. CLAUDE.md — due righe di rimando alla wiki. Apri (o crea) C:\Users\<utente>\.claude\CLAUDE.md e aggiungi:

   In "C:\Users\<utente>\Sistec srl\Sistec AM-AI Stack - sistec-wiki" è presente una LLM wiki aziendale
   (fatti, decisioni, documenti). Consultala seguendo le regole nel suo CLAUDE.md per ottenere contesto sui
   progetti a cui stai lavorando, prima di chiedere all'operatore.

   Da qui in avanti Claude Code consulta la wiki da solo, senza doverlo ricordare a ogni sessione.
5. Progetto — apri Claude Code e inizia.

   # in una cartella di progetto qualsiasi
   cd D:\dev\tuo-progetto
   claude

   Skill del marketplace e wiki sono già attive: si lavora subito, senza altra configurazione per-repo.

openspec è l'eccezione alla regola «niente skill nel repo» (proposta §3.1): opera su file che devono vivere dentro il repository (openspec/, openspec/changes/), quindi va installato per progetto, non a livello utente. Usalo per le modifiche di maggiore portata (proposta §5.2): prima di implementare produce proposal.md, specs/, design.md, tasks.md.

1. Installa il CLI (una volta per PC, richiede Node.js):

   npm i -g @fission-ai/openspec@latest

2. Inizializza nel progetto — da rifare per ogni repo dove serve:

   cd D:\dev\tuo-progetto
   openspec init

   Genera skill e comandi sotto .claude/ del repo (openspec-propose, openspec-apply-change, openspec-archive-change, ecc.) — vanno committati, non messi in .gitignore.
3. Usa il ciclo dentro Claude Code:

   # crea proposta + design + task + delta-spec
   /opsx:propose
   
   # dopo revisione — implementa contro la checklist
   /opsx:apply
   
   # fonde i delta nelle spec
   /opsx:sync
   
   # archivia il change completato
   /opsx:archive

Riferimenti: openspec.dev · github.com/Fission-AI/OpenSpec.

graphify è l'altra eccezione alla regola «niente skill nel repo» (proposta §3.1): la skill sta a livello utente, ma la mappa che produce deve vivere dentro il repository (graphify-out/), perché è specifica di quel codice. Trasforma il repo in un knowledge graph persistente: Claude Code si orienta interrogando la mappa (graphify query) invece di leggere ogni file, e la rigenera quando il codice cambia.

1. Installa il CLI (una volta per PC, richiede Python):

   uv tool install --upgrade graphifyy

   In alternativa pip install graphifyy. Per l'estrazione semantica graphify usa la sessione Claude Code stessa — nessuna chiave API richiesta. Opzionale: con GEMINI_API_KEY l'estrazione diventa più economica (vedi la skill).
2. Costruisci la mappa del progetto — dentro Claude Code, nella root del repo:

   # prima volta su un progetto: estrazione completa
   /graphify .

   Genera graphify-out/ con tre output: graph.html (grafico interattivo, si apre nel browser), GRAPH_REPORT.md (report con god-nodes e domande suggerite), graph.json (dati grezzi). La cartella va committata in git, non ignorata.
3. Tienila aggiornata — dopo modifiche al codice:

   graphify update .

   Re-estrae solo i file nuovi o cambiati: rapido, si lancia a inizio sessione o dopo un refactoring.
4. Usa la mappa — in ogni sessione sul repo:

   # risposte con contesto dal grafo (BFS)
   /graphify query "come funziona l'autenticazione?"
   
   # percorso più breve tra due concetti
   /graphify path "AuthModule" "Database"
   
   # spiegazione in linguaggio semplice di un nodo
   /graphify explain "SwinTransformer"

Riferimenti: graphifylabs.ai · github.com/safishamsi/graphify.