> ## 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 de l'Agent, son 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 ; }; L'Agent crée automatiquement ce fichier dans le répertoire racine de votre projet en suivant les meilleures pratiques éprouvées. L'Agent inclut son contenu dans le contexte pour l'aider à comprendre vos préférences, la structure du projet et le style de codage. L'Agent utilisant replit.md pour construire un projet ## Fonctionnement de `replit.md` L'Agent crée d'abord un fichier `replit.md` dans le répertoire racine de votre projet en suivant les meilleures pratiques éprouvées. Ce fichier comprend : * Les informations de base du projet * Les modèles de codage recommandés * Les préférences courantes pour votre type de projet Lorsque l'Agent traite vos requêtes, 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 de codage et votre style préférés * Utiliser vos gestionnaires de packages et dépendances spécifiés L'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 de l'Agent. ## Configuration de `replit.md` ### Génération automatique Lorsque vous créez un nouveau projet avec l'Agent, il génère automatiquement un fichier `replit.md` en suivant les meilleures pratiques éprouvées. Ce fichier apparaît dans le répertoire racine de votre projet et comprend : * Les informations de base du projet * Les modèles de codage recommandés * Les 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. L'Agent le détectera automatiquement et l'utilisera dans les conversations futures. `replit.md` doit être placé dans le répertoire racine de votre projet pour fonctionner correctement. ### Régénération de `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 la racine de votre projet 2. Démarrez une nouvelle conversation avec l'Agent 3. L'Agent génèrera automatiquement un nouveau fichier `replit.md` basé sur votre projet actuel ## Bonnes pratiques ### Être précis et clair Rédigez des instructions claires et précises pour aider l'Agent à comprendre exactement ce que vous voulez : ```markdown theme={null} ## Style de codage - Utiliser TypeScript pour tous les nouveaux fichiers JavaScript - Préférer les composants fonctionnels avec hooks aux composants de classe - Utiliser Tailwind CSS pour le style, éviter les styles en ligne - Toujours inclure les types TypeScript pour les paramètres de fonction et les valeurs de retour ``` Pour un guide plus détaillé sur le formatage des invites, consultez le [guide d'ingénierie des invites d'Anthropic](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/use-xml-tags). ### Utiliser des exemples Les exemples aident l'Agent à mieux comprendre vos préférences 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('Error fetching users:', error); res.status(500).json({ success: false, error: 'Failed to fetch users' }); } }); ```` ### Définir les préférences de communication Indiquez à l'Agent comment vous préférez recevoir les informations et les mises à jour : ```markdown theme={null} ## Style de communication - Avant d'implémenter des changements, expliquez ce que vous allez faire et pourquoi - Décomposez les tâches complexes en étapes claires - Demandez des éclaircissements si les exigences ne sont pas claires - Fournissez de brèves explications pour les décisions techniques ``` ### Spécifier le contexte du projet Aidez l'Agent à comprendre l'objectif et les contraintes de votre projet : ```markdown theme={null} ## Contexte du projet Il s'agit d'une application de médias 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 de 25 à 45 ans Stack technologique : 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 ## Vue d'ensemble du projet Une application web de gestion de 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 ou pnpm) ## Standards de codage - Utiliser des 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 - Expliquez votre approche avant d'apporter des modifications - Fournissez des commentaires de code pour la logique complexe - Posez 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 des clients pour identifier les tendances et les 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 des tableaux Streamlit ## Style de communication - Expliquer les méthodes statistiques et les hypothèses - Fournir un contexte pour les résultats et les 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 ## Vue d'ensemble du projet Développement d'une API RESTful pour un backend d'application mobile. ## Stack technologique - Node.js avec Express.js - MongoDB avec Mongoose - JWT pour l'authentification - Gestionnaire de packages : npm ## Standards API - Utiliser des codes de statut HTTP sémantiques - Implémenter une validation des entrées appropriée - Inclure une 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 ### Guidage dynamique du projet Mettez à jour votre fichier `replit.md` à mesure que votre projet évolue pour fournir un 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 de l'état - Décision d'utiliser Material-UI pour un style cohérent ``` ### Intégration avec des outils externes Référencez la documentation externe et les outils 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 nos docs API internes - 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 d'abord - Utiliser le pipeline CI/CD pour les applications publiées en staging - Exiger une revue de code avant les publications en production ``` ## Combinaison de la recherche web avec `replit.md` L'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 guidage spécifique au projet. ### Bonnes pratiques pour l'intégration de la recherche web **Soyez précis sur ce que vous voulez que l'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é - Consulter les techniques récentes d'optimisation des performances pour notre stack ``` **Guidez l'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, assurer la compatibilité avec notre stack existante - Adapter les exemples externes à 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 requête tirant parti des deux :** "Recherchez les dernières techniques d'optimisation des performances de React 18 et implémentez-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 ### Limites de taille et de contenu du fichier Bien qu'il n'y ait pas de limite stricte de caractères pour `replit.md`, les fichiers très volumineux peuvent ne pas être entièrement traités. Gardez votre `replit.md` ciblé et concis pour de meilleurs résultats. ### Exigence de répertoire racine `replit.md` doit exister dans le répertoire racine de votre projet. L'Agent ne détectera pas automatiquement les fichiers dans les sous-répertoires. ### Portée du contexte `replit.md` fournit un contexte pour les conversations avec l'Agent mais ne s'applique pas automatiquement aux autres outils d'IA. ## Prochaines étapes Prêt à personnaliser l'Agent pour votre projet ? 1. **Commencez simplement** : Créez un `replit.md` de base 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 l'Agent 3. **Partagez des modèles** : Utilisez des configurations `replit.md` réussies dans des projets similaires 4. **Surveillez l'efficacité** : Faites attention à la façon dont l'Agent suit vos directives et ajustez en conséquence Apprenez-en plus sur le [travail avec l'Agent](/references/agent/overview) ou explorez d'autres [outils d'IA](/fr/build/welcome). **Entreprise** : Pré-configurez `replit.md` dans des [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 [configuration d'un système de design](/teams/custom-design-system).