Zum Hauptinhalt springen

Kontextverwaltung über KI-Coding-Tools und Cursor-Sitzungen hinweg

Cursor Context Management

Eine der größten Herausforderungen bei der Arbeit mit KI-Coding-Assistenten ist die Aufrechterhaltung des Kontexts über Sitzungen und Tools hinweg. Cursor bietet mehrere Mechanismen zum Erhalten und Teilen des Projektkontexts, die sicherstellen, dass Ihr KI-Assistent immer über die benötigten Informationen verfügt. Dieser Guide behandelt die Best Practices für die Kontextverwaltung.

Das Kontextproblem​

Bei der Arbeit mit KI-Tools stehen Sie oft vor diesen Herausforderungen:

  • Sitzungsamnesie: Jeder neue Chat beginnt neu ohne Erinnerung an vorherige Arbeit
  • Tool-Wechsel: Das Wechseln zwischen Cursor, Claude, ChatGPT oder anderen Tools verliert den Kontext
  • Team-Sharing: Teammitglieder benötigen Zugriff auf denselben Projektkontext
  • Kontextdrift: Über lange Sitzungen verliert die KI die Spur der ursprünglichen Ziele

Lösung 1: AGENTS.md - Die Projektverfassung​

Erstellen Sie eine AGENTS.md-Datei im Stammverzeichnis Ihres Repositorys. Dies ist die einzige Quelle der Wahrheit für alle KI-Tools.

Struktur von AGENTS.md​

# Projekt: MyApp

## Übersicht
Kurze Beschreibung dessen, was dieses Projekt macht und seiner Tech-Stack.

## Tech-Stack
- Frontend: React 18 + TypeScript + Tailwind CSS
- Backend: Node.js + Express + PostgreSQL
- Tests: Jest + React Testing Library
- Build: Vite

## Projektstruktur

src/ components/ # Wiederverwendbare UI-Komponenten pages/ # Routen-Level-Seiten hooks/ # Benutzerdefinierte React-Hooks utils/ # Hilfsfunktionen types/ # TypeScript-Typen api/ # API-Client-Funktionen


## Build- & Test-Befehle
```bash
npm run dev       # Entwicklungsserver starten
npm run build     # Produktionsbuild
npm run test      # Tests ausführen
npm run lint      # ESLint ausführen

Coding-Standards​

  • Funktionale Komponenten mit Hooks verwenden
  • Die bestehende Dateiorganisation befolgen
  • Tests für alle neuen Funktionen schreiben
  • TypeScript-Strict-Modus verwenden

Wichtige Entscheidungen​

  • Verwendung von React Query für Server-State-Management
  • JWT-Tokens in httpOnly-Cookies gespeichert
  • Monorepo-Struktur mit geteiltem Types-Paket

### AGENTS.md in Cursor referenzieren

Zu Beginn jedes neuen Chats:

Lies AGENTS.md und hilf mir, [Funktion] zu implementieren. Befolge alle Coding-Standards und verwende die bestehenden Patterns.


## Lösung 2: Cursor-spezifische Regeln

Erstellen Sie `.cursor/rules/` für Cursor-spezifische Richtlinien:

```markdown
---
description: 'Projektspezifisches Cursor-Verhalten'
globs: ['**/*.ts', '**/*.tsx']
alwaysApply: true
---

# Cursor-Richtlinien

## Vor Änderungen
1. AGENTS.md für Projektkontext lesen
2. Bestehende ähnliche Implementierungen prüfen
3. Die etablierten Patterns befolgen

## Code-Generierungs-Präferenzen
- TypeScript mit expliziten Typen generieren
- JSDoc-Kommentare für öffentliche APIs einfügen
- Das bestehende Fehlerbehandlungs-Pattern verwenden

## Test-Anforderungen
- Immer Tests für neue Funktionen vorschlagen
- React Testing Library für Komponenten verwenden
- API-Aufrufe mit MSW mocken

Lösung 3: Sitzungsspeicher mit MCP​

Verwenden Sie MCP-Server (Model Context Protocol) für persistenten Speicher:

Memory-MCP einrichten​

Fügen Sie Ihren Cursor-MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@cursor-memory/server"]
    }
  }
}

Speicher verwenden​

Wichtige Fakten speichern:

Merke dir, dass wir PostgreSQL mit einer users-Tabelle verwenden, die Folgendes enthält:
- id (UUID, Primärschlüssel)
- email (eindeutig, indiziert)
- created_at (Zeitstempel)
- preferences (JSONB)

In zukünftigen Sitzungen abrufen:

Was erinnerst du dich an unser Datenbankschema?

Lösung 4: Das CONTRACT.md-Pattern​

Für komplexe Projekte verwenden Sie eine Vertragsdatei, die Invarianten definiert:

# Projektvertrag

## Invarianten (Nie verletzen)
1. Alle API-Antworten müssen einen `success`-Booleschen Wert enthalten
2. Benutzer-IDs sind immer UUIDs, niemals Ganzzahlen
3. Passwörter werden niemals protokolliert oder in Antworten zurückgegeben

## Architektur-Regeln
1. Domain-Logik befindet sich in `src/domain/`
2. API-Routen delegieren nur an Services
3. Datenbankzugriff nur über Repository-Pattern

## Aktuelle Sprint-Ziele
- Benutzerauthentifizierung implementieren
- Passwort-Reset-Flow hinzufügen
- E-Mail-Benachrichtigungen einrichten

Aktualisieren Sie diese Datei nach jeder bedeutenden Änderung.

Lösung 5: Sitzungszusammenfassungen​

Am Ende jeder Sitzung erstellen Sie eine Zusammenfassung:

# Sitzungszusammenfassung: 2026-06-22

## Abgeschlossen
- [x] JWT-Authentifizierungs-Middleware eingerichtet
- [x] Login- und Registrierungs-Endpunkte erstellt
- [x] Passwort-Hashing mit bcrypt hinzugefügt

## In Bearbeitung
- [ ] E-Mail-Verifizierungs-Flow (begonnen, braucht Tests)

## Nächste Schritte
1. Passwort-Reset mit Token-Ablauf implementieren
2. Rate-Limiting für Auth-Endpunkte hinzufügen
3. Integrationstests schreiben

## Geänderte Schlüsseldateien
- src/middleware/auth.ts (neu)
- src/routes/auth.ts (neu)
- src/services/auth.ts (neu)
- src/models/user.ts (geändert)

## Getroffene Entscheidungen
- 15-minütige JWT-Ablaufzeit mit Refresh-Tokens verwenden
- Refresh-Tokens in Redis speichern

Speichern Sie dies als docs/session-summaries/YYYY-MM-DD.md.

Lösung 6: Cross-Tool-Kontext mit Markdown​

Beim Wechsel zwischen Tools verwenden Sie ein standardisiertes Kontextformat:

# Kontextübertragung

## Aktuelle Aufgabe
Benutzerprofilseite implementieren

## Relevante Dateien
- src/pages/Profile.tsx
- src/components/UserForm.tsx
- src/api/users.ts

## Aktueller Status
- Profilseiten-Skelett erstellt
- UserForm-Komponente braucht Validierung
- API-Endpunkt /api/users/me gibt korrekte Daten zurück

## Blocker
- Bild-Upload-Ansatz muss entschieden werden

## Nächste Aktion
Formularvalidierung und Submit-Handler hinzufügen

Kopieren Sie dies in jedes KI-Tool, um nahtlos fortzufahren.

Zusammenfassung der Best Practices​

Zu Tun​

  • AGENTS.md beim Projektstart erstellen
  • AGENTS.md aktualisieren, wenn sich die Architektur ändert
  • Cursor-Regeln für tool-spezifische Richtlinien verwenden
  • Jede Sitzung vor dem Schließen zusammenfassen
  • Persistente Fakten mit MCP-Speicher speichern
  • Versionskontrolle für alle Kontextdateien verwenden

Nicht Zu Tun​

  • Nicht nur auf den Sitzungsspeicher der KI verlassen
  • Kontext nicht in externen Notizen (Obsidian/Notion) ohne Synchronisation halten
  • Kontextdateien nicht veralten lassen
  • Informationen nicht über mehrere Dateien duplizieren

Schnellstart-Checkliste​

Für ein neues Projekt:

  1. AGENTS.md mit Projektübersicht erstellen
  2. .cursor/rules/ für Cursor-Verhalten einrichten
  3. MCP-Speicherserver konfigurieren
  4. CONTRACT.md für Architektur-Invarianten erstellen
  5. docs/session-summaries/ Verzeichnis einrichten
  6. Alle Kontextdateien zur Versionskontrolle hinzufügen

Verwandte Ressourcen​