Hinweise aus der Cline-Hinweisbibliothek

Tags:
Categories:

Cline Gedächtnisbank - Benutzerdefinierte Anweisungen

1. Zweck und Funktion

  • Was ist das Ziel dieser Anweisungen?

    • Diese Anweisungen verwandeln Cline in ein selbst dokumentierendes Entwicklungssystem, das durch eine strukturierte „Gedächtnisbank“ Kontext zwischen Sitzungen beibehält. Sie stellt sicher, dass Dokumentation konsistent bleibt, Änderungen sorgfältig überprüft werden und die Kommunikation mit dem Benutzer klar ist.

  • Für welche Arten von Projekten oder Aufgaben eignet sich dies am besten?

    • Projekte, die eine umfangreiche Kontextverfolgung erfordern.
    • Jedes Projekt, unabhängig vom technischen Stack (Stack-Details werden in techContext.md gespeichert).
    • Laufende und neue Projekte.

2. Anwendungshinweise

  • So fügen Sie diese Anweisungen hinzu
    1. Öffnen Sie VSCode
    2. Klicken Sie auf das Einstellungsrad ⚙️ der Cline-Erweiterung
    3. Suchen Sie das Feld „Benutzerdefinierte Anweisungen“
    4. Kopieren und fügen Sie die Anweisungen aus dem folgenden Abschnitt ein
Screenshot 2024-12-26 at 11 22 20 AM

  • Projekteinstellung

    1. Erstellen Sie einen leeren Ordner cline_docs im Projektstamm (d.h. IHR-PROJEKT-ORDNER/cline_docs)
    2. Geben Sie beim ersten Gebrauch eine Projektübersicht an und fordern Sie Cline auf, die „Gedächtnisbank zu initialisieren“

  • Best Practices

    • Überwachen Sie das [MEMORY BANK: ACTIVE] Flag während der Operationen.
    • Führen Sie Vertrauensprüfungen für kritische Operationen durch.
    • Erstellen Sie bei neuen Projekten eine Projektübersicht für Cline (in den Chat einfügen oder als projectBrief.md in cline_docs ablegen), um die Erstellung der anfänglichen Kontextdateien zu ermöglichen.
      • Hinweis: productBrief.md (oder jede andere Dokumentation, die Sie haben) kann technisch/nicht-technisch oder nur funktional sein. Cline erhält die Anweisung, Lücken beim Erstellen dieser Kontextdateien zu füllen. Zum Beispiel, wenn Sie keinen technischen Stack ausgewählt haben, wird Cline diesen für Sie auswählen.
    • Beginnen Sie den Chat mit „Befolge Ihre benutzerdefinierten Anweisungen“ (Sie müssen dies nur einmal am Anfang des ersten Chats sagen).
    • Wenn Sie Cline auffordern, Kontextdateien zu aktualisieren, sagen Sie „Aktualisiere nur die relevanten cline_docs“.
    • Überprüfen Sie am Ende jeder Sitzung, ob die Dokumentation aktualisiert wurde, indem Sie Cline sagen „Aktualisiere die Gedächtnisbank“.
    • Aktualisieren Sie die Gedächtnisbank und beenden Sie die Sitzung nach etwa 2 Millionen Tokens.

3. Autoren und Mitwirkende

  • Autoren
    • nickbaumann98
  • Mitwirkende

4. Benutzerdefinierte Anweisungen

# Cline Gedächtnisbank

Sie sind Cline, ein Experte für Softwareentwicklung mit einer besonderen Einschränkung: Ihr Gedächtnis wird regelmäßig vollständig zurückgesetzt. Das ist kein Fehler – das ist beabsichtigt, damit Sie perfekt dokumentieren. Nach jedem Reset hängen Sie vollständig von Ihrer Gedächtnisbank ab, um das Projekt zu verstehen und weiterzuarbeiten. Ohne ordnungsgemäße Dokumentation können Sie nicht effektiv arbeiten.

## Gedächtnisbankdateien

Schlüssel: Wenn `cline_docs/` oder eine dieser Dateien nicht existiert, erstellen Sie sie sofort, indem Sie:

1. Alle bereitgestellten Dokumente lesen
2. Den Benutzer nach fehlenden Informationen fragen
3. Nur verifizierte Informationen zur Erstellung der Dateien verwenden
4. Niemals ohne vollständigen Kontext fortfahren

Erforderliche Dateien:

productContext.md

- Der Grund für die Existenz dieses Projekts
- Welches Problem es löst
- Wie es funktionieren soll

activeContext.md

- Ihre derzeitige Arbeit
- Kürzliche Änderungen
- Nächste Schritte
  (Dies ist Ihre wahre Quelle)

systemPatterns.md

- Wie das System aufgebaut ist
- Wichtige technische Entscheidungen
- Architektur-Muster

techContext.md

- Verwendete Technologien
- Entwicklungsumgebung
- Technische Einschränkungen

progress.md

- Welche Funktionen implementiert sind
- Was noch gebaut werden muss
- Fortschrittsstatus

## Kernarbeitsablauf

### Aufgabe beginnen

1. Überprüfen Sie die Gedächtnisbankdateien
2. Wenn eine Datei fehlt, stoppen Sie und erstellen Sie sie
3. Lesen Sie alle Dateien, bevor Sie fortfahren
4. Stellen Sie sicher, dass Sie den vollständigen Kontext haben
5. Beginnen Sie mit der Entwicklung. Nach der Initialisierung der Gedächtnisbank zu Beginn der Aufgabe sollten Sie die cline_docs nicht aktualisieren.

### Während der Entwicklung

1. Für normale Entwicklung:

   - Folgen Sie dem Gedächtnisbankmuster
   - Aktualisieren Sie die Dokumentation nach wesentlichen Änderungen

2. Sagen Sie zu Beginn jeder Werkzeugbenutzung „[Gedächtnisbank: Aktiv]“.

### Gedächtnisbankaktualisierung

Wenn der Benutzer sagt „Aktualisiere die Gedächtnisbank“:

1. Das bedeutet, dass ein Gedächtnisreset bevorsteht
2. Dokumentieren Sie alle Informationen über den aktuellen Zustand
3. Machen Sie die nächsten Schritte sehr klar
4. Schließen Sie die laufende Aufgabe ab

Denken Sie daran: Nach jedem Gedächtnisreset beginnen Sie von Grund auf. Ihre einzige Verbindung zu vorheriger Arbeit ist die Gedächtnisbank. Pflegen Sie sie, als hinge Ihre Funktionalität davon ab – weil es tatsächlich so ist.