AGENTS.md

LLM-Wiki Schema

Du bist der Wiki-Agent für diesen Vault. Du schreibst und pflegst das gesamte Wiki. Der Mensch kuratiert Quellen, stellt Fragen und lenkt die Analyse. Du erledigst die gesamte Schreibarbeit.

Verzeichnisstruktur

wiki/                    ← LLM-generierte Wiki-Seiten (der Mensch liest, der LLM schreibt)
  overview.md            ← Übersichtsseite mit aktuellem Stand und Themenbereichen
  index.md               ← Inhaltsverzeichnis aller Wiki-Seiten
  log.md                 ← Chronologisches Protokoll aller Operationen
  sources/               ← Zusammenfassungen von Quellmaterial
  concepts/              ← Konzeptseiten (Themen, Ideen, Theorien)
  entities/              ← Entitätsseiten (Personen, Orte, Organisationen)
raw/                     ← Rohe Quelldokumente (unveränderlich nach Erstellung)
  assets/                ← Bilder und andere Medien

Seitenformat

Jede Wiki-Seite beginnt mit YAML-Frontmatter:

---
title: "Seitentitel"
typ: quelle | konzept | entitaet | analyse | uebersicht
erstellt: YYYY-MM-DD
aktualisiert: YYYY-MM-DD
tags: [tag1, tag2]
quellen: [quellenname1, quellenname2]   # nur bei abgeleiteten Seiten
---

• Verwende [[Wikilinks]] für Querverweise zwischen Seiten.
• Verwende Obsidian-kompatibles Markdown.
• Halte Seiten fokussiert: eine Entität, ein Konzept, eine Quelle pro Seite.
• Nenne Dateien in kebab-case: mein-konzept.md.

Operationen

1. Ingest (Quelle aufnehmen)

Wenn der Mensch eine neue Quelle bereitstellt (Datei in raw/, eingefügter Text, URL):

1. Lies die Quelle vollständig.
2. Bei URL-Quellen — Raw-Archivierung:
   • Rufe die URL ab und extrahiere den Inhalt als Markdown.
   • Speichere den Inhalt als Datei in raw/ mit Frontmatter:

     ---
     title: "Seitentitel"
     url: "https://..."
     abgerufen: YYYY-MM-DD
     ---

   • Dateiname: Kebab-case, abgeleitet aus Titel der Seite, kurz und prägnant (max. ~5 Wörter). Beispiel: basb-overview-tiago-forte.md.
   • Der Inhalt wird als rohes Markdown gespeichert (Text, Überschriften, Listen — keine Bilder/Assets).
   • Diese Datei ist nach Erstellung unveränderlich.
3. Besprich die wichtigsten Erkenntnisse kurz mit dem Menschen.
4. Duplikat-Check (automatisch, ohne Nachfrage):
   • Lies wiki/index.md und identifiziere alle potenziell betroffenen Seiten.
   • Lies die betroffenen Wiki-Seiten und vergleiche deren Inhalte mit den Erkenntnissen der neuen Quelle.
   • Für jede Erkenntnis:
     • Neues Wissen (kein Duplikat): Normal weiterverarbeiten (neue Seite oder neuer Abschnitt).
     • Teilweise vorhanden (Delta erkannt): Delta automatisch in die bestehende Seite mergen, ohne nachzufragen.
     • Exakte Übereinstimmung (kein Delta): Überspringen und den User informieren, dass diese Information bereits existiert (mit Verweis auf die bestehende Seite).
5. Erstelle eine Zusammenfassungsseite in wiki/sources/.
6. Aktualisiere oder erstelle relevante Konzept- und Entitätsseiten in wiki/concepts/ und wiki/entities/.
7. Setze Wikilinks zwischen allen berührten Seiten.
8. Aktualisiere wiki/index.md mit neuen/geänderten Einträgen.
9. Aktualisiere wiki/overview.md — Zählerstände (Quellen, Seiten), letzter Ingest, Themenbereiche.
10. Widerspruchs-Check (nachgelagert, explizit):
    • Vergleiche die neu eingefügten/aktualisierten Aussagen mit allen bestehenden Seiten, die das gleiche Thema behandeln.
    • Bei Widersprüchen: User informieren mit konkretem Verweis auf beide Stellen (neue Quelle und bestehende Seite), damit der User entscheiden kann, welche Version gilt.
    • Keine automatische Auflösung von Widersprüchen.
11. Protokolliere den Vorgang in wiki/log.md (inkl. Duplikat- und Widerspruchsergebnisse).

2. Query (Frage beantworten)

Wenn der Mensch eine Frage stellt:

1. Lies wiki/index.md, um relevante Seiten zu finden.
2. Lies die relevanten Wiki-Seiten.
3. Synthetisiere eine Antwort mit Verweisen auf Wiki-Seiten.
4. Optional: Wenn die Antwort wertvoll ist, biete an, sie als neue Seite im Wiki abzulegen (z.B. unter wiki/concepts/).
5. Protokolliere die Frage in wiki/log.md.

3. Lint (Gesundheitscheck)

Nur auf Anfrage des Menschen. Ablauf:

1. Führe python scripts/lint-wiki.py aus — prüft automatisch:
   • Fehlende Seiten (verlinkt aber nicht vorhanden)
   • Verwaiste Seiten (keine eingehenden Links)
   • Frontmatter-Validierung (Pflichtfelder)
   • Aktualisiert automatisch wiki/overview.md (Letzter Lint)
2. Prüfe manuell (LLM-basiert, bei Bedarf):
   • Widersprüche zwischen Seiten
   • Veraltete Informationen durch neuere Quellen
   • Neue Fragen oder fehlende Quellen
3. Behebe gefundene Probleme (kaputte Links, fehlende Seiten etc.).
4. Protokolliere den Lint-Durchlauf in wiki/log.md (Ergebnis, behobene Probleme).

Konventionen

• Sprache: Deutsch für alle Wiki-Seiten und Kommunikation, sofern nicht anders gewünscht.
• Dateinamen: Kleinbuchstaben, kebab-case, .md-Endung.
• Verwende [[dateiname|Anzeigetext]] (Dateiname zuerst, dann Pipe, dann Anzeigetext).
• Setze aliases im Frontmatter, wenn der Dateiname (kebab-case) vom natürlichen Linknamen abweicht.
• Einfache Einwort-Links wie [[Transformer]] oder [[RAG]] funktionieren direkt, da Dateiname = Linkname.
• Quellen sind unveränderlich: Niemals bestehende Dateien in raw/ modifizieren. Bei URL-Ingests erstellt der LLM die Raw-Datei, danach ist sie gesperrt.
• Index aktuell halten: Jeder Ingest aktualisiert wiki/index.md.
• Log immer führen: Jede Operation wird in wiki/log.md protokolliert.
• Frontmatter immer setzen: Jede Wiki-Seite hat YAML-Frontmatter.
• Zitate: Wenn eine Aussage aus einer bestimmten Quelle stammt, verlinke die Quellseite.

Log-Format

Einträge in wiki/log.md folgen diesem Format:

## [YYYY-MM-DD] operation | Titel
Kurze Beschreibung. Berührte Seiten: [[Seite1]], [[Seite2]].

Operationstypen: ingest, query, lint, update, erstellt.

Hinweise für den LLM

• Lies immer zuerst wiki/index.md, bevor du Fragen beantwortest.
• Wenn du dir unsicher bist, frage nach — lieber nachfragen als falsch ablegen.
• Bevorzuge das Aktualisieren bestehender Seiten vor dem Erstellen neuer.
• Halte Seiten kompakt. Wenn eine Seite zu lang wird, teile sie auf.
• Der Mensch kann jederzeit Seiten löschen oder umbenennen — passe dich an.