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.
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.
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 :
- Supprimez le fichier
replit.md existant de la racine de votre projet
- Démarrez une nouvelle conversation avec l’Agent
- 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 :
## 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.
Utiliser des exemples
Les exemples aident l’Agent à mieux comprendre vos préférences 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('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 :
## 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 :
## 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
# 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
# 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
# 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 :
## 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 :
## 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 :
## 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 :
## 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 ?
- 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 l’Agent
- Partagez des modèles : Utilisez des configurations
replit.md réussies dans des projets similaires
- 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 ou explorez d’autres outils d’IA.
Entreprise : 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, consultez configuration d’un système de design.