Regeln

Du kannst Dropstone benutzerdefinierte Anweisungen geben, indem du eine AGENTS.md-Datei erstellst. Dies ähnelt den Regeln von Cursor. Sie enthält Anweisungen, die in den Kontext des LLM aufgenommen werden, um sein Verhalten für dein spezifisches Projekt anzupassen.

Initialisieren

Um eine neue AGENTS.md-Datei zu erstellen, kannst du den Befehl /init in Dropstone ausführen.

/init durchsucht die wichtigen Dateien in deinem Repository, stellt möglicherweise ein paar gezielte Fragen, wenn die Codebasis diese nicht beantworten kann, und erstellt oder aktualisiert dann AGENTS.md mit präzisen projektspezifischen Anweisungen.

Es konzentriert sich auf die Dinge, die zukünftige Agent-Sitzungen am wahrscheinlichsten benötigen:

• Build-, Lint- und Testbefehle
• Befehlsreihenfolge und fokussierte Verifizierungsschritte, wenn sie wichtig sind
• Architektur und Repository-Struktur, die allein anhand der Dateinamen nicht offensichtlich sind
• Projektspezifische Konventionen, Setup-Besonderheiten und betriebliche Stolperfallen
• Verweise auf bestehende Anweisungsquellen wie Cursor- oder Copilot-Regeln

Wenn du bereits eine AGENTS.md hast, verbessert /init diese direkt an Ort und Stelle, anstatt sie blind zu ersetzen.

Beispiel

Du kannst diese Datei auch einfach manuell erstellen. Hier ist ein Beispiel für einige Dinge, die du in eine AGENTS.md-Datei aufnehmen kannst.

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

Wir fügen hier projektspezifische Anweisungen hinzu, die in deinem gesamten Team geteilt werden.

Typen

Dropstone unterstützt auch das Lesen der AGENTS.md-Datei aus mehreren Speicherorten. Diese dienen unterschiedlichen Zwecken.

Projekt

Lege eine AGENTS.md im Stammverzeichnis deines Projekts ab, um projektspezifische Regeln festzulegen. Diese gelten nur, wenn du in diesem Verzeichnis oder seinen Unterverzeichnissen arbeitest.

Global

Du kannst auch globale Regeln in einer ~/.config/dropstone/AGENTS.md-Datei haben. Diese werden auf alle Dropstone-Sitzungen angewendet.

Da diese Datei nicht in Git committet oder mit deinem Team geteilt wird, empfehlen wir, sie zu verwenden, um persönliche Regeln festzulegen, denen das LLM folgen soll.

Claude-Code-Kompatibilität

Für Benutzer, die von Claude Code migrieren, liest Dropstone die Dateikonventionen von Claude Code als Fallback:

• Projektregeln: CLAUDE.md in deinem Projektverzeichnis (verwendet, wenn keine AGENTS.md existiert)
• Globale Regeln: ~/.claude/CLAUDE.md (verwendet, wenn keine ~/.config/dropstone/AGENTS.md existiert)
• Skills: ~/.claude/skills/ (siehe Skills für Details)

Um zu verhindern, dass Dropstone die Claude-Code-Speicherorte liest, entferne oder benenne diese Dateien um (oder committe den entsprechenden Inhalt in AGENTS.md, damit das Projekt Vorrang hat).

Priorität

Wenn Dropstone startet, sucht es in dieser Reihenfolge nach Regeldateien:

1. Lokale Dateien, indem es vom aktuellen Verzeichnis aus aufwärts navigiert (AGENTS.md, CLAUDE.md)
2. Globale Datei unter ~/.config/dropstone/AGENTS.md
3. Claude-Code-Datei unter ~/.claude/CLAUDE.md (wenn keine der beiden oben genannten vorhanden ist)

Die erste übereinstimmende Datei gewinnt in jeder Kategorie. Wenn du beispielsweise sowohl AGENTS.md als auch CLAUDE.md hast, wird nur AGENTS.md verwendet. Ebenso hat ~/.config/dropstone/AGENTS.md Vorrang vor ~/.claude/CLAUDE.md.

Benutzerdefinierte Anweisungen

Du kannst benutzerdefinierte Anweisungsdateien in deiner dropstone.json oder der globalen ~/.config/dropstone/dropstone.json angeben. Dies ermöglicht es dir und deinem Team, vorhandene Regeln wiederzuverwenden, anstatt sie in AGENTS.md duplizieren zu müssen.

Beispiel:

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

Du kannst auch Remote-URLs verwenden, um Anweisungen aus dem Web zu laden.

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

Remote-Anweisungen werden mit einem Timeout von 5 Sekunden abgerufen.

Alle Anweisungsdateien werden mit deinen AGENTS.md-Dateien kombiniert.

Referenzierung externer Dateien

Obwohl Dropstone Dateiverweise in AGENTS.md nicht automatisch parst, kannst du ähnliche Funktionalität auf zwei Arten erreichen:

Verwenden von dropstone.json

Der empfohlene Ansatz ist die Verwendung des Felds instructions in dropstone.json:

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

Manuelle Anweisungen in AGENTS.md

Du kannst Dropstone beibringen, externe Dateien zu lesen, indem du explizite Anweisungen in deiner AGENTS.md bereitstellst. Hier ist ein praktisches Beispiel:

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

Dieser Ansatz ermöglicht es dir:

• Modulare, wiederverwendbare Regeldateien zu erstellen
• Regeln über Projekte hinweg über Symlinks oder Git-Submodule zu teilen
• AGENTS.md präzise zu halten, während du auf detaillierte Richtlinien verweist
• Sicherzustellen, dass Dropstone Dateien nur lädt, wenn sie für die spezifische Aufgabe benötigt werden