---
name: wissensspeicher
description: Liest und schreibt Notizen im persönlichen Wissensspeicher (Markdown-Vault, z.B. Obsidian). Nutze diesen Skill IMMER, wenn Wissen, Projekt-Doku, Kunden-Infos, Ideen oder Notizen gespeichert, aktualisiert oder abgerufen werden sollen: "leg das im Wissensspeicher ab", "dokumentiere das", "was wissen wir über X?", "aktualisiere die Projekt-Doku" — auch ohne das Wort "Skill".
---

# Wissensspeicher — lesen und schreiben

Anweisung für KI-Werkzeuge (Claude, ChatGPT und andere), damit sie einen
Markdown-Wissensspeicher regelkonform pflegen statt Dateien irgendwohin zu legen.

Vorlage von Bartel Media — <https://bartel-media.de>. Passe die markierten Stellen an
deine Umgebung an, dann funktioniert der Rest unverändert.

## Wurzelverzeichnis ermitteln — immer zuerst

```sh
VAULT_ROOT=$(cat ~/.config/wissensspeicher/path.txt)
```

**Nie hart eincodieren.** Der Pfad unterscheidet sich je Rechner und Benutzer.
Reihenfolge: Umgebungsvariable `$VAULT_ROOT` → die Datei oben → Rückfall
`~/Wissensspeicher`. Liefert keiner davon einen existierenden Ordner: **nicht raten,
sondern nachfragen.**

## Grundregeln

1. **Erst lesen, dann schreiben.** Vor dem Anlegen einer Notiz die `index.md` des
   Bereichs öffnen. Existiert schon etwas zum Thema, wird es ergänzt, nicht dupliziert.
2. **Dateinamen**: Kleinbuchstaben, Bindestriche, keine Umlaute
   (`ae`, `oe`, `ue`, `ss`), Endung `.md`.
3. **Jede neue Notiz** bekommt Frontmatter (siehe unten).
4. **Nach jedem Anlegen, Umbenennen oder Löschen**: `index.md` des Ordners
   aktualisieren. Neuer Ordner → eigene `index.md` plus Eintrag im übergeordneten Index.
5. **Pro Arbeitssitzung** ein Eintrag in der `log.md` im Wurzelverzeichnis:
   Überschrift `## JJJJ-MM-TT`, neueste oben, zwei bis drei Zeilen, was passiert ist.
6. **Große Dateien gehören nicht hinein.** Videos und Rohmaterial extern ablegen und
   nur verlinken.

## Frontmatter

```markdown
---
title: Sprechender Titel
type: wissen | projekt | kontakt | index | log
status: aktiv | abgeschlossen | archiv
date: JJJJ-MM-TT
aktualisiert: JJJJ-MM-TT
tags: [thema, werkzeug, kunde]
bewertung: verifiziert | ungeprueft | veraltet
---
```

`bewertung` ist das wichtigste Feld und wird gern übersehen: **`verifiziert` nur
setzen, wenn ein Mensch es ausdrücklich bestätigt hat.** Alles andere ist
`ungeprueft`. Ohne diese Unterscheidung wird aus einer Vermutung nach drei Monaten
eine vermeintliche Tatsache.

## Links

**Notiz → Notiz** als Wikilink mit vollem Pfad ab der Wurzel und Anzeigetext:

```markdown
[[kunden/mueller/kontakt|Ansprechpartner Müller]]
[[wiki/server/backup-strategie#Wiederherstellung|Wiederherstellung]]
```

Nie nur den Dateinamen verwenden — bei gleichnamigen Dateien in mehreren Ordnern
landet der Link sonst irgendwo.

**Notiz → Anhang** als relativer Markdown-Link, damit er auch außerhalb der App
funktioniert:

```markdown
[Rechnung Juli](assets/rechnung-2026-07.pdf)
```

**Vor dem Verlinken den Zielpfad prüfen.** Ein Wikilink auf eine nicht existierende
Notiz legt beim Anklicken eine leere Datei an, statt einen Fehler zu zeigen.

## Wohin gehört was

| Inhalt | Ziel |
|---|---|
| Kundeninfos, Ansprechpartner | `kunden/<slug>/` |
| Kundenprojekte | `kunden/<slug>/projekte/` |
| Eigene Vorhaben | `projekte-intern/<slug>/` |
| Technikwissen, Anleitungen | `wiki/<thema>/` |
| Betrieb, Entwürfe, Gesprächsnotizen | `agentur/` |
| Persönliches | `privat/` |
| Unklar oder eilig | `inbox/` (später einsortieren) |

Passt nichts davon: **nachfragen**, keinen neuen Bereich erfinden.

## Was dieser Skill NICHT tut

- Keine Massen-Umbauten über hunderte Dateien ohne ausdrückliche Ansage. In einem
  synchronisierten Vault sind Umbenennen und Löschen die riskantesten Operationen.
- Keine Zugangsdaten im Klartext ablegen. Verweise auf den Passwortspeicher, nicht
  das Passwort selbst.
- Keine app-spezifische Syntax außer Wikilinks. Der Speicher muss ohne die App
  lesbar bleiben.

## Wenn synchronisiert wird

Läuft der Vault über einen Sync-Dienst, gilt:

- **Vor Änderungen die Datei frisch einlesen** — jemand anderes könnte gerade
  geschrieben haben.
- **Nach dem Schreiben melden, welche Dateien angefasst wurden**, damit
  Nachvollziehbarkeit besteht.
- Synchronisiert der Dienst **nur bei geöffneter App**, darf bei geschlossener App
  nicht geschrieben werden — sonst kann der Server die lokale Fassung überschreiben.
  Mit einem Hintergrund-Sync entfällt diese Einschränkung.