WIKI-KONVENTIONEN
=================

Stand: 2026-01-24

Regeln fuer die Erstellung und Pflege von Wiki-Artikeln in wiki/.

ORDNERSTRUKTUR
--------------
  wiki/
  ├── _index.txt              # Inhaltsverzeichnis (PFLICHT)
  ├── antigravity.txt         # Einzelne Artikel (allgemeines Wissen)
  ├── gemini.txt
  ├── local_dev.txt
  ├── wiki_konventionen.txt   # Diese Datei
  │
  ├── steuer/                 # Themenordner (Domain-Wissen)
  │   ├── _index.txt          # Unterverzeichnis
  │   ├── elster.txt
  │   └── fristen.txt
  │
  └── gesundheit/             # Weiterer Themenordner
      └── ...

Konvention: Ordner im wiki-Root sind entweder:
  - Einzelne .txt Dateien (allgemeines Wissen)
  - Themenordner/ mit eigenem _index.txt (Domain-Wissen)

DATEI-KLASSIFIZIERUNG
---------------------
Wiki-Dateien koennen unterschiedliche Portabilitaet haben:

  [UNIVERSAL]     Gilt fuer alle BACH-Installationen
                  Beispiele: antigravity.txt, gemini.txt, datev.txt
                  -> Bei Export/Installation mitnehmen

  [SYSTEM]        Gilt nur fuer dieses System (Pfade, lokale Config)
                  Beispiele: local_dev.txt, software_entwicklung.txt
                  -> Bei Neuinstallation NICHT mitnehmen oder anpassen

  [PRIVAT]        Persoenliche Daten (nicht teilen)
                  Beispiele: Steuer-Details, Gesundheitsdaten
                  -> Nie exportieren

Markierung: Am Anfang der Datei:
  # Portabilitaet: SYSTEM
  # Grund: Enthaelt lokale Pfade (C:\_Local_DEV)

DATEIFORMAT
-----------
  Dateiname:    kleinbuchstaben_mit_unterstrichen.txt
  Encoding:     UTF-8
  Zeilenende:   Unix (LF) oder Windows (CRLF)

  Struktur (mit Validierungsmetadaten):
    # Portabilitaet: UNIVERSAL
    # Zuletzt validiert: YYYY-MM-DD (Claude/BACH wiki-author)
    # Naechste Pruefung: YYYY-MM-DD
    # Quellen: [URL1], [URL2]

    TITEL IN GROSSBUCHSTABEN
    ========================

    Stand: YYYY-MM-DD

    WAS IST X?
    ----------
    Kurze Erklaerung (1-3 Saetze)

    DETAILS
    -------
    Ausfuehrliche Informationen...

    SIEHE AUCH
    ----------
    wiki/verwandt.txt    Beschreibung

VALIDIERUNGSMETADATEN (NEU 2026-01-24)
--------------------------------------
Jeder Wiki-Artikel sollte folgende Metadaten am Dateianfang haben:

  # Portabilitaet: UNIVERSAL|SYSTEM|PRIVAT
  # Zuletzt validiert: YYYY-MM-DD (Autor)
  # Naechste Pruefung: YYYY-MM-DD
  # Quellen: [URL1], [URL2]

Bedeutung:
  Zuletzt validiert  Wann wurden die Fakten zuletzt geprueft?
  Naechste Pruefung  Wann sollte erneut geprueft werden?
                     (Empfehlung: 6-12 Monate je nach Thema)
  Quellen            Woher stammen die Informationen?

Der Wiki-Autoren-Service aktualisiert diese Metadaten automatisch.

THEMENORDNER ANLEGEN
--------------------
Wann einen Themenordner statt einzelner Datei?
  - Mehr als 3 zusammengehoerige Artikel
  - Eigenes Fachgebiet (Steuer, Gesundheit, Haushalt)
  - Agent verweist auf gesamtes Thema
  - Agent/Experte hat eigenes Wissensgebiet

Struktur:
  wiki/thema/
  ├── _index.txt      # PFLICHT: Inhaltsverzeichnis
  ├── grundlagen.txt  # Einstiegsartikel
  └── details.txt     # Vertiefung

AGENTEN/EXPERTEN-WISSENSORDNER (NEU 2026-01-24)
-----------------------------------------------
Agenten und Experten mit umfangreichem Fachwissen bekommen
eigene Wiki-Ordner:

  wiki/foerderung/       # Fuer foerderplaner Agent
  ├── _index.txt
  ├── icf.txt                 # ICF-Klassifikation
  ├── teacch.txt              # TEACCH-Methode
  └── pecs.txt                # PECS-Kommunikation

  wiki/steuer/           # Fuer steuer-experte
  ├── _index.txt
  ├── elster.txt
  └── fristen.txt

Namenskonvention fuer Ordner:
  - Agent-Name ohne Suffix: foerderplaner -> foerderung/
  - Themenbereich: steuer-experte -> steuer/
  - Kleinbuchstaben, keine Unterstriche im Ordnernamen

AGENTEN-VERWEIS
---------------
Agenten koennen auf Wiki-Ordner verweisen:

  agents/steuer-agent.txt:
    Kontext: wiki/steuer/

  Bedeutet: Agent laedt alle Artikel aus dem Ordner als Hintergrundwissen.

ABGRENZUNG ZU HELP
------------------
  docs/help/*.txt           WIE benutze ich BACH? (Anleitungen)
  wiki/*.txt      WAS ist X? (Hintergrundwissen)
  docs/help/tools/*.txt     Tool-Dokumentation (Auto-generiert)

BEISPIEL: SYSTEM-SPEZIFISCHE DATEI
----------------------------------
Datei: wiki/local_dev.txt

  # Portabilitaet: SYSTEM
  # Grund: Beschreibt C:\_Local_DEV - existiert nur auf diesem System

  C:\_LOCAL_DEV - LOKALER WORKSPACE & BACKUP
  ==========================================
  ...

DATENFORMATE-RICHTLINIE
-----------------------
Fuer Konfigurationsdaten gilt: DATENBANK VOR JSON.

Wiki-Artikel beschreiben Konzepte, sie speichern keine Daten.
Wenn ein Agent oder Skill Daten speichern muss:
  → Pruefe erst: Gehoert das in bach.db?
  → JSON nur bei begruendeten Ausnahmen
  → Details: docs/help/formats.txt

SIEHE AUCH
----------
  wiki/_index.txt        Inhaltsverzeichnis
  docs/help/practices.txt          BACH Best Practices
  docs/help/formats.txt            Datenformate (JSON vs DB)
  skills/AGENT_KONVENTION.md  Agent-Dokumentations-Standard
