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é :
src/Entity/ShippingMethod.php[À VÉRIFIER] — comment les modes actuels sont modélisés.- Le service qui calcule les frais de port, sans doute dans
src/Service/Shipping/[À VÉRIFIER]. src/Entity/Product.php— un champ poids existe-t-il ? Sinon, il faudra une migration Doctrine.- 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
- Le poids est-il stocké en grammes ou en kilos ?
- 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.