Regole

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

Inizializzazione

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

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

Si concentra sulle cose che le future sessioni dell'agente avranno più probabilmente bisogno:

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

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

Esempio

Puoi anche semplicemente creare questo file manualmente. Ecco un esempio di alcune cose che puoi inserire in un file AGENTS.md.

# Progetto Monorepo SST v3

Questo è un monorepo SST v3 con TypeScript. Il progetto usa bun workspaces per la gestione dei pacchetti.

## Struttura del Progetto

- `packages/` - Contiene tutti i pacchetti del workspace (functions, core, web, ecc.)
- `infra/` - Definizioni dell'infrastruttura suddivise per servizio (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Configurazione SST principale con import dinamici

## Standard di Codice

- Usa TypeScript con modalità strict abilitata
- Il codice condiviso va in `packages/core/` con una configurazione di export appropriata
- Le funzioni vanno in `packages/functions/`
- L'infrastruttura dovrebbe essere suddivisa in file logici in `infra/`

## Convenzioni Monorepo

- Importa i moduli condivisi usando i nomi del workspace: `@my-app/core/example`

Stiamo aggiungendo qui istruzioni specifiche del progetto e queste verranno condivise con tutto 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 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 a tutte le sessioni di dropstone.

Poiché questo non viene committato su Git né condiviso con il tuo team, ti consigliamo di usarlo per specificare eventuali regole personali 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 di progetto: CLAUDE.md nella directory del tuo 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 le posizioni di Claude Code, rimuovi o rinomina quei file (o committa il contenuto equivalente in AGENTS.md così che il progetto abbia la precedenza).

Precedenza

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

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

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

Istruzioni Personalizzate

Puoi specificare file di istruzioni personalizzati nel tuo dropstone.json o nel file globale ~/.config/dropstone/dropstone.json. Questo ti permette, a te e al tuo team, di riutilizzare 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

Sebbene dropstone non analizzi automaticamente i riferimenti ai file in AGENTS.md, puoi ottenere funzionalità simili 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:

# Regole del Progetto TypeScript

## Caricamento di File Esterni

CRITICO: Quando incontri un riferimento a un file (ad es., @rules/general.md), usa il tuo strumento di Lettura per caricarlo su base "need-to-know". Sono rilevanti per il compito SPECIFICO in questione.

Istruzioni:

- NON caricare preventivamente tutti i riferimenti - usa il caricamento lazy in base alla necessità effettiva
- Quando caricato, tratta il contenuto come istruzioni obbligatorie che sovrascrivono i valori predefiniti
- Segui i riferimenti in modo ricorsivo quando necessario

## Linee Guida di Sviluppo

Per lo stile del codice TypeScript e le migliori pratiche: @docs/typescript-guidelines.md
Per l'architettura dei componenti React e i pattern degli hook: @docs/react-patterns.md
Per la progettazione delle API REST e la gestione degli errori: @docs/api-standards.md
Per le strategie di test e i requisiti di copertura: @test/testing-guidelines.md

## Linee Guida Generali

Leggi il seguente file immediatamente poiché è rilevante per tutti i flussi di lavoro: @rules/general-guidelines.md.

Questo approccio ti permette di:

• Creare file di regole modulari e riutilizzabili
• Condividere regole tra progetti tramite symlink o git submodules
• Mantenere AGENTS.md conciso mentre si fa riferimento a linee guida dettagliate
• Garantire che dropstone carichi i file solo quando necessario per il compito specifico