Einleitung: Das Szenario eines Indie-Entwicklers

Stellen Sie sich vor: Sie sind ein Indie-Entwickler, der an einem persönlichen E-Commerce-Projekt arbeitet. Jedes Mal, wenn Sie Cursor öffnen und den AI-Assistenten bitten, Code zu schreiben, müssen Sie erklären, dass Ihr Projekt eine Vue 3 + FastAPI-Architektur verwendet, dass Sie Tailwind CSS bevorzugen und dass Ihre API-Routen RESTful sein sollen. Das kostet Zeit und Nerven. Die Lösung? .cursorrules – eine Datei, die Ihrem AI-Assistenten sagt, wer Sie sind, wie Ihr Projekt strukturiert ist und welche Coding-Standards Sie erwarten. In diesem Tutorial erfahren Sie, wie Sie diese Datei optimal gestalten.

Mit HolySheep AI können Sie Ihre .cursorrules-Entwicklung besonders effizient gestalten – mit unter 50ms Latenz und Kosten ab ¥1=$1, was über 85% Ersparnis gegenüber anderen Providern bedeutet.

Was ist .cursorrules und warum ist sie wichtig?

Die .cursorrules-Datei ist eine textbasierte Konfigurationsdatei, die im Wurzelverzeichnis Ihres Projekts liegt. Sie enthält Anweisungen, die Cursor bei jeder Interaktion berücksichtigt:

Grundstruktur einer effektiven .cursorrules-Datei

1. Der Header: Projektidentifikation

# Projekt: Mein E-Commerce Dashboard

Version: 2.1.0


Stack: Vue 3 + FastAPI + PostgreSQL


Letzte Aktualisierung: 2026-01-15



Über dieses Projekt

Ein E-Commerce-Dashboard zur Verwaltung von Produktbeständen mit 
Echtzeit-Analytics. Verwendet eine modulare Monolith-Architektur 
mit klarer Trennung zwischen Frontend und Backend.

2. Technische Spezifikationen

## Technischer Stack


Frontend

- Vue 3 mit Composition API
- Pinia für State Management
- Tailwind CSS (Utility-First Ansatz)
- Vite als Build-Tool


Backend

- FastAPI mit Python 3.11+
- SQLAlchemy 2.0 für ORM
- Pydantic v2 für Validierung
- PostgreSQL 15 als Datenbank


API-Konventionen

- RESTful-Endpunkte mit /api/v1/ Präfix
- JWT-Authentifizierung
- Request/Response-Modelle in schemas/
- Datenbankmodelle in models/

Best Practices für aussagekräftige Prompts

3. Coding-Standards definieren

## Coding-Standards


Naming Conventions

- Vue-Komponenten: PascalCase (UserProfile.vue)
- JavaScript-Funktionen: camelCase (getUserData)
- Python-Funktionen: snake_case (get_user_data)
- CSS-Klassen: kebab-case (user-profile-card)
- Datenbanktabellen: snake_case plural (user_orders)


Kommentare

- Deutsche Kommentare im Code
- Jede Funktion benötigt einen Docstring
- Komplexe Logik muss mit Inline-Kommentaren erklärt werden


Strukturrichtlinien

- Maximale Dateilänge: 300 Zeilen
- Funktionen sollten maximal 20 Zeilen haben
- Imports immer alphabetisch sortieren

4. Verhaltensanweisungen für den AI-Assistenten

## Verhalten beim Programmieren


IMMER

- Prüfe zuerst bestehenden Code, bevor du neuen schreibst
- Schreibe Unit-Tests für neue Funktionen
- Nutze TypeScript-Typen für bessere IntelliSense
- Erstelle bei API-Änderungen eine Migration


NIEMALS

- Verwende keine any-Typen in TypeScript
- Lösche keine bestehenden Dateien ohne Bestätigung
- Committe nicht direkt auf main/main-Branch
- Ignoriere TypeScript-Fehler


Fehlerbehandlung

- Verwende try-catch-Blöcke für externe API-Aufrufe
- Logge Fehler mit strukturiertem Logging (pydantic-logging)
- Gib benutzerfreundliche Fehlermeldungen zurück

Fortgeschrittene Techniken

5. Kontextsensitive Anweisungen

Nutzen Sie bedingte Anweisungen für verschiedene Dateitypen: 
## Dateityp-spezifische Regeln


Bei Vue-Komponenten

- Verwende