Kontextkuratierung & Regelhygiene

1. Überblick über das Konzept und das Systemproblem

Entwickler behandeln Dateien wie .cursorrules oder .clinerules oft als Mülleimer:

• Ein Bug tritt auf? Eine Regel wird hinzugefügt: "Verwende niemals die Bibliothek X".
• Eine Woche später fügt ein anderer Entwickler hinzu: "Verwende die Bibliothek X für schnelle Operationen".
• Nach drei Monaten verwandelt sich die Datei in einen unleserlichen Wust aus 80 widersprüchlichen Anweisungen.
• Das Modell muss bei jeder Anfrage dieses Chaos lesen, was Tokens verbraucht und die Qualität der Generierung mindert.

Context Curation ist eine Disziplin des Minimalismus und der architektonischen Reinheit: Systemregeln müssen modular, hierarchisch, aktuell und prägnant sein.

2. Architektonische Taxonomie und mentales Modell

┌─────────────────────────────────────────────────────────────┐
│                 MODULAR CONTEXT HIERARCHY                   │
├─────────────────────────────────────────────────────────────┤
│ 1. ROOT RULES (.cursorrules / AGENTS.md) [Max 150 lines]    │
│    • Core stack & strict boundaries (Next.js 15, Drizzle)   │
│    • Ban-list (No any, no ts-ignore, no unverified deps)    │
│    • Verification command: `pnpm check && pnpm test`        │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ On-demand dynamic loading        │
├─────────────────────────────────────────────────────────────┤
│ 2. DOMAIN SKILLS & SUBSYSTEM SPECS (.agents/skills/)        │
│    • `skills/better-auth/` ➔ loaded ONLY during auth tasks   │
│    • `skills/seo-audit/`   ➔ loaded ONLY for marketing pages│
│    • `skills/db-migrations/` ➔ loaded ONLY for schema edits │
└─────────────────────────────────────────────────────────────┘

3. Praktische Engineering-Szenarien im Produktionsumfeld

01. Die Regel des "Eindeutigen Verbots" (Negative Constraints)

Statt langer Beschreibungen darüber, wie Code geschrieben werden soll, formulieren hochwertige Regeln klar verbotene Aktionen:

## Strict Invariants
- NEVER run `npm run build` locally during dev; use `tsc --noEmit`.
- NEVER use inline CSS styles; use Tailwind design tokens.
- NEVER invent mock user IDs; query database fixtures.

02. Verwendung relativer Referenzen statt Copy-Paste von Code

Anstatt den gesamten Typ-Definitionen-File in .cursorrules zu kopieren, geben Sie Referenzen an:

Before modifying database entities, read schema definitions in [schema.ts](file:///src/db/schema.ts).

Moderne agentische Umgebungen ziehen den Inhalt der Datei bei Bedarf selbstständig nach.

4. Fallstricke, häufige Fehler und Sicherheit

• Versuch, das Sprachmodell über Regeln zu belehren: Schreiben Sie keine Vorlesungen darüber, was Asynchronität in JavaScript ist oder wie Promises funktionieren. Das Modell weiß das bereits. Regeln sind ausschließlich für die Spezifika Ihres Repositoriums gedacht.
• Verlust der Aktualität: Wenn ein Projekt von Tailwind v3 auf Tailwind v4 migriert hat, führen alte Regeln mit veralteten Utilities zu Syntaxfehlern. Führen Sie monatliche Audits der Regeln durch.

5. Strategisches Fazit für Ingenieure im Jahr 2026

Die Arbeitsqualität eines Agenten ist direkt proportional zur Reinheit des Kontexts, den Sie ihm bereitstellen. Context Curation ist das digitale Äquivalent zur Sterilität am OP-Tisch: Überflüssige Instrumente werden entfernt, während die benötigten an ihren definierten Plätzen liegen.