Regeln

Sie können benutzerdefinierte Anweisungen für dropstone bereitstellen, indem Sie eine AGENTS.md-Datei erstellen. Dies ähnelt den Regeln von Cursor. Sie enthält Anweisungen, die in den Kontext des LLM aufgenommen werden, um sein Verhalten für Ihr spezifisches Projekt anzupassen.

Initialisieren

Um eine neue AGENTS.md-Datei zu erstellen, können Sie den /init-Befehl in dropstone ausführen.

/init scannt die wichtigen Dateien in Ihrem Repository, stellt möglicherweise ein paar gezielt Fragen, wenn die Codebasis diese nicht beantworten kann, und erstellt oder aktualisiert dann AGENTS.md mit prägnanten projektspezifischen Richtlinien.

Der Fokus liegt auf den Dingen, die zukünftige Agent-Sitzungen am wahrscheinlichsten benötigen:

• Build-, Lint- und Test-Befehle
• Befehlsreihenfolge und fokussierte Verifizierungsschritte, wenn sie wichtig sind
• Architektur und Repository-Struktur, die nicht offensichtlich aus Dateinamen allein hervorgehen
• Projektspezifische Konventionen, Setup-Besonderheiten und operative Fallstricke
• Verweise auf vorhandene Anweisungsquellen wie Cursor- oder Copilot-Regeln

Wenn Sie bereits eine AGENTS.md haben, wird /init diese stattdessen an Ort und Stelle verbessern, anstatt sie blind zu ersetzen.

Beispiel

Sie können diese Datei auch manuell erstellen. Hier ist ein Beispiel für einige Dinge, die Sie in eine AGENTS.md-Datei aufnehmen können.

# 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 und diese werden in Ihrem Team geteilt.

Typen

dropstone unterstützt auch das Lesen der AGENTS.md-Datei von mehreren Orten. Dies dient verschiedenen Zwecken.

Projekt

Platzieren Sie eine AGENTS.md im Stammverzeichnis Ihres Projekts für projektspezifische Regeln. Diese gelten nur, wenn Sie in diesem Verzeichnis oder seinen Unterverzeichnissen arbeiten.

Global

Sie können auch globale Regeln in einer ~/.config/dropstone/AGENTS.md-Datei haben. Dies wird auf alle dropstone-Sitzungen angewendet.

Da dies nicht in Git committed oder mit Ihrem Team geteilt wird, empfehlen wir, dies zu verwenden, um persönliche Regeln anzugeben, die das LLM befolgen sollte.

Claude Code Kompatibilität

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

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

Um zu verhindern, dass Dropstone die Claude Code-Orte liest, entfernen oder benennen Sie diese Dateien um (oder committen Sie 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 durch Traversieren vom aktuellen Verzeichnis (AGENTS.md, CLAUDE.md)
2. Globale Datei unter ~/.config/dropstone/AGENTS.md
3. Claude Code-Datei unter ~/.claude/CLAUDE.md (wenn keine der obigen vorhanden ist)

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

Benutzerdefinierte Anweisungen

Sie können benutzerdefinierte Anweisungsdateien in Ihrer dropstone.json oder der globalen ~/.config/dropstone/dropstone.json angeben. Dies ermöglicht es Ihnen und Ihrem 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"]
}

Sie können 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 Ihren AGENTS.md-Dateien kombiniert.

Referenzierung externer Dateien

Während dropstone Dateiverweise in AGENTS.md nicht automatisch analysiert, können Sie ähnliche Funktionalität auf zwei Wegen erreichen:

Verwendung von dropstone.json

Der empfohlene Ansatz ist die Verwendung des instructions-Feldes 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

Sie können dropstone lehren, externe Dateien zu lesen, indem Sie explizite Anweisungen in Ihrer AGENTS.md bereitstellen. 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 Ihnen:

• Modulare, wiederverwendbare Regeldateien zu erstellen
• Regeln über Projekte hinweg über Symlinks oder Git-Submodule zu teilen
• AGENTS.md prägnant zu halten und dabei auf detaillierte Richtlinien zu verweisen
• Sicherzustellen, dass dropstone Dateien nur bei Bedarf für die spezifische Aufgabe lädt