# Portabilität: UNIVERSAL
# Zuletzt validiert: 2026-02-08
# Nächste Prüfung: 2026-08-08
# Ressourcen: [system/ROADMAP.md]

STRATEGISCHE DOKUMENTE - METAKOGNITION
=======================================

STAND: 2026-02-08

ÜBERSICHT
----------
BACH verwendet drei zentrale Dokumente zur langfristigen Steuerung und Metakognition:

  system/ROADMAP.md      Vision, Phasen, langfristige Ziele
  system/CHANGELOG.md    Änderungshistorie (Versionen, Datum, Details)

Ergänzend:
- Lessons und strategische Erkenntnisse landen in memory/MEMORY.md.
- Bugs werden zusätzlich über das Task-System (Kategorie: maintenance/bug) getrackt.

EINORDNUNG IM MEMORY-SYSTEM
---------------------------

  +---------------------------------------------------------------+
  |                    METAKOGNITION (Strategie)                  |
  |  +-----------------------------------------------------------+|
  |  | system/ROADMAP.md  | system/CHANGELOG.md | memory/MEMORY.md||
  |  | docs/con3_*.md     | Analysen            |                 ||
  |  +-----------------------------------------------------------+|
  |                          |                                    |
  |                          | Ableitung                          |
  |                          v                                    |
  |  +-----------------------------------------------------------+|
  |  |                    TASK-SYSTEM (Planung)                  ||
  |  |  Konkrete, ausführbare Aufgaben                           ||
  |  |  bach task list / add / done                              ||
  |  +-----------------------------------------------------------+|
  |                          |                                    |
  |                          | Ausführung                         |
  |                          v                                    |
  |  +-----------------------------------------------------------+|
  |  |              MEMORY-SYSTEM (Operativ)                     ||
  |  |  memory_sessions | memory_lessons | memory_working        ||
  |  +-----------------------------------------------------------+|
  +---------------------------------------------------------------+

KREISLAUF:
  1. Strategie definiert Ziele (system/ROADMAP.md)
  2. Ziele werden zu Tasks (Task-System)
  3. Tasks erzeugen Aktivitäten (Sessions / Log)
  4. Ereignisse werden konsolidiert (bach consolidate)
  5. Ergebnisse aktualisieren Strategie (memory/MEMORY.md)

DOKUMENT-STILE
--------------

system/ROADMAP.md:
  - Fokus: Vision, Phasen, Meilensteine.
  - Granularität: Grobe Blöcke (z.B. "Phase 12: Steuer").
  - Ziel: Orientierung für Partner-Agenten (Wo stehen wir?).

memory/MEMORY.md:
  - Fokus: Kritische Erkenntnisse und Lessons Learned.
  - Stil: Strukturierte Dokumentation von Problemen und Lösungen.
  - Kategorien: Nach Feature/Modul organisiert.

KONSOLIDIERUNG ZU STRATEGIE
---------------------------
Dieser Prozess überführt operative Daten in strategische Dokumente:

  Rohdaten ---[bach session end]---> Sessions (DB)
  Sessions ---[bach consolidate compress]---> Context (DB)
  Tasks (done) ---[Manuelle Pflege]---> memory/MEMORY.md

BEFEHLE ZUR UNTERSTÜTZUNG:
  bach consolidate status                    Zeigt Konsolidierungs-Status
  bach consolidate compress --batch          Gruppiert Sessions (einfach)
  bach consolidate compress --run            Komprimiert mit Regelwerk
  bach consolidate review                    Erstellt Review-Tasks für Wiki/Doku
  bach consolidate run                       Führt alle Prozesse aus

SIEHE AUCH
----------
  docs/help/consolidation.txt     Memory-Konsolidierung
  docs/help/tasks.txt             Task-System
  docs/help/memory.txt            Memory-System
  system/ROADMAP.md          Aktuelle Phase & Meilensteine
  system/CHANGELOG.md        Änderungshistorie
  memory/MEMORY.md           Kritische Erkenntnisse & Lessons
