Was macht Speicher?
Ein dateisystembasiertes Wissensmanagement-System, bei dem Quellcode DAS Gedächtnis ist. Speichern Sie Entscheidungen, Muster und Kontext in strukturierten Markdown-Dateien.
Wann verwenden
- Aufzeichnen von Architekturentscheidungen
- Dokumentieren von während der Entwicklung entdeckten Mustern
- Speichern von Kontext, warum etwas auf eine bestimmte Weise gebaut wurde
- Verfolgen bekannter Probleme und Workarounds
- Speichern von API-Dokumentation oder Integrationsnotizen
Wann NICHT verwenden
- Temporäre Debug-Notizen (dafür Kommentare verwenden)
- Aufgabenverfolgung (Git-Issues oder Projektboard verwenden)
Kernprinzipien
- Quellcode ist die einzige Quelle der Wahrheit
- Speichern Sie Wissen in der Nähe seiner Verwendung
- Verwenden Sie strukturiertes Markdown für Konsistenz
- Halten Sie Dateien fokussiert (ein Thema pro Datei)
Speicherorte
| Typ | Ort | Beispiel |
|---|---|---|
| Technische Doku | docs/technical/ | Architekturentscheidungen, Muster |
| Feature-Doku | docs/features/ | Feature-Spezifikationen, Anforderungen |
| API-Doku | docs/api/ | API-Verträge, Integrationsnotizen |
Speicheroperationen
Merken (Schreiben)
Neues Wissen speichern:
# [Thema]
## Kontext
[Warum dies existiert, welches Problem es löst]
## Entscheidung
[Was entschieden wurde und warum]
## Details
[Technische Details, Codebeispiele]
## Referenzen
- [Zugehörige Dateien oder URLs]
---
*Erstellt: [Datum]*
*Zuletzt aktualisiert: [Datum]*
Abrufen (Lesen)
Wissen abrufen:
- Überprüfen der Verzeichnisstruktur
docs/ - Lesen relevanter Dateien
- Suchen nach Schlüsselwörtern in Dokumentationen
Aktualisieren
Vorhandenes Wissen ändern:
- Lesen der bestehenden Datei
- Aktualisieren des relevanten Abschnitts
- Bei wesentlichen Änderungen zur Evolutionshistorie hinzufügen
Verwandte Skills
| Skill | Wann verketten |
|---|---|
| feature-dev | Speichern von Architekturentscheidungen während der Entwicklung |
| planning | Dokumentieren des Plans für zukünftige Referenz |