Daciemonistic497/large-codebase-survival

Was macht large-codebase-survival?

Verwalte große Codebasen mit KI-Agenten mithilfe einer bewährten Methodik, um Context-Window-Overflows und Session-Abstürze zu verhindern.

Überblick

Diese Fähigkeit ist für Entwickler gedacht, die KI-Assistenten wie Claude Code, Cursor oder Codex auf großen, komplexen Codebasen einsetzen. Das Hauptproblem bei der Arbeit mit großen Projekten ist die begrenzte Größe des Kontextfensters, was zu Überläufen führt, die den Agenten verwirren oder sogar die Sitzung zum Absturz bringen können.

Hauptfunktionen

• Modulare Dateistrukturierung: Organisiere Code in kleine, fokussierte Module, die einzeln in das Kontextfenster passen.
• Progressive Offenlegung: Beginne mit einer Übersicht und liefere Details nur bei Bedarf.
• Automatische Zusammenfassung: Erstelle Zusammenfassungen großer Dateien, um den Kontextverbrauch zu reduzieren.
• Caching: Speichere Zwischenergebnisse, um Wiederholungen zu vermeiden.
• Markdown-Navigation: Verwende Markdown-Dateien als Navigationshilfe zwischen Modulen.

Erste Schritte

1. Lege eine OVERVIEW.md-Datei im Stammverzeichnis deines Projekts an.
2. Teile deine Codebasis in Module auf (jedes in einer eigenen Datei oder einem eigenen Verzeichnis).
3. Füge in jede Datei einen Header mit Abhängigkeiten und einer kurzen Beschreibung ein.
4. Weise den Agenten an, bei Aufgaben zuerst die Übersichtsdatei zu lesen.

Beispiel-Übersicht

# Projektübersicht

- **src/utils.ts**: Hilfsfunktionen für String- und Array-Operationen.
- **src/api.ts**: API-Endpunkte und HTTP-Handler.
- **src/db.ts**: Datenbankverbindungen und Abfragen.
- **src/models.ts**: Datenmodelle und Typdefinitionen.

Methodik

1. Analysieren: Der Agent analysiert die Übersicht, um die benötigten Module zu identifizieren.
2. Anfordern: Der Agent fordert bei Bedarf den vollständigen Inhalt eines Moduls an.
3. Ändern: Der Agent nimmt Änderungen innerhalb der Kapazität des Kontextfensters vor.
4. Überprüfen: Der Agent überprüft die Änderungen und passt die Zusammenfassungen gegebenenfalls an.

Empfohlene Arbeitsabläufe

• Große Refactorings: Verwende eine Task-Liste (in einer .cursorrules- oder CLAUDE.md-Datei), um den Fortschritt zu verfolgen.
• Code-Reviews: Lass den Agenten nur geänderte Module analysieren.
• Dokumentationsgenerierung: Nutze die Übersichtsdatei, um konsistente Dokumentation zu erstellen.

Kompatibilität

Diese Fähigkeit ist mit folgenden Tools kompatibel:

• Claude Code
• Cursor
• GitHub Copilot Chat
• Codex CLI

Fehlerbehebung

• Context-Overflow: Teile die Aufgabe in kleinere Schritte auf.
• Session-Absturz: Reduziere die Anzahl der im Kontext gehaltenen Dateien.
• Inkonsistente Ausgaben: Stelle sicher, dass die Übersichtsdatei aktuell ist.

Lizenz

MIT