Die Agenten lesen Ihren Code sowie die Anweisungsdateien Ihres Repositorys. Kontext kombiniert diese Speicherdateien mit Projektnotizen, generiertem Kontext und Referenzen.
Lesen Sie die Begründung dafür, warum dies hier platziert ist, unter Projektkontext in den Konzepten. Diese Seite behandelt die Verwaltung davon.
Speicherdateien des Repositorys
Öffnen Sie Einstellungen → Wissen → Kontext und schauen Sie unter Repository-Quellen. Coroid liest diese Dateien aus dem verbundenen Repository:
AGENTS.mdim Repository-Stammverzeichnis: allgemeine AgentenanweisungenCLAUDE.mdim Repository-Stammverzeichnis: Claude-AnweisungenGEMINI.mdim Repository-Stammverzeichnis: Gemini-Anweisungen.cursor/rules: Cursor-Regeln für das Projekt, entweder das Verzeichnis von.mdcRegeldateien (einschließlich Unterordner) oder eine einzelne Legacy-Datei
Diese werden oft als Speicherdateien bezeichnet. Ihre aktivierten Inhalte werden vor Arbeitsbeginn in den Projektkontext der Agenten einbezogen. Die Namen beschränken sie nicht auf ein bestimmtes Modell: Aktivierte Quellen werden für die Agenten von Coroid kombiniert.
Vorhandene Dateien werden mit einem Bearbeiten Aktion, einer geschätzten Tokenanzahl und einem Schalter angezeigt, der steuert, ob die Agenten sie erhalten. Quellen sind standardmäßig aktiviert, es sei denn, Sie deaktivieren sie explizit. Falls mehrere Dateien übereinstimmen oder sich widersprechen, aktivieren Sie nur die Quellen, denen die Agenten folgen sollen, und deaktivieren Sie die anderen.
Wenn Sie Änderungen an einem Projekt mit einem verbundenen GitHub- oder GitLab-Repository speichern, wird ein pull request mit der Änderung auf einem neuen Branch vom Basis-Branch des Projekts pull request geöffnet. Coroid commitet nicht zum Standard-Branch, und die Agenten lesen die neue Version erst, nachdem der pull request gemergt wurde. Bei einem Projekt, dessen Repository von Coroid gehostet wird, erfolgt der Commit stattdessen. Der Editor weist Sie darauf hin, bevor Sie speichern.
Coroid liest die Cursor-Regeln genauso wie Cursor sie anwendet:
| Regel | Was die Agenten erhalten |
|---|---|
alwaysApply: true | Die gesamte Regel |
globs Ausschnitt | Die gesamte Regel samt den Dateien, auf die sie anwendbar ist |
Nur ein description | Der Pfad und die Beschreibung der Regel, damit der Agent sie liest, wenn sie relevant ist |
| Keines davon | Nichts: Cursor wendet sie nur an, wenn jemand darauf verweist. |
Eine einfache .md Datei in .cursor/rules wird ignoriert, da Cursor sie ebenfalls ignoriert. Regeln im Verzeichnis werden im Repository bearbeitet, weshalb diese Zeile keine Bearbeiten Aktion aufweist.
Erstellen bedeutet, dass die Datei in der Auscheckung des Coroid-Repositorys nicht gefunden wurde. Falls ein Lesevorgang fehlschlägt, bietet die Seite Wiederholenan; ein Zugriffsfehler bedeutet nicht, dass die Datei fehlt. Prüfen Sie, ob die Datei zum Branch des verbundenen Repositorys committet wurde. Für die Aufgabenausführung lesen die Agenten die Auscheckung der Aufgabe, sodass Änderungen an den Anweisungsdateien in diesem Branch für die Aufgabe gelten.
Aktivierte Speicherdateien können Markdown aus dem Repository über @pathimportieren, zum Beispiel
@AGENTS.md in CLAUDE.md oder @docs/conventions.md. Die Pfade werden relativ zur Datei mit dem Verweis aufgelöst. Coroid verarbeitet verschachtelte Imports, stoppt Zyklen und fügt jede Datei sowie jeden identischen Anweisungstext nur einmal ein. Imports innerhalb von Codebeispielen und E-Mail-Adressen bleiben unberührt. Externe Referenzen werden nicht geladen, und Imports können eine explizit deaktivierte Repository-Quelle nicht umgehen.
Nur die aufgeführten Quellen werden automatisch erkannt. Ein verschachteltes AGENTS.md kann über einen @ Import eingebunden werden; sein Verzeichnisumfang wird nicht inferiert.
App-Kontexte
Unter App-Kontexte, werden Anweisungen und Referenzen in Coroid gespeichert. Manuelle Notizen und generierter Projektkontext können unabhängig von Repository-Dateien aktiviert oder deaktiviert werden. Nutzen Sie diese Einträge für Informationen, die außerhalb von Git liegen.
Kontext hinzufügen
Wählen Sie Kontext hinzufügen und fügen Sie einen Eintrag hinzu. Jeder Eintrag hat einen Titel und einen Inhalt und kann später bearbeitet oder entfernt werden.
Gute Einträge sind kurz, spezifisch und langlebig. Architekturentscheidungen, Stilkonventionen, API-Verträge, Zuständigkeitsbereiche und explizite Verbote gehören dazu. Onboarding-Narrative und alles, was bereits aus dem Repository ersichtlich ist, nicht.
Halten Sie die Einträge getrennt und benennen Sie sie klar
Ein Eintrag pro Thema, mit einem Titel, der seinen Inhalt beschreibt. „Fehlerbehandlungskonventionen“ und „Gefrorene Module“ sind leicht auffindbar; ein einzelner Eintrag namens „Notizen“, der beides enthält, ist es nicht.
Das ist wichtig, weil der Kontext selektiv je nach aktueller Aufgabe geladen wird – siehe Progressive Fähigkeiten. Gut getrennte Einträge sorgen dafür, dass der richtige Eintrag für die richtige Aufgabe geladen wird.
Referenzen
Neben schriftlichen Einträgen können Sie Referenzen anfügen – Links und Dokumente, die auf externes Material verweisen. Nutzen Sie diese, wenn die autoritative Kopie in einer Wiki oder Design-Tool-Anwendung gespeichert ist und Sie keine zweite, veraltete Kopie erstellen möchten.
Aufgabenspezifischer Kontext
Der Projektkontext gilt für alle darin enthaltenen Elemente. Für Material, das zu einem einzelnen Arbeitsschritt gehört – einem Ticket, einem Kundenbericht oder einem Design-Dokument – fügen Sie es stattdessen der jeweiligen Aufgabe hinzu. Ein aufgabenspezifischer Hinweis im Projektkontext wird bei jeder zukünftigen Aufgabe zum unnötigen Lärm.
Aktualität gewährleisten
Veralteter Kontext ist schlimmer als fehlender Kontext, da die Agenten ihn als autoritativ betrachten. Wenn sich eine Vorgehensweise ändert, aktualisieren Sie den entsprechenden Eintrag im selben Änderungsvorgang wie den Code.
Den vorhandenen Kontext überprüfen
Lesen Sie Ihren Kontext gelegentlich, als wären Sie neu dabei. Einträge sammeln sich an, und die aus einer vor einem Jahr abgeschlossenen Migration stammenden Hinweise sind mittlerweile aktiv irreführend.