Regole

Puoi fornire istruzioni personalizzate a dropstone creando un file AGENTS.md. È simile alle regole di Cursor. Contiene istruzioni che verranno incluse nel contesto dell'LLM per personalizzare il suo comportamento per il tuo progetto specifico.

Inizializza

Per creare un nuovo file AGENTS.md, puoi eseguire il comando /init in dropstone.

/init scansiona i file importanti nel tuo repository, potrebbe fare un paio di domande mirate quando il codebase non può rispondere, e quindi crea o aggiorna AGENTS.md con indicazioni concise specifiche del progetto.

Si concentra sulle cose che le future sessioni dell'agente avranno più probabilità di aver bisogno:

• comandi di build, lint e test
• ordine dei comandi e passaggi di verifica focalizzati quando importanti
• architettura e struttura del repository che non sono ovvie dai soli nomi dei file
• convenzioni specifiche del progetto, stranezze di configurazione e insidie operative
• riferimenti a fonti di istruzioni esistenti come regole di Cursor o Copilot

Se hai già un AGENTS.md, /init lo migliorerà in loco invece di sostituirlo ciecamente.

Esempio

Puoi anche creare questo file manualmente. Ecco un esempio di alcune cose che puoi inserire in un file 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`

Stiamo aggiungendo istruzioni specifiche del progetto qui e questo sarà condiviso con il tuo team.

Tipi

dropstone supporta anche la lettura del file AGENTS.md da più posizioni. E questo serve a scopi diversi.

Progetto

Posiziona un AGENTS.md nella radice del tuo progetto per le regole specifiche del progetto. Queste si applicano solo quando lavori in questa directory o nelle sue sottodirectory.

Globale

Puoi anche avere regole globali in un file ~/.config/dropstone/AGENTS.md. Questo viene applicato in tutte le sessioni di dropstone.

Poiché questo non è sottoposto a commit su Git o condiviso con il tuo team, ti consigliamo di usarlo per specificare qualsiasi regola personale che l'LLM dovrebbe seguire.

Compatibilità con Claude Code

Per gli utenti che migrano da Claude Code, Dropstone legge le convenzioni dei file di Claude Code come fallback:

• Regole del progetto: CLAUDE.md nella tua directory di progetto (usato se non esiste AGENTS.md)
• Regole globali: ~/.claude/CLAUDE.md (usato se non esiste ~/.config/dropstone/AGENTS.md)
• Skills: ~/.claude/skills/ (vedi Skills per i dettagli)

Per impedire a Dropstone di leggere i percorsi di Claude Code, rimuovi o rinomina quei file (o esegui il commit del contenuto equivalente in AGENTS.md in modo che il progetto abbia la precedenza).

Precedenza

Quando Dropstone si avvia, cerca i file di regole in questo ordine:

1. File locali attraversando verso l'alto dalla directory corrente (AGENTS.md, CLAUDE.md)
2. File globale in ~/.config/dropstone/AGENTS.md
3. File Claude Code in ~/.claude/CLAUDE.md (se nessuno dei precedenti è presente)

Il primo file corrispondente vince in ogni categoria. Ad esempio, se hai sia AGENTS.md che CLAUDE.md, solo AGENTS.md viene usato. Allo stesso modo, ~/.config/dropstone/AGENTS.md ha la precedenza su ~/.claude/CLAUDE.md.

Istruzioni Personalizzate

Puoi specificare file di istruzioni personalizzate nel tuo dropstone.json o nel ~/.config/dropstone/dropstone.json globale. Questo ti permette a te e al tuo team di riutilizzare le regole esistenti invece di doverle duplicare in AGENTS.md.

Esempio:

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

Puoi anche usare URL remoti per caricare istruzioni dal web.

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

Le istruzioni remote vengono recuperate con un timeout di 5 secondi.

Tutti i file di istruzioni vengono combinati con i tuoi file AGENTS.md.

Riferimento a File Esterni

Mentre dropstone non analizza automaticamente i riferimenti ai file in AGENTS.md, puoi ottenere una funzionalità simile in due modi:

Usando dropstone.json

L'approccio consigliato è usare il campo instructions in dropstone.json:

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

Istruzioni Manuali in AGENTS.md

Puoi insegnare a dropstone a leggere file esterni fornendo istruzioni esplicite nel tuo AGENTS.md. Ecco un esempio pratico:

# 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.

Questo approccio ti permette di:

• Creare file di regole modulari e riutilizzabili
• Condividere regole tra progetti tramite symlink o git submodule
• Mantenere AGENTS.md conciso mentre fai riferimento a linee guida dettagliate
• Assicurare che dropstone carichi i file solo quando necessario per l'attività specifica