Comprendre une base de code inconnue : carte d’architecture et guide d’intégration

Transformez l’arborescence et les fichiers clés d’un dépôt en carte claire : architecture, parcours d’une requête, glossaire, zones à risque et par où commencer pour votre tâche. Conçu pour ChatGPT, Claude, Gemini et Microsoft Copilot. Il comprend 4 variables personnalisables et vous pouvez le copier gratuitement en un clic.

Intermédiaire · Texte · En attente de relecture éditoriale

Prompt

Agis comme ingénieur senior qui aide une personne nouvelle à comprendre un dépôt qu'elle ne connaît pas.

Contexte :
- Projet et stack : {{projet}}
- Arborescence et fichiers clés (README, configuration, point d'entrée, routes, modèles) : {{fichiers}}
- Ma tâche précise dans ce code : {{tache}}
- Mon expérience avec cette stack : {{experience}}

Livrables :
1. Un résumé en 5 lignes : ce que fait le système, pour qui, et ses briques principales.
2. Une carte d'architecture : couches ou modules, rôle de chaque dossier important et façon dont ils communiquent, avec un diagramme Mermaid.
3. Le parcours d'une requête ou d'un flux typique de bout en bout, en citant des fichiers et fonctions réels présents dans ce que je t'ai fourni.
4. Un glossaire des termes métier et propres au projet trouvés dans le code.
5. Pour ma tâche : les fichiers que je devrai sans doute modifier, dans quel ordre les lire et quels tests lancer.
6. Les zones à risque : couplage fort, « magie » du framework, configuration par environnement, effets de bord cachés.
7. Dix questions concrètes à poser à l'équipe.

Contraintes :
- Appuie-toi uniquement sur ce que je t'ai fourni. Si tu déduis quelque chose sans le voir, indique [À VÉRIFIER] ; s'il manque un fichier clé, dis-moi lequel et pourquoi.
- N'invente ni noms de fichiers, ni fonctions, ni commandes.
- Adapte le niveau de détail à mon expérience : {{experience}}.
- Si les informations ne suffisent pas, demande-moi d'abord les fichiers manquants.

Format : sections numérotées, diagramme Mermaid et listes courtes.

Comment l'utiliser

Générez l’arborescence avec tree -L 3 -I node_modules ou git ls-files, puis collez aussi le README, le fichier de configuration principal et le point d’entrée. Si le contexte est volumineux, partagez le dépôt en plusieurs fois et demandez la carte à la fin.

Exemple d'utilisation

Projet : API de réservation NestJS avec PostgreSQL · Tâche : ajouter les remboursements partiels au module de paiement · Expérience : je connais Node.js mais pas NestJS.

Exemple de résultat

En supposant que l’arborescence collée suit la structure standard de Symfony 6…

1. Synthèse

Boutique en ligne B2C : catalogue, panier, tunnel de commande et commandes. Contrôleurs dans src/Controller, logique dans src/Service, persistance via Doctrine sur MySQL et vues Twig.

2. Carte de l’architecture

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. Pour votre tâche : livraison au poids

Ordre de lecture conseillé :

  1. src/Entity/ShippingMethod.php [À VÉRIFIER] — comment les modes actuels sont modélisés.
  2. Le service qui calcule les frais de port, sans doute dans src/Service/Shipping/ [À VÉRIFIER].
  3. src/Entity/Product.php — un champ poids existe-t-il ? Sinon, il faudra une migration Doctrine.
  4. Le template du tunnel dans templates/checkout/ [À VÉRIFIER].

Tests à lancer : au minimum php bin/phpunit tests/Service.

6. Zones à risque

  • Listeners d’événements Doctrine ou du kernel qui modifient la commande sans apparaître dans le contrôleur.
  • Configuration propre à chaque environnement dans config/packages/{dev,prod}.

7. Questions pour l’équipe

  1. Le poids est-il stocké en grammes ou en kilos ?
  2. Les tarifs au poids varient-ils selon le pays de destination ?…

Informations clés

Catégorie
Programmation et développement · Documentation
Type de résultat
Texte
Niveau
Intermédiaire
Conçu pour
ChatGPT, Claude, Gemini et Microsoft Copilot
Vérifié sur
En attente de vérification éditoriale
Variables
Projet et stack, Arborescence et fichiers clés, Ma tâche et Expérience avec la stack
Langue
Français
Prix
Gratuit, sans inscription
Mis à jour
07/11/2026

Questions fréquentes

Quelle quantité de code dois-je coller ?

Commencez par l’arborescence, le README, la configuration et le point d’entrée. Le modèle pourra ensuite vous demander les fichiers précis dont il a besoin au lieu de tout traiter.

Puis-je me fier au diagramme ?

C’est un point de départ. Vérifiez les éléments marqués [À VÉRIFIER] dans le code ou auprès de l’équipe avant toute décision de conception.

À quoi sert ce prompt ?

Transformez l’arborescence et les fichiers clés d’un dépôt en carte claire : architecture, parcours d’une requête, glossaire, zones à risque et par où commencer pour votre tâche.

Avec quels outils d'IA fonctionne-t-il ?

Il est conçu pour ChatGPT, Claude, Gemini et Microsoft Copilot. Nous ne l'avons pas encore vérifié sur ces outils ; les résultats peuvent donc varier de l'un à l'autre.

Comment personnaliser le prompt ?

Cliquez sur « Personnaliser » et remplissez les variables (Projet et stack, Arborescence et fichiers clés, Ma tâche et Expérience avec la stack). Le texte se met à jour instantanément et vous pouvez ensuite le copier en un clic. Les valeurs sont stockées uniquement dans votre navigateur.

Faut-il de l'expérience pour l'utiliser ?

Il est de niveau intermédiaire : il vaut mieux connaître le sujet pour fournir un bon contexte et relire le résultat d'un œil critique.

Ce prompt est-il gratuit ?

Oui. Tous les prompts de HomeCasa Prompts sont gratuits, sans inscription ni abonnement. Vous pouvez aussi les utiliser dans des projets professionnels.

Puis-je me fier au résultat de l'IA ?

Considérez-le comme un brouillon de qualité : vérifiez toujours les données, les chiffres et les affirmations importantes avant de publier ou de prendre des décisions.

Prompts similaires