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.
Agent crée automatiquement ce fichier dans le répertoire racine de votre projet en suivant 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 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 :
- 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 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 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.
Génération automatique
Lorsque vous créez un nouveau projet avec 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 :
- 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 automatiquement et l’utilisera dans les conversations futures.
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 :
- Supprimez le fichier
replit.md existant de la racine de votre projet
- Démarrez une nouvelle conversation avec Agent
- Agent générera automatiquement un nouveau fichier
replit.md basé sur votre projet actuel
Bonnes pratiques
Soyez précis et clair
Rédigez des instructions claires et précises qui aident Agent à comprendre exactement ce que vous souhaitez :
## Style de codage
- Utilisez TypeScript pour tous les nouveaux fichiers JavaScript
- Préférez les composants fonctionnels avec des hooks plutôt que les composants de classe
- Utilisez Tailwind CSS pour le style, évitez les styles en ligne
- Incluez toujours 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.
Utilisez des exemples
Les exemples aident Agent à comprendre vos préférences mieux que les descriptions abstraites :
## 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 vos préférences de communication
Indiquez à Agent comment vous préférez recevoir des informations et des mises à jour :
## 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 précisions si les exigences ne sont pas claires
- Fournissez 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 :
## 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 âgés 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
# 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)
## Normes de codage
- Utiliser des composants fonctionnels avec des 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 votre 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
# 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
## Normes 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 d’API
# Directives de développement d'API
## Aperçu du projet
Construction 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
## Normes API
- Utiliser des codes de statut HTTP sémantiques
- Implémenter une validation appropriée des entrées
- Inclure une limitation de 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 :
## 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 :
## Ressources externes
- Système de design : Suivez le système de design Figma sur [lien]
- Documentation API : Consultez nos docs API internes
- Normes de codage : Suivez 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 révision du code avant les releases en 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.
Bonnes pratiques pour l’intégration de la recherche web
Soyez précis sur ce que vous souhaitez qu’Agent recherche :
## 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 technologique
Guidez Agent sur la façon d’appliquer les connaissances externes :
## Directives de recherche externe
- Lors de la suggestion de nouvelles bibliothèques, assurer la compatibilité avec notre stack existante
- Adapter les exemples externes à nos normes 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 qui tire parti des deux :
« Rechercher les dernières techniques d’optimisation des performances de React 18 et les implémenter en suivant les modèles de composants définis dans replit.md »
Cette approche vous donne des solutions qui sont à la fois actuelles et adaptées aux besoins spécifiques de votre projet.
Limitations
Limites de taille et de contenu des fichiers
Bien qu’il n’y ait pas de limite de caractères stricte pour replit.md, les fichiers extrêmement volumineux peuvent ne pas être entièrement traités. Gardez votre replit.md focalisé 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étecte pas automatiquement les fichiers dans les sous-répertoires.
Portée du contexte
replit.md fournit du contexte pour les conversations avec Agent mais ne s’applique pas automatiquement aux autres outils IA.
Étapes suivantes
Prêt à personnaliser Agent pour votre projet ?
- Commencez simplement : Créez un
replit.md de base avec vos préférences clés
- Itérez et améliorez : Mettez à jour votre
replit.md au fur et à mesure que vous travaillez avec Agent
- Partagez les modèles : Utilisez des configurations
replit.md réussies sur des projets similaires
- Surveillez l’efficacité : Prêtez attention à la façon dont Agent suit vos directives et ajustez en conséquence
Apprenez-en davantage sur le travail avec Agent ou explorez d’autres outils IA.
Enterprise : Préconfigurez replit.md dans des modèles personnalisés pour donner à chaque développeur de votre organisation un contexte de départ cohérent. Pour des conseils spécifiques au design, voir configurer un système de design.