Règles

Vous pouvez fournir des instructions personnalisées à dropstone en créant un fichier AGENTS.md. C'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.

Initialiser

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 la base de code ne peut pas y répondre, puis crée ou met à jour AGENTS.md avec des conseils concis spécifiques au projet.

Il se concentre sur les éléments que les futures sessions d'agent sont les plus susceptibles de nécessiter :

• commandes de build, lint et test
• ordre des commandes et étapes de vérification ciblées lorsqu'elles sont importantes
• architecture et structure du dépôt qui ne sont pas évidentes à partir des noms de fichiers seuls
• conventions spécifiques au projet, particularités de configuration et pièges opérationnels
• références à des 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.

# SST v3 Monorepo Project

This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for package management.

## Project Structure

- `packages/` - Contains all workspace packages (functions, core, web, etc.)
- `infra/` - Infrastructure definitions split by service (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Main SST configuration with dynamic imports

## Code Standards

- Use TypeScript with strict mode enabled
- Shared code goes in `packages/core/` with proper exports configuration
- Functions go in `packages/functions/`
- Infrastructure should be split into logical files in `infra/`

## Monorepo Conventions

- Import shared modules using workspace names: `@my-app/core/example`

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

Types

dropstone prend également en charge la lecture du fichier AGENTS.md à partir de plusieurs emplacements. Cela sert à différents objectifs.

Projet

Placez un AGENTS.md à la racine de votre projet pour les règles spécifiques au projet. Celles-ci s'appliquent uniquement 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. Ceci s'applique à toutes les sessions dropstone.

Comme ceci n'est pas validé dans Git ou partagé avec votre équipe, nous recommandons d'utiliser ceci pour spécifier toute règle personnelle que le LLM doit suivre.

Compatibilité Claude Code

Pour les utilisateurs migrant depuis Claude Code, Dropstone lit les conventions de fichiers de Claude Code comme alternatives :

• 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)
• Skills : ~/.claude/skills/ (voir Skills 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 prenne la priorité).

Priorité

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

1. Fichiers locaux en remontant à partir du répertoire courant (AGENTS.md, CLAUDE.md)
2. Fichier global à ~/.config/dropstone/AGENTS.md
3. Fichier Claude Code à ~/.claude/CLAUDE.md (si aucun des éléments ci-dessus 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 prend 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 ~/.config/dropstone/dropstone.json global. Cela vous permet, à vous et à votre équipe, de réutiliser les 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 les 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'attente de 5 secondes.

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

Référencer des 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 façons :

Utiliser dropstone.json

L'approche recommandée est d'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 de lire des fichiers externes en fournissant des instructions explicites dans votre AGENTS.md. Voici un exemple pratique :

# TypeScript Project Rules

## External File Loading

CRITICAL: When you encounter a file reference (e.g., @rules/general.md), use your Read tool to load it on a need-to-know basis. They're relevant to the SPECIFIC task at hand.

Instructions:

- Do NOT preemptively load all references - use lazy loading based on actual need
- When loaded, treat content as mandatory instructions that override defaults
- Follow references recursively when needed

## Development Guidelines

For TypeScript code style and best practices: @docs/typescript-guidelines.md
For React component architecture and hooks patterns: @docs/react-patterns.md
For REST API design and error handling: @docs/api-standards.md
For testing strategies and coverage requirements: @test/testing-guidelines.md

## General Guidelines

Read the following file immediately as it's relevant to all workflows: @rules/general-guidelines.md.

Cette approche vous permet de :

• Créer des fichiers de règles modulaires et réutilisables
• Partager les règles entre les 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
• Assurer que dropstone charge les fichiers uniquement lorsque cela est nécessaire pour la tâche spécifique