HomeCasa Prompts

Capire una codebase sconosciuta: mappa dell’architettura e guida di onboarding

Trasforma l’albero e i file chiave di un repository in una mappa chiara: architettura, percorso di una richiesta, glossario, zone a rischio e da dove partire per il tuo compito specifico. Pensato per ChatGPT, Claude, Gemini e Microsoft Copilot. Include 4 variabili personalizzabili e puoi copiarlo gratuitamente con un clic.

Intermedio · Testo · In attesa di revisione editoriale

Pensato per:

Prompt

Agisci come ingegnere senior che aiuta una persona appena arrivata a capire un repository che non conosce.

Contesto:
- Progetto e stack: {{progetto}}
- Albero delle cartelle e file chiave (README, configurazione, punto di ingresso, rotte, modelli): {{file}}
- Il mio compito specifico in questo codice: {{compito}}
- La mia esperienza con questo stack: {{esperienza}}

Consegne:
1. Sintesi in 5 righe: cosa fa il sistema, per chi e quali sono i pezzi principali.
2. Mappa dell'architettura: livelli o moduli, responsabilità di ogni cartella importante e come comunicano, con un diagramma Mermaid.
3. Percorso di una richiesta o di un flusso tipico dall'inizio alla fine, citando file e funzioni reali presenti nel materiale che ti ho dato.
4. Glossario dei termini di dominio e di progetto presenti nel codice.
5. Per il mio compito: i file che probabilmente dovrò toccare, in che ordine leggerli e quali test eseguire.
6. Zone a rischio: accoppiamento forte, «magia» del framework, configurazione per ambiente, effetti collaterali nascosti.
7. Dieci domande concrete da fare al team.

Vincoli:
- Basati solo su ciò che ti ho fornito. Se deduci qualcosa senza vederlo, segnalo con [DA VERIFICARE]; se manca un file chiave, dimmi quale e perché ti serve.
- Non inventare nomi di file, funzioni o comandi.
- Adatta il livello di dettaglio alla mia esperienza: {{esperienza}}.
- Se le informazioni non bastano per la mappa, chiedimi prima i file mancanti.

Formato: sezioni numerate, diagramma Mermaid ed elenchi brevi.

Come usarlo

Genera l’albero con tree -L 3 -I node_modules o git ls-files e incolla anche il README, il file di configurazione principale e il punto di ingresso. Se il contesto è ampio, condividi il repository a parti e chiedi la mappa alla fine.

Esempio d'uso

Progetto: API di prenotazioni in NestJS con PostgreSQL · Compito: aggiungere i rimborsi parziali al modulo pagamenti · Esperienza: conosco Node.js ma non NestJS.

Esempio di risultato

Supponendo che l’albero delle cartelle incollato segua la struttura standard di Symfony 6…

1. Sintesi

Negozio online B2C: catalogo, carrello, checkout e ordini. Controller in src/Controller, logica in src/Service, persistenza con Doctrine su MySQL e viste Twig.

2. Mappa dell’architettura

flowchart LR
  R[config/routes] --> C[src/Controller]
  C --> S[src/Service]
  S --> E[src/Entity + Repository]
  E --> DB[(MySQL)]
  C --> T[templates/ Twig]

5. Per il tuo compito: spedizione a peso

Ordine di lettura consigliato:

  1. src/Entity/ShippingMethod.php [VERIFICARE] — come sono modellati i metodi attuali.
  2. Il servizio che calcola il costo di spedizione, probabilmente in src/Service/Shipping/ [VERIFICARE].
  3. src/Entity/Product.php — esiste già un campo peso? Se no, servirà una migrazione Doctrine.
  4. Il template del checkout in templates/checkout/ [VERIFICARE].

Test da eseguire: almeno php bin/phpunit tests/Service.

6. Zone a rischio

  • Listener di eventi Doctrine o del kernel che modificano l’ordine senza comparire nel controller.
  • Configurazione diversa per ambiente in config/packages/{dev,prod}.

7. Domande per il team

  1. Il peso è salvato in grammi o in chili?
  2. Le tariffe a peso cambiano in base al Paese di destinazione?…

Dati chiave

Categoria
Programmazione e sviluppo · Documentazione
Tipo di output
Testo
Livello
Intermedio
Pensato per
ChatGPT, Claude, Gemini e Microsoft Copilot
Verificato in
In attesa di verifica editoriale
Variabili
Progetto e stack, Albero e file chiave, Il mio compito e Esperienza con lo stack
Lingua
Italiano
Prezzo
Gratuito, senza registrazione
Aggiornato
07/11/2026

Domande frequenti

Quanto codice devo incollare?

Parti da albero delle cartelle, README, configurazione e punto di ingresso. Così il modello può chiederti i file specifici che gli servono invece di elaborare tutto il repository.

Posso fidarmi del diagramma?

È un punto di partenza. Verifica le parti segnate con [DA VERIFICARE] nel codice o con il team prima di prendere decisioni di design.

A cosa serve questo prompt?

Trasforma l’albero e i file chiave di un repository in una mappa chiara: architettura, percorso di una richiesta, glossario, zone a rischio e da dove partire per il tuo compito specifico.

Con quali strumenti di IA funziona?

È pensato per ChatGPT, Claude, Gemini e Microsoft Copilot. Non lo abbiamo ancora verificato in questi strumenti, quindi i risultati possono variare da uno all'altro.

Come personalizzo il prompt?

Clicca su «Personalizza» e compila le variabili (Progetto e stack, Albero e file chiave, Il mio compito e Esperienza con lo stack). Il testo si aggiorna all'istante e poi puoi copiarlo con un clic. I valori vengono salvati solo nel tuo browser.

Serve esperienza per usarlo?

È di livello intermedio: conviene conoscere l'argomento per fornire un buon contesto e valutare il risultato con occhio critico.

Questo prompt è gratuito?

Sì. Tutti i prompt di HomeCasa Prompts sono gratuiti, senza registrazione né abbonamento. Puoi usarli anche in progetti professionali.

Posso fidarmi dell'output dell'IA?

Consideralo una bozza di alta qualità: verifica sempre dati, cifre e affermazioni importanti prima di pubblicare o prendere decisioni.

Prompt correlati