Règles

Vous pouvez fournir des instructions personnalisées à dropstone en créant un fichier AGENTS.md. Cela est similaire aux règles de Cursor. Il contient des instructions qui seront incluses dans le contexte du LLM pour personnaliser son comportement pour votre projet spécifique.

Initialisation

Pour créer un nouveau fichier AGENTS.md, vous pouvez exécuter la commande /init dans dropstone.

/init analyse les fichiers importants de votre dépôt, peut poser quelques questions ciblées lorsque le codebase ne peut pas y répondre, puis crée ou met à jour AGENTS.md avec des conseils concis et spécifiques au projet.

Il se concentre sur les éléments dont les futures sessions d'agent auront le plus probablement besoin :

• les commandes de build, de lint et de test
• l'ordre des commandes et les étapes de vérification ciblées lorsqu'elles sont importantes
• l'architecture et la structure du dépôt qui ne sont pas évidentes à partir des seuls noms de fichiers
• les conventions spécifiques au projet, les particularités de configuration et les pièges opérationnels
• les références aux sources d'instructions existantes comme les règles de Cursor ou Copilot

Si vous avez déjà un AGENTS.md, /init l'améliorera sur place au lieu de le remplacer aveuglément.

Exemple

Vous pouvez également créer ce fichier manuellement. Voici un exemple de ce que vous pouvez mettre dans un fichier AGENTS.md.

# Projet Monorepo SST v3

Ceci est un monorepo SST v3 avec TypeScript. Le projet utilise les workspaces bun pour la gestion des paquets.

## Structure du projet

- `packages/` - Contient tous les paquets du workspace (functions, core, web, etc.)
- `infra/` - Définitions de l'infrastructure réparties par service (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Configuration principale SST avec imports dynamiques

## Normes de code

- Utiliser TypeScript avec le mode strict activé
- Le code partagé va dans `packages/core/` avec une configuration d'exports appropriée
- Les fonctions vont dans `packages/functions/`
- L'infrastructure doit être répartie dans des fichiers logiques dans `infra/`

## Conventions du monorepo

- Importer les modules partagés en utilisant les noms de workspace : `@my-app/core/example`

Nous ajoutons ici des instructions spécifiques au projet et celles-ci seront partagées au sein de votre équipe.

Types

dropstone prend également en charge la lecture du fichier AGENTS.md depuis plusieurs emplacements. Et cela sert à différents objectifs.

Projet

Placez un AGENTS.md à la racine de votre projet pour des règles spécifiques au projet. Celles-ci ne s'appliquent que lorsque vous travaillez dans ce répertoire ou ses sous-répertoires.

Global

Vous pouvez également avoir des règles globales dans un fichier ~/.config/dropstone/AGENTS.md. Cela s'applique à toutes les sessions dropstone.

Comme ce fichier n'est pas validé dans Git ni partagé avec votre équipe, nous vous recommandons de l'utiliser pour spécifier toutes les règles personnelles que le LLM doit suivre.

Compatibilité Claude Code

Pour les utilisateurs qui migrent depuis Claude Code, Dropstone lit les conventions de fichiers de Claude Code comme solutions de repli :

• Règles du projet : CLAUDE.md dans votre répertoire de projet (utilisé si aucun AGENTS.md n'existe)
• Règles globales : ~/.claude/CLAUDE.md (utilisé si aucun ~/.config/dropstone/AGENTS.md n'existe)
• Compétences : ~/.claude/skills/ (voir Compétences pour plus de détails)

Pour empêcher Dropstone de lire les emplacements de Claude Code, supprimez ou renommez ces fichiers (ou validez le contenu équivalent dans AGENTS.md afin que le projet ait la priorité).

Priorité

Lorsque Dropstone démarre, il recherche les fichiers de règles dans cet ordre :

1. Fichiers locaux en remontant depuis le répertoire courant (AGENTS.md, CLAUDE.md)
2. Fichier global à ~/.config/dropstone/AGENTS.md
3. Fichier Claude Code à ~/.claude/CLAUDE.md (si aucun des deux précédents n'est présent)

Le premier fichier correspondant gagne dans chaque catégorie. Par exemple, si vous avez à la fois AGENTS.md et CLAUDE.md, seul AGENTS.md est utilisé. De même, ~/.config/dropstone/AGENTS.md a la priorité sur ~/.claude/CLAUDE.md.

Instructions personnalisées

Vous pouvez spécifier des fichiers d'instructions personnalisés dans votre dropstone.json ou dans le fichier global ~/.config/dropstone/dropstone.json. Cela vous permet, à vous et à votre équipe, de réutiliser des règles existantes plutôt que de devoir les dupliquer dans AGENTS.md.

Exemple :

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]
}

Vous pouvez également utiliser des URL distantes pour charger des instructions depuis le web.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"]
}

Les instructions distantes sont récupérées avec un délai d'expiration de 5 secondes.

Tous les fichiers d'instructions sont combinés avec vos fichiers AGENTS.md.

Référencement de fichiers externes

Bien que dropstone n'analyse pas automatiquement les références de fichiers dans AGENTS.md, vous pouvez obtenir une fonctionnalité similaire de deux manières :

Utilisation de dropstone.json

L'approche recommandée consiste à utiliser le champ instructions dans dropstone.json :

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["docs/development-standards.md", "test/testing-guidelines.md", "packages/*/AGENTS.md"]
}

Instructions manuelles dans AGENTS.md

Vous pouvez apprendre à dropstone à lire des fichiers externes en fournissant des instructions explicites dans votre AGENTS.md. Voici un exemple pratique :

# Règles du projet TypeScript

## Chargement de fichiers externes

CRITIQUE : Lorsque vous rencontrez une référence de fichier (par exemple, @rules/general.md), utilisez votre outil de lecture pour le charger selon les besoins. Ils sont pertinents pour la tâche SPÉCIFIQUE en cours.

Instructions :

- Ne chargez PAS préventivement toutes les références - utilisez le chargement paresseux en fonction des besoins réels
- Une fois chargé, traitez le contenu comme des instructions obligatoires qui remplacent les valeurs par défaut
- Suivez les références de manière récursive si nécessaire

## Directives de développement

Pour le style de code TypeScript et les bonnes pratiques : @docs/typescript-guidelines.md
Pour l'architecture des composants React et les modèles de hooks : @docs/react-patterns.md
Pour la conception d'API REST et la gestion des erreurs : @docs/api-standards.md
Pour les stratégies de test et les exigences de couverture : @test/testing-guidelines.md

## Directives générales

Lisez le fichier suivant immédiatement car il est pertinent pour tous les flux de travail : @rules/general-guidelines.md.

Cette approche vous permet de :

• Créer des fichiers de règles modulaires et réutilisables
• Partager des règles entre projets via des liens symboliques ou des sous-modules Git
• Garder AGENTS.md concis tout en référençant des directives détaillées
• Garantir que dropstone charge les fichiers uniquement lorsque cela est nécessaire pour la tâche spécifique