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.
Prise en main
Replit est un environnement de développement cloud capable d’écrire et d’exécuter n’importe quel framework ou pile technologique. Pour créer un modèle personnalisé, deux approches sont recommandées :- Importer depuis un fournisseur Git — Importez votre pile de démarrage existante (ou une correspondant à vos préférences) depuis GitHub, GitLab ou Bitbucket.
- Forker le modèle vide — Forkez le modèle vide pour partir de zéro avec un environnement de développement entièrement vide.
Les modèles personnalisés sont disponibles exclusivement sur le plan Enterprise. Seuls les administrateurs d’organisation peuvent épingler et gérer les modèles.
Comment fonctionnent les modèles personnalisés
Un modèle personnalisé est une Replit App standard dans votre organisation qui a été épinglée à la zone de saisie d’Agent. Lorsqu’un builder le sélectionne :- Agent crée une nouvelle application en forkant le modèle (tous les fichiers sont copiés)
- Agent passe la phase de planification et va directement en mode construction
- Le fichier
custom_instruction/instructions.mddu modèle est injecté dans le contexte d’Agent - Les skills personnalisés de
.agents/skills/sont découverts et rendus disponibles - Le fichier
replit.mdfournit le contexte de projet continu
Structure des fichiers du modèle
Voici la structure recommandée pour un modèle personnalisé :Configurer un modèle personnalisé
Créer l’application de base
Créez une nouvelle Replit App dans votre organisation. Configurez le projet avec tous les fichiers, dépendances et configuration dont vos builders ont besoin comme point de départ. Cela inclut :- L’échafaudage du code source (composants, utilitaires, fichiers de configuration)
- Les dépendances pré-installées (
package.json,requirements.txt, etc.) - La configuration de l’environnement dans le fichier
.replit
Configurer les secrets partagés
Si votre modèle repose sur des clés API, des jetons ou d’autres identifiants, ajoutez-les aux Secrets du modèle (sous le panneau Outils) avant d’épingler. Lorsqu’un builder crée une nouvelle application à partir du modèle, tous les secrets sont copiés dans la nouvelle application automatiquement, afin que les builders puissent commencer à travailler sans configurer eux-mêmes les identifiants. Documentez chaque secret danscustom_instruction/instructions.md (ou dans un skill dédié) afin que les builders sachent ce qui est disponible et à quoi sert chaque clé.
Rédiger des instructions personnalisées
Créez un fichier à l’emplacementcustom_instruction/instructions.md dans la racine du projet. C’est le fichier le plus important de votre modèle — il indique à Agent comment votre organisation crée des logiciels.
Agent injecte ce fichier directement dans son invite système avec un préambule qui le présente comme des directives fournies par l’entreprise. Rédigez-le en Markdown et incluez :
- Patterns d’architecture : Comment vos applications doivent être structurées
- Standards de codage : Conventions de nommage, règles d’organisation des fichiers, attentes en matière de linting
- Utilisation des composants : Quelles bibliothèques et composants utiliser (et lesquels éviter)
- Patterns d’API : Comment appeler vos services backend, gérer l’authentification, gérer les erreurs
- Exigences de test : Quels tests sont attendus et comment les exécuter
- Directives de déploiement : Configuration spécifique à l’environnement et flux de déploiement
.agents/skills/ plutôt que de tout conserver dans instructions.md. Les skills sont chargés à la demande lorsqu’ils sont pertinents, ils ne comptent donc pas dans la limite de taille des instructions et maintiennent vos instructions principales focalisées sur les règles de haut niveau.
Ajouter des skills personnalisés
Créez des skills dans le répertoire.agents/skills/ pour les flux de travail spécialisés qu’Agent doit suivre. Chaque skill est un répertoire contenant un fichier SKILL.md avec un frontmatter YAML.
SKILL.md a besoin d’un name et d’une description dans son frontmatter :
| Champ | Requis | Détails |
|---|---|---|
name | Oui | Maximum 64 caractères. Lettres minuscules, chiffres et traits d’union uniquement. |
description | Oui | Maximum 1 024 caractères. Décrit ce que fait le skill et quand l’utiliser. |
enabled | Non | Par défaut true. Définir sur false pour désactiver sans supprimer. |
name et la description dans son invite. Il lit le contenu complet de SKILL.md à la demande lorsque le skill est pertinent pour la tâche en cours. Cela signifie que la description est essentielle — rédigez-la pour qu’elle corresponde aux scénarios où Agent doit utiliser le skill.
Les skills peuvent également inclure des fichiers de support aux côtés de SKILL.md :
Configurer replit.md
Pré-remplissezreplit.md dans la racine du projet avec la présentation de l’architecture de votre modèle. Ce fichier est toujours chargé dans le contexte d’Agent et sert de mémoire de projet continue.
Le fichier doit avoir ces quatre sections :
replit.md au fur et à mesure que le projet évolue. Si le fichier dépasse environ 4 000 tokens, Agent le résume automatiquement pour le maintenir ciblé et utile.
Pour plus de détails, consultez replit.md.
Épingler le modèle à votre organisation
Une fois votre modèle prêt :- Accédez à l’application du modèle dans votre organisation
- Ouvrez le menu d’action de l’application (menu à trois points)
- Sélectionnez Pin to Agent input box

Seuls les administrateurs d’organisation (membres du rôle
system_admins) peuvent épingler et désépingler les modèles.
Contrôler l’accès au modèle
L’épinglage rend un modèle visible pour tous les membres de l’organisation. Pour une distribution plus ciblée, utilisez le bouton Invite sur l’application du modèle pour le partager avec des groupes ou des utilisateurs individuels spécifiques. Cela vous permet de limiter quelles équipes ou personnes peuvent voir et forker le modèle tout en le maintenant désépinglé de la zone de saisie à l’échelle de l’organisation.Ce qui se passe lorsqu’un builder sélectionne un modèle

- Fork : Une nouvelle application est créée comme copie du modèle, avec tous les fichiers inclus
- Ignorer la planification : Agent contourne la conversation de planification initiale et passe directement en mode construction
- Charger les instructions :
custom_instruction/instructions.mdest lu et injecté dans l’invite système d’Agent en tant que directives fournies par l’entreprise - Découvrir les skills : Les skills dans
.agents/skills/sont identifiés et listés dans le contexte d’Agent pour un chargement à la demande - Charger le contexte du projet :
replit.mdest lu et injecté dans le contexte d’Agent (ou auto-généré s’il est absent) - Hériter de la configuration : Le fichier
.replit, les dépendances et tous les fichiers du modèle sont transférés dans la nouvelle application
Comment les fichiers fonctionnent ensemble
Chaque fichier de configuration a un rôle distinct :| Fichier | Objectif | Quand Agent le lit | Modifiable par Agent |
|---|---|---|---|
custom_instruction/instructions.md | Standards et règles de l’organisation | Toujours (injecté dans l’invite système) | Non |
.agents/skills/*/SKILL.md | Flux de travail et patterns spécialisés | À la demande (lorsque pertinent) | Oui (Agent peut aussi créer des skills) |
replit.md | Présentation et préférences du projet | Toujours (injecté dans l’invite système) | Oui (Agent le met à jour au fil du temps) |
.replit | Configuration du runtime | Lors de la configuration de l’application | Oui |
custom_instruction/instructions.md est votre source statique et faisant autorité pour les standards organisationnels. replit.md est le document vivant qu’Agent maintient à mesure que le projet évolue. Les skills sont du matériel de référence à la demande pour des flux de travail spécifiques.
Bonnes pratiques
Gardez les instructions ciblées
Rédigezcustom_instruction/instructions.md pour les patterns qui comptent le plus. Concentrez-vous sur :
- Les décisions difficiles à inverser (architecture, modèles de données)
- Les patterns qui doivent être cohérents (utilisation des composants, conventions d’API)
- Les standards que le builder pourrait ne pas connaître (bibliothèques internes, conventions d’équipe)
Rédigez des descriptions de skills découvrables
Le champdescription dans le frontmatter de SKILL.md est ce qu’Agent utilise pour décider quand charger un skill. Rédigez des descriptions qui correspondent aux tâches où le skill est pertinent :
Organisez les skills par flux de travail
Regroupez les skills autour des flux de travail plutôt que des catégories techniques :| Approche | Exemple |
|---|---|
| Par flux de travail | build-a-form, connect-to-api, add-auth |
| Par domaine technique | react-utils, api-helpers, auth-config |
Itérez sur votre modèle
Les modèles s’améliorent avec l’utilisation. Une fois que votre équipe commence à créer avec un modèle :- Observez les patterns qu’Agent gère mal et ajoutez-les à
instructions.md - Créez de nouveaux skills lorsqu’Agent résout bien un problème — capturez la solution
- Mettez à jour les dépendances de base et les configurations à mesure que votre pile évolue
- Testez les modifications en créant une nouvelle application à partir du modèle pour vérifier l’expérience
Mises à jour du modèle et applications existantes
Les modifications apportées à l’application du modèle se reflètent dans les nouvelles applications créées à partir de celui-ci. Les applications existantes précédemment forkées à partir du modèle sont des copies indépendantes et ne reçoivent pas les mises à jour.Ressources associées
- Agent Skills — Découvrez comment fonctionnent les skills et comment les créer
- Tutoriel Agent Skills — Guide pratique pour créer et utiliser des skills
- replit.md — Personnalisez le comportement d’Agent avec le contexte au niveau du projet
- Systèmes de design — Configurez le système de design de votre organisation pour Agent
- Configuration de l’application — Configurez votre fichier
.replit - Frameworks développeurs — Modèles communautaires et comment les publier
- Présentation Enterprise — En savoir plus sur les fonctionnalités Enterprise