Passer au contenu principal

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 utilisant replit.md pour construire un projet

Comment fonctionne replit.md

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.

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 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 :
  1. Supprimez le fichier replit.md existant de la racine de votre 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

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 ?
  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 Agent
  3. Partagez les modèles : Utilisez des configurations replit.md réussies sur des projets similaires
  4. 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.