codegraph-context skill

CodeGraph Context — Carica il cervello prima di lavorare

Perché questa skill esiste

Lavorare su codice senza il grafo CodeGraph è come operare bendati. Lavorare senza Memory Graph è come avere amnesia tra una sessione e l'altra.

Con il Cortex attivo posso:

• Sapere esattamente quali funzioni dipendono da quella che sto toccando
• Ricordare bug, pattern, e decisioni da sessioni precedenti
• Vedere cosa è successo nelle altre sessioni Claude Code
• Fare impact analysis prima di modificare

Senza il Cortex: indovino. Con il Cortex: so.

---

Il Protocollo (eseguire sempre in ordine)

Step 1 — Registra inizio sessione

session_start({
  sessionName: "MASTER_Fullstack",
  project: "{nome progetto corrente}",
  workspacePath: "{percorso workspace}",
  repo: "skillbrain"
})

Step 2 — Carica il Cortex (5-layer briefing)

bash "/Users/dan/Desktop/progetti-web/MASTER_Fullstack session/.opencode/scripts/load_project_context.sh"

Questo genera:

• Layer 1: Identity — stack versions (Next.js, TS, Payload)
• Layer 2: Event Log — ultimi commit, file modificati, branch
• Layer 3: Cross-Session — cosa è successo nelle altre sessioni
• Layer 4: Project Status — Memory Graph stats, contradictions
• Layer 5: Knowledge Synthesis — top 5 memorie per confidence

Step 3 — Identifica e indicizza il progetto target

node packages/codegraph/dist/cli.js list

Repo già indicizzato? → Verifica freshness:

node packages/codegraph/dist/cli.js status /percorso/progetto

Repo NON indicizzato? → Indicizza:

node packages/codegraph/dist/cli.js analyze /percorso/progetto
# o per non-git:
node packages/codegraph/dist/cli.js analyze /percorso --skip-git

Step 4 — Carica contesto CodeGraph

codegraph_query(
  query: "main entry point architecture overview",
  repo: "nome-repo",
  limit: 5
)

Step 5 — Carica memorie rilevanti per il task

memory_load({
  project: "{nome progetto}",
  activeSkills: ["next-best-practices", "systematic-debugging", ...],
  limit: 15,
  repo: "skillbrain"
})

Se il task ha un focus specifico, aggiungi una ricerca mirata:

memory_search({
  query: "{descrizione del task}",
  limit: 5,
  repo: "skillbrain"
})

Step 6 — Controlla history cross-session

session_history({
  limit: 3,
  repo: "skillbrain"
})

Step 7 — Conferma e procedi

✅ Cortex caricato per [nome-repo]
   📊 NNN nodi | NNN relazioni | NN flussi
   🧠 NN memorie caricate (top confidence: N)
   📋 Ultime N sessioni: [riassunto]
   🕐 Indice aggiornato al: [data]

Pronto a lavorare con piena consapevolezza.

---

Quando RE-indicizzare durante il lavoro

Situazione	Azione
Hai aggiunto nuovi file	Re-indicizza
Hai spostato/rinominato file	Re-indicizza
Hai modificato molte funzioni (5+)	Re-indicizza
L'impact analysis dà risultati strani	Re-indicizza
Hai fatto un refactor strutturale	Re-indicizza
Stai modificando solo 1-2 funzioni	Non serve

---

A fine sessione

OBBLIGATORIO: Invoca post-session-review che:

1. Auto-cattura memorie dalla sessione
2. Applica decay al Memory Graph
3. Registra la fine sessione con session_end

---

Integrazione con altre skills

• Prima di systematic-debugging → carica il grafo per tracciare il root cause
• Prima di writing-plans → carica il grafo per un piano accurato
• Durante subagent-driven-development → ogni subagent deve avere il nome del repo
• Prima di qualsiasi refactoring → usa codegraph_impact per il blast radius