> ## Documentation Index > Fetch the complete documentation index at: https://docs.replit.com/llms.txt > Use this file to discover all available pages before exploring further. # replit.md > Apprenez à utiliser replit.md pour personnaliser le comportement d'Agent, le style de codage et le contexte du projet. export const YouTubeEmbed = ({videoId, title = "YouTube video", startAt}) => { if (!videoId) { return null; } let url = "https://www.youtube.com/embed/" + videoId; if (startAt) { url = url + "?start=" + startAt; } return ; }; Agent crée automatiquement ce fichier dans le répertoire racine de votre projet en utilisant les meilleures pratiques éprouvées. Agent inclut son contenu dans le contexte pour l'aider à comprendre vos préférences, la structure de votre projet et votre style de codage. Agent utilisant replit.md pour construire un projet ## Fonctionnement de `replit.md` Agent crée d'abord un fichier `replit.md` dans le répertoire racine de votre projet en utilisant les meilleures pratiques éprouvées. Ce fichier inclut : * Informations de base sur le projet * Modèles de codage recommandés * Préférences courantes pour votre type de projet Lorsqu'Agent traite vos demandes, il lit automatiquement votre fichier `replit.md` et utilise son contenu pour : * Comprendre l'architecture et les conventions de votre projet * Suivre vos modèles et styles de codage préférés * Utiliser vos gestionnaires de packages et dépendances spécifiés Agent peut également mettre à jour votre fichier `replit.md` au fur et à mesure qu'il en apprend davantage sur votre projet et apporte des modifications à votre application. Vous pouvez modifier le fichier `replit.md` pour personnaliser le comportement d'Agent. ## Configurer `replit.md` ### Génération automatique Lorsque vous créez un nouveau projet avec Agent, il génère automatiquement un fichier `replit.md` en utilisant les meilleures pratiques éprouvées. Ce fichier apparaît dans le répertoire racine de votre projet et inclut : * Informations de base sur le projet * Modèles de codage recommandés * Préférences courantes pour votre type de projet ### Création manuelle Vous pouvez créer votre propre fichier `replit.md` en ajoutant un nouveau fichier nommé `replit.md` dans le répertoire racine de votre projet. Agent le détectera et l'utilisera automatiquement dans les futures conversations. `replit.md` doit être situé dans le répertoire racine de votre projet pour fonctionner correctement. ### Régénérer `replit.md` Si votre fichier `replit.md` est corrompu ou si vous souhaitez repartir de zéro : 1. Supprimez le fichier `replit.md` existant de votre racine de projet 2. Démarrez une nouvelle conversation avec Agent 3. Agent générera automatiquement un nouveau fichier `replit.md` basé sur votre projet actuel ## Meilleures pratiques ### Soyez précis et clair Rédigez des instructions claires et précises qui aident Agent à comprendre exactement ce que vous souhaitez : ```markdown theme={null} ## Style de codage - Utiliser TypeScript pour tous les nouveaux fichiers JavaScript - Préférer les composants fonctionnels avec hooks plutôt que les composants de classe - Utiliser Tailwind CSS pour le style, éviter les styles en ligne - Toujours inclure les types TypeScript pour les paramètres de fonctions et les valeurs de retour ``` Pour un guide plus détaillé sur le formatage des prompts, consultez le [guide d'ingénierie des prompts Anthropic](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/use-xml-tags). ### Utilisez des exemples Les exemples aident Agent à comprendre vos préférences mieux que les descriptions abstraites : ````markdown theme={null} ## Gestion des erreurs API Lors de la création de points de terminaison API, utilisez toujours ce modèle de gestion des erreurs : ```javascript app.get('/api/users', async (req, res) => { try { const users = await getUsersFromDatabase(); res.json({ success: true, data: users }); } catch (error) { console.error('Erreur lors de la récupération des utilisateurs :', error); res.status(500).json({ success: false, error: 'Échec de la récupération des utilisateurs' }); } }); ```` ### Définissez les préférences de communication Dites à Agent comment vous préférez recevoir les informations et les mises à jour : ```markdown theme={null} ## Style de communication - Avant d'implémenter des modifications, expliquer ce que vous allez faire et pourquoi - Décomposer les tâches complexes en étapes claires - Demander des clarifications si les exigences sont floues - Fournir de brèves explications pour les décisions techniques ``` ### Précisez le contexte du projet Aidez Agent à comprendre l'objectif et les contraintes de votre projet : ```markdown theme={null} ## Contexte du projet Il s'agit d'une application de réseaux sociaux pour les amateurs de livres où les utilisateurs peuvent : - Créer des listes de lecture et partager des recommandations de livres - Suivre d'autres lecteurs et voir leurs mises à jour - Évaluer et critiquer les livres qu'ils ont lus Public cible : Lecteurs occasionnels âgés de 25 à 45 ans Pile technique : Frontend React, backend Node.js, base de données PostgreSQL ``` ## Exemples de configurations `replit.md` ### Projet d'application web ```markdown theme={null} # Directives du projet MyApp ## Aperçu du projet Une application web de gestion des tâches construite avec React et Express.js. ## Préférences technologiques - Frontend : React avec TypeScript, Tailwind CSS - Backend : Express.js avec TypeScript - Base de données : Neon PostgreSQL avec Drizzle ORM - Gestionnaire de packages : npm (pas yarn ni pnpm) ## Standards de codage - Utiliser les composants fonctionnels avec hooks - Implémenter des limites d'erreur appropriées - Suivre les conventions REST API pour les points de terminaison - Utiliser des noms de variables et de fonctions descriptifs ## Style de communication - Expliquer l'approche avant d'apporter des modifications - Fournir des commentaires de code pour la logique complexe - Poser des questions si les exigences sont ambiguës ``` ### Projet d'analyse de données ```markdown theme={null} # Directives du projet d'analyse de données ## Contexte du projet Analyse des données de comportement client pour identifier les tendances et insights. ## Préférences technologiques - Python avec Streamlit pour les applications web interactives - pandas, numpy et matplotlib pour l'analyse de données ## Standards d'analyse - Inclure une documentation claire pour toutes les étapes d'analyse - Créer des visualisations interactives avec les composants Streamlit - Valider la qualité des données avant l'analyse - Exporter les résultats au format CSV et les afficher dans les tableaux Streamlit ## Style de communication - Expliquer les méthodes statistiques et les hypothèses - Fournir du contexte pour les conclusions et recommandations - Utiliser un langage clair et non technique pour les insights métier - Créer des tableaux de bord interactifs pour les présentations aux parties prenantes ``` ### Projet de développement API ```markdown theme={null} # Directives de développement API ## Aperçu du projet Construction d'une API RESTful pour un backend d'application mobile. ## Pile technologique - Node.js avec Express.js - MongoDB avec Mongoose - JWT pour l'authentification - Gestionnaire de packages : npm ## Standards API - Utiliser les codes d'état HTTP sémantiques - Implémenter une validation appropriée des entrées - Inclure la limitation du débit sur les points de terminaison publics - Suivre la spécification OpenAPI pour la documentation ## Exigences de sécurité - Valider toutes les entrées utilisateur - Utiliser des variables d'environnement pour les données sensibles - Implémenter des politiques CORS appropriées - Inclure la journalisation des requêtes pour le débogage ## Approche de test - Écrire des tests unitaires pour tous les points de terminaison - Inclure des tests d'intégration pour les flux critiques - Utiliser Jest comme framework de test ``` ## Utilisation avancée ### Guidance dynamique du projet Mettez à jour votre fichier `replit.md` au fur et à mesure que votre projet évolue pour fournir le contexte actuel : ```markdown theme={null} ## Phase de développement actuelle L'équipe se concentre actuellement sur l'implémentation de l'authentification des utilisateurs. Fonctionnalités prioritaires : 1. Inscription et connexion des utilisateurs 2. Fonctionnalité de réinitialisation du mot de passe 3. Vérification par e-mail ## Décisions récentes - Passage de l'authentification locale à OAuth avec Google - Ajout de Redux pour la gestion d'état - Décision d'utiliser Material-UI pour un style cohérent ``` ### Intégration avec des outils externes Référencez la documentation et les outils externes dans votre `replit.md` : ```markdown theme={null} ## Ressources externes - Système de design : Suivre le système de design Figma à [lien] - Documentation API : Référencer notre documentation API interne - Standards de codage : Suivre le guide de style de l'équipe dans notre wiki ## Processus de déploiement - Tester les modifications dans l'environnement de développement en premier - Utiliser le pipeline CI/CD pour les applications publiées en staging - Exiger une revue de code avant les versions de production ``` ## Combiner la recherche web avec `replit.md` Agent peut effectuer des recherches web pour trouver des informations actuelles, des bibliothèques et des solutions. Combiné avec votre fichier `replit.md`, vous bénéficiez à la fois de connaissances à jour et de guidance spécifique au projet. ### Meilleures pratiques pour l'intégration de la recherche web **Soyez précis sur ce que vous souhaitez qu'Agent recherche :** ```markdown theme={null} ## Préférences de recherche - Toujours vérifier les dernières versions des dépendances avant de suggérer des mises à jour - Rechercher les meilleures pratiques actuelles pour les implémentations de sécurité - Chercher des techniques récentes d'optimisation des performances pour notre pile technologique ``` **Guidez Agent sur la façon d'appliquer les connaissances externes :** ```markdown theme={null} ## Directives de recherche externe - Lors de la suggestion de nouvelles bibliothèques, s'assurer de la compatibilité avec notre pile existante - Adapter les exemples externes pour correspondre à nos standards de codage et à la structure du projet - Vérifier que les solutions suggérées fonctionnent avec notre environnement de publication ``` **Exemple de demande qui tire parti des deux :** « Recherche les dernières techniques d'optimisation des performances React 18 et implémente-les en suivant les modèles de composants définis dans `replit.md` » Cette approche vous donne des solutions à la fois actuelles et adaptées aux besoins spécifiques de votre projet. ## Limitations ### Taille et limites de contenu du fichier Bien qu'il n'y ait pas de limite stricte en caractères pour `replit.md`, les fichiers extrêmement volumineux peuvent ne pas être entièrement traités. Gardez votre `replit.md` ciblé et concis pour de meilleurs résultats. ### Exigence du répertoire racine `replit.md` doit exister dans le répertoire racine de votre projet. Agent ne détectera pas automatiquement les fichiers dans les sous-répertoires. ### Portée du contexte `replit.md` fournit du contexte pour les conversations Agent mais ne s'applique pas automatiquement aux autres outils IA. ## Étapes suivantes Prêt à personnaliser Agent pour votre projet ? 1. **Commencez simplement** : Créez un `replit.md` basique avec vos préférences clés 2. **Itérez et améliorez** : Mettez à jour votre `replit.md` au fur et à mesure que vous travaillez avec Agent 3. **Partagez les modèles** : Réutilisez des configurations `replit.md` réussies dans des projets similaires 4. **Surveillez l'efficacité** : Faites attention à la façon dont Agent suit vos directives et ajustez en conséquence En savoir plus sur [l'utilisation d'Agent](/core-concepts/agent) ou explorer d'autres [outils IA](/fr/build/welcome). **Entreprise** : Préconfigurez `replit.md` dans les [modèles personnalisés](/teams/custom-templates) pour donner à chaque développeur de votre organisation un contexte de départ cohérent. Pour des conseils spécifiques au design, consultez [la configuration d'un système de design](/teams/custom-design-system).