docs: compact project handoff workflow

2026-07-30 16:39:10 +02:00
parent 0e82748223
commit e6eb99556a
9 changed files with 1386 additions and 1230 deletions
@@ -13,4 +13,6 @@
 - Rootserver und Ubuntu-Laptop nur nach gesonderter Freigabe verändern.
 - Aktualisiere `docs/CHATGPT_HANDOFF.md` nach jedem abgeschlossenen logischen Arbeitspaket mit Ergebnis, Änderungen, Tests, Git-Stand, offenen Punkten und nächstem Schritt. Einzelne Such- oder Prüfkommandos benötigen keinen eigenen Zwischenstand.
 - Aktualisiere nach wesentlichen Sitzungen `docs/PROJECT_STATUS.md`, `docs/DECISIONS.md`, `docs/NEXT_SESSION.md`, `docs/CHATGPT_HANDOFF.md` und `CHANGELOG.md`.
 - Überarbeite den kompakten Handoff in seiner festen Struktur, statt Sitzungsabschnitte anzuhängen; Zielgröße höchstens ungefähr 300 Zeilen.
 - Halte `docs/PROJECT_STATUS.md` unter ungefähr 200 und `docs/NEXT_SESSION.md` unter ungefähr 100 Zeilen. Archiviere historische Details nur bei echten Meilensteinen.
 - Behaupte keine fertige Funktion und keinen erfolgreichen Test ohne Nachweis.
@@ -18,6 +18,7 @@ Alle wesentlichen Projektänderungen werden hier in verständlicher Form dokumen
 - Der historische Verbindungstest aus `READ.ME` wurde in `README.md` übernommen.
 - Tokenbewusste Arbeitsweise als dauerhafte Regel ergänzt; Qualität und Sicherheit bleiben vorrangig.
 - Laufende Handoff-Aktualisierung nach jedem abgeschlossenen logischen Arbeitspaket festgelegt.
 - Vollständigen Erst-Handoff einmalig archiviert und die laufende Übergabe auf einen kompakten aktuellen Stand umgestellt.
 ### Security
@@ -6,6 +6,7 @@
 | ADR-0002 | Secrets bleiben außerhalb von Modellkontext und Git | angenommen |
 | ADR-0003 | Obsidian-Links benötigen echte inhaltliche Beziehungen | angenommen |
 | ADR-0004 | Tokenbewusst arbeiten, ohne Qualität oder Sicherheit zu senken | angenommen |
 | ADR-0005 | Laufenden Handoff kompakt halten und Vollstände nur zu Meilensteinen archivieren | angenommen |
 Offen bleiben insbesondere die konkrete lokale Modelllaufzeit, das endgültige Runtime-Secret-System, der genaue Obsidian-Schreibbereich und der Produktname.
@@ -2,7 +2,7 @@
 ## Ziel
-Pascal prüft zuerst das Grundgerüst. Danach kann Phase 1 auf `feat/core-chat` beginnen.
+Phase 1 auf `feat/core-chat`: minimale Python-Toolchain, genau eine lokale Modelllaufzeit und ein echter lokaler CLI-Textchat mit SQLite-Sitzungen.
 ## Vor Änderungen erneut prüfen
@@ -13,13 +13,13 @@ Pascal prüft zuerst das Grundgerüst. Danach kann Phase 1 auf `feat/core-chat`
 ## Vorgeschlagener Umfang
- bevorzugt `uv` und höchstens eine sinnvolle Alternative für Python- und Umgebungsverwaltung vergleichen
+- `uv`, unterstützte stabile Python-Version und offizielle VS-Code-Erweiterungen einrichten
 - Installation nur nach Pascals Freigabe
 - Microsoft Python/Pylance/Python Environments sowie Ruff als minimale Entwicklungswerkzeuge prüfen
- echte Konfigurationsladefunktion mit Tests
+- Ollama und llama.cpp offiziell vergleichen; nur eine Laufzeit und ein Modell unter ungefähr 10 GB installieren
- Provider-Protokoll ohne Cloudaufruf
+- lokale Konfiguration, Provider-Schnittstelle und SQLite-Sitzungen implementieren
- minimale CLI-Struktur ohne fest programmierte KI-Antworten
+- CLI mit neuen, gelisteten und fortsetzbaren Sitzungen
 - Unit-, Ruff-, Persistenz-, Secret- und echter Modell-Smoke-Test
 ## Nicht beginnen
-Noch keine Modellinstallation, kein Obsidian-Schreiben, kein SSH-/Serverzugriff, keine Sprache und kein Living-Mind-Frontend.
+Keine zweite Modelllaufzeit, kein Obsidian-Schreiben, kein SSH-/Serverzugriff, keine Sprache und kein Living-Mind-Frontend.
@@ -1,6 +1,6 @@
 # Projektstatus
-Stand: Grundgerüstphase am 30.07.2026.
+Stand: Dokumentationsverdichtung vor `feat/core-chat`, 30.07.2026.
 ## Erreicht
@@ -11,6 +11,7 @@ Stand: Grundgerüstphase am 30.07.2026.
 - Living-Mind-Bereich als inaktiver Vertrag vorbereitet
 - projektinterne Codex-Agentensyntax anhand der aktuellen offiziellen Codex-Dokumentation geprüft
 - phasenbezogene Werkzeug- und Plugin-Empfehlungen sowie tokenbewusste Arbeitsregeln dokumentiert
 - vollständigen Erst-Handoff archiviert und kompakte laufende Übergabe eingeführt
 ## Nicht implementiert
@@ -24,4 +25,4 @@ KI, Chat, Provider, Gedächtnis, Obsidian-Adapter, Tools, Serverzugriff, Sprache
 ## Bekannte Einschränkung
-Im normalen Windows-`PATH` ist noch keine nutzbare Python-Installation verfügbar. Es wurde nichts installiert.
+Im normalen Windows-`PATH` sind Python, `uv`, Ruff und eine lokale Modelllaufzeit noch nicht bestätigt. Der Textchat ist noch nicht implementiert.
@@ -0,0 +1,7 @@
 # ADR-0005: Kompakter Handoff
 Status: angenommen.
 `docs/CHATGPT_HANDOFF.md` enthält nur den aktuellen Stand in einer festen Struktur und bleibt unter ungefähr 300 Zeilen. Nach Arbeitspaketen wird vorhandener Inhalt überarbeitet statt chronologisch angehängt.
 Vollständige historische Handoffs werden nur bei echten Meilensteinen unverändert unter `docs/archive/handoffs` archiviert. Projektstatus und nächste Sitzung bleiben ebenfalls kurze aktuelle Dokumente.
@@ -4,3 +4,4 @@
 - [ADR-0002: Secret-Isolation](0002-secret-isolation.md)
 - [ADR-0003: Sinnvolle Obsidian-Verknüpfungen](0003-meaningful-obsidian-links.md)
 - [ADR-0004: Tokenbewusster Arbeitsablauf](0004-token-efficient-workflow.md)
 - [ADR-0005: Kompakter Handoff](0005-compact-handoff.md)