| name | codegraph-context |
| description | Use at the START of any coding session or before touching code in a project. Triggers on: "lavora su X", "modifica X", "aggiungi feature a X", "fix in X", any request that implies working inside a specific project folder. Ensures the CodeGraph index is fresh and loads the 5-layer Cortex briefing. Without this, you are working blind — no impact analysis, no memory, no context.
|
| user-invocable | true |
| argument-hint | percorso o nome del progetto su cui lavorare |
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
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:
- Auto-cattura memorie dalla sessione
- Applica decay al Memory Graph
- 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
