Esplora un codice sorgente con Vibe
In questa pagina
Lezione aggiornata il 2 novembre 2026: La modalità Plan integrata non esiste più in Vibe Code; l’esplorazione in sola lettura avviene ora tramite l’agente
asko un agente personalizzato. Fonte: Agents.
Scansione automatica del progetto
Non appena avvii Vibe in una directory, l’agente scansiona automaticamente il tuo progetto. Questo lavoro avviene prima ancora che tu digiti il primo messaggio. L’agente mappa l’albero dei file—struttura delle cartelle, file chiave e file di configurazione—poi verifica lo stato di Git, inclusi il branch attivo, i file modificati, i file non tracciati e l’ultimo commit. Successivamente, identifica il tipo di progetto in base ai file di configurazione presenti (package.json, pyproject.toml, Cargo.toml, ecc.) e legge questi manifest per individuare le dipendenze dichiarate.
Questo contesto viene iniettato nella conversazione immediatamente all’apertura. Il risultato pratico è chiaro: apri Vibe in un repository che non hai mai visto, chiedi “Qual è l’architettura di questo progetto?” e l’agente risponde istantaneamente perché non ha bisogno di recuperare nulla: l’albero dei file e i manifest sono già davanti a lui.
Navigare nel codice
In un progetto sconosciuto, la prima domanda riguarda quasi sempre la struttura generale. Chiedilo semplicemente:
Dammi una panoramica di questo progetto. Quali sono i file principali e come sono organizzati?
Vibe attraversa le directory, apre i file chiave—README, configurazione, punti di ingresso—e ti fornisce un riepilogo. Da lì, puoi cercare con precisione. Per trovare una funzione, una variabile o un pattern nel codice, l’agente si affida a grep e ripgrep in background; sceglie autonomamente lo strumento più efficiente, preferendo ripgrep sui progetti di grandi dimensioni per la velocità. Formula le domande in linguaggio naturale:
Dove è definita la funzione handleAuthentication?
Trova tutti i file che importano il modulo database
Quali endpoint utilizzano il middleware rateLimiter?
Quando sai già quale file ti interessa, indirizza l’attenzione dell’agente usando il prefisso @, supportato dall’autocompletamento:
Spiega il codice in @src/api/routes/auth.ts
Niente ti limita a un singolo riferimento per messaggio, rendendo i confronti diretti molto naturali:
Confronta @src/old/handler.py e @src/new/handler.py, quali sono le differenze?
Contesto Git, letto in tempo reale
Poiché Vibe traccia lo stato del repository durante la sessione, puoi interrogarlo sul tuo lavoro corrente piuttosto che sul codice statico. Chiedi quali file sono cambiati dall’ultimo commit, fai riassumere le modifiche sul branch feature/auth rispetto a main, o individua file non tracciati che dovrebbero andare in .gitignore. In ogni caso, l’agente esegue da solo i comandi necessari—git status, git diff, git log—e presenta i risultati in un formato leggibile, così non devi decodificare output grezzi.
La stessa logica si applica alle dipendenze. Una domanda come “Quali sono le principali dipendenze di questo progetto? Alcune sono obsolete?” porta l’agente a leggere package.json, pyproject.toml o l’equivalente per il tuo ecosistema. E se un server di recupero MCP è configurato, può persino verificare le versioni effettivamente disponibili per rispondere a “Questo progetto sta utilizzando una versione recente di React?”.
Approfondire attraverso la conversazione
Il vero valore di Vibe per l’esplorazione risiede nella natura conversazionale dello scambio: ogni risposta apre la porta alla domanda successiva, più precisa.
> Spiega la struttura della cartella src/services/
< La cartella contiene 5 servizi: auth, email, payment, storage e notification...
> Dettaglia il servizio payment, come gestisce i webhook?
< Il servizio payment utilizza Stripe con un gestore webhook in payment/webhooks.ts...
> Mostrami il codice del gestore webhook
< [Visualizza il contenuto del file]
Questo approccio iterativo è spesso più veloce della ricerca manuale in un editor, proprio nello scenario in cui sei meno attrezzato: quando non conosci ancora la base di codice e quindi non sai cosa cercare.
Esplorare in sicurezza con l’agente ask o un agente in sola lettura
L’audit di codice di terze parti o l’approfondimento di un progetto sensibile solleva una domanda legittima: e se l’agente modificasse qualcosa? Vibe non ha più una modalità Plan integrata. Esistono due soluzioni: l’agente ask, selezionato con Shift+Tab o vibe --agent ask, che ti chiede conferma prima di usare qualsiasi strumento; oppure, meglio ancora, un agente personalizzato in sola lettura (disabled_tools = ["edit", "write_file"], bash impostato su ask), descritto nel corso Advanced Mistral Vibe. Quest’ultimo si comporta come segue:
| L’agente può | L’agente non può |
|---|---|
| Leggere i file | Scrivere o modificare file |
| Cercare nel codice | Eseguire comandi shell |
| Analizzare la struttura del progetto | Creare nuovi file |
Prendi l’abitudine di passare a un agente in sola lettura prima di esaminare qualsiasi codice che non hai scritto tu stesso: mantieni tutto il comfort di esplorazione descritto sopra, con zero rischio di effetti collaterali.
Punti chiave
- Vibe scansiona automaticamente l’albero dei file, lo stato di Git e le dipendenze all’avvio
- Il prefisso @ ti permette di riferirti a file specifici con l’autocompletamento
- Le ricerche nel codice utilizzano grep/ripgrep in background
- L’esplorazione conversazionale ti permette di approfondire progressivamente il codice
- Un agente in sola lettura (o l’agente
ask) garantisce un’esplorazione priva di effetti collaterali