---
aliases: ["KERNEL"]
type: servizio
---

# KERNEL — Metodologia knowledge graph C:\PYTHON

Regole del sistema di conoscenza locale.
Documento di riferimento per Bill (distillatore) e Frank (manutentore notturno).

---

## Principio fondamentale

**Non esiste una struttura parallela.** I nodi del grafo Obsidian SONO i file `CLAUDE.md` esistenti, arricchiti con frontmatter e wikilink. Nessun file aggiuntivo creato apposta per Obsidian.

---

## Struttura di un nodo CLAUDE.md

```markdown
---
aliases: ["Nome leggibile"]   ← nome visualizzato in Obsidian
type: coordinator|progetto|modulo
status: active|new|legacy|completed  ← opzionale
parent: "Nome parent"         ← opzionale, per moduli
---

## Grafo / Moduli          ← sezione con wikilink verso altri CLAUDE.md
[[path/CLAUDE|Alias]]
```

---

## Tassonomia dei tipi

| Tipo | Cosa rappresenta | Esempio |
|---|---|---|
| `coordinator` | Sessione Bill, root C:\PYTHON | `CLAUDE.md` root |
| `progetto` | Sistema software con lifecycle proprio | Frank, MyICR Suite |
| `modulo` | Sottocomponente stabile di un progetto | Linker, MediaTrack |

---

## Convenzioni wikilink

- **Tra CLAUDE.md** → `[[path/relativo/CLAUDE|Alias]]` — crea archi nel grafo
- **File esterni** → `[testo](file:///C:/path/al/file)` — apre in VSCode al click
- **Mai** path relativi con `../../` — non funzionano in Obsidian

---

## Gerarchia CLAUDE.md

Claude Code carica i CLAUDE.md in cascata dalla root verso il basso:

```
~/.claude/CLAUDE.md                              ← globale
C:\PYTHON\CLAUDE.md                              ← coordinator
C:\PYTHON\MyICR_Suite\CLAUDE.md                  ← progetto (spine)
C:\PYTHON\MyICR_Suite\app\modules\linker\CLAUDE.md  ← modulo
```

**Regola:** ogni livello contiene SOLO quello che il livello inferiore non può derivare dal superiore.

---

## Ciclo di vita

```
idea → cantiere → modulo (in prod) → legacy (dismesso)
```

Quando un modulo va in prod: creare `CLAUDE.md` nella sua directory, aggiungere alias e wikilink verso il parent.

---

## Responsabilità a regime

**Bill (distillatore)** — a fine sessione quando cambia qualcosa di rilevante:
- Aggiunge frontmatter/alias a nuovi CLAUDE.md
- Aggiunge wikilink verso nuovi nodi
- Aggiorna status nel frontmatter

**Frank (manutentore notturno)** — job da implementare:
- Verifica link `file:///` non più validi
- Segnala CLAUDE.md senza alias (nodi anonimi nel grafo)
- Rigenera `graph-map.md` locale