# Portabilität: UNIVERSAL
# Zuletzt validiert: 2026-02-08
# Nächste Prüfung: 2026-08-08

GUIDELINES - Dokumentations-Standards
=====================================

STAND: 2026-02-08

DREISTUFIGES SYSTEM
-------------------
1. OPERATIV (docs/help/*.txt)
   - WIE benutze ich BACH?
   - Fokus: CLI-Befehle, Anleitungen, Referenzen.
   - Format: TXT (ASCII-kompatibel, max. 250 Zeilen).

2. WISSEN (wiki/*.txt)
   - WAS ist X?
   - Fokus: Hintergrundwissen, Domänen-Wissen, KI-Theorie.
   - Format: TXT (ASCII-kompatibel).

3. KONZEPTIONELL (skills/**/*.md, docs/*.md)
   - WARUM & WIE ist es gebaut?
   - Fokus: Architekturen, Workflows, tiefere Analysen.
   - Format: MarkDown (reich bebildert/strukturiert).

METADATEN-PFLICHT (NEU 2026-01)
-------------------------------
Jede Dokumentationsdatei MUSS folgenden Header haben:

  # Portabilität: UNIVERSAL | SYSTEM | USER
  # Zuletzt validiert: YYYY-MM-DD
  # Nächste Prüfung: YYYY-MM-DD
  # Quellen: [Optional]

Prüfungs-Intervalle:
  SYSTEM:    +3 Monate  (code-gekoppelt, aendert sich haeufig)
  UNIVERSAL: +6 Monate  (allgemein gueltig, stabil)
  USER:      +12 Monate (nutzer-spezifisch, langlebig)

TX/TXT-STRUKTUR (Klassisch)
---------------------------
  TITEL IN GROSSBUCHSTABEN
  ========================
  [Metadaten-Header]

  BESCHREIBUNG
  [Was macht dieses Feature]

  BEFEHLE
  bach [befehl] [argumente]

  BEISPIELE
  [Konkrete Anwendungsfälle]

  SIEHE AUCH
  [Links zu anderen docs/help/ oder wiki/ Dateien]

LEBENSZYKLUS ANALYSEN
---------------------
1. ERSTELLUNG: user/ANALYSE_Thema.md
2. AUSWERTUNG: Erkenntnisse → docs/help/ ODER wiki/. Aufgaben → Tasksystem.
3. ARCHIVIERUNG: Verschieben nach user/_archive/ nach Abschluss.

NAMING CONVENTIONS
------------------
docs/help/<thema>.txt          Einfaches Thema
docs/help/<befehl>.txt         CLI-Befehl-Dokumentation
wiki/<spezial>.txt   Externes Wissen

SKILL_<n>.md              Skill-Dokumentation
KONZEPT_<n>.md            Konzept-Dokument
<n>_ANALYSE.md            Analyse-Bericht
<Thema>_Vorschlag.md      Vorschläge (awaiting approval)

QUALITAETSKRITERIEN
-------------------
docs/help/*.txt Dateien:
- Max. 250 Zeilen (empfohlen unter 150)
- Keine Markdown-Syntax (ASCII-kompatibel)
- Alle Befehle dokumentiert
- Mindestens 1 Beispiel
- SIEHE AUCH Verweis

SIEHE AUCH
----------
user/_archive/Guidelines_Vorschlag.md    Vollständiges Konzept (archiviert)
bach --help practices                    Architektur-Prinzipien
bach --help naming                       Naming Conventions
