# Deep Dive · Context technisch vertiefen

Diese Vertiefung ist optional. Der Context Starter funktioniert vorher bereits
als lokaler Dateibestand.

## 1 · Git für Verlauf und Review

Git lohnt sich, wenn mehrere Änderungen, nachvollziehbare Diffs oder ein sicherer
Rückweg regelmäßig helfen.

Ein guter Git-Stand hat:

- kleine, zusammenhängende Änderungen;
- eine verständliche Beschreibung des Zwecks;
- keine Zugangsdaten oder ausgeschlossenen Inhalte;
- Review vor Teilen oder Veröffentlichung;
- einen benannten letzten bestätigten Stand.

GitHub ist keine Voraussetzung. Vertrauliche Daten brauchen eine eigene
Speicher- und Berechtigungsentscheidung.

## 2 · Leichtes Schema nach beobachtetem Drift

Freie Markdown-Dateien reichen am Anfang. Ein Schema hilft, wenn wiederholt
Felder fehlen oder Automatisierung dieselbe Struktur erwartet.

Kandidaten für prüfbare Felder:

| Feld | Zweck |
|---|---|
| `owner` | verantwortliche Rolle sichtbar machen |
| `status` | offen, bestätigt oder ersetzt unterscheiden |
| `visibility` | Datenraum festhalten |
| `last_reviewed` | Aktualität prüfen |
| `source_refs` | Herkunft öffnen können |
| `next_step` | Arbeitsfähigkeit erhalten |

Das Schema prüft Struktur. Es entscheidet nicht, ob eine Aussage fachlich wahr
ist.

## 3 · Suche vor RAG

Erweitere die Suche stufenweise:

1. klare Namen, Startdatei und Source Pointer;
2. native Dateisuche oder ripgrep für genaue Begriffe;
3. lokaler Volltextindex, wenn Ranking und Ausschnitte wiederholt fehlen;
4. geteilter Suchdienst erst bei mehreren Rollen oder echtem Remote-Bedarf;
5. semantische Suche erst, wenn reale Testfragen mit anderen Begriffen
   regelmäßig scheitern.

Ein Fragenkatalog liefert den Trigger. Beispiel: Fünf bis zehn echte Fragen mit
erwarteten Quellen zeigen, ob die aktuelle Suche reicht.

## 4 · Kuratierte Promotion

Eine neue Erkenntnis wird in kontrollierten Schritten dauerhaft:

```text
Quelle
  → ungeprüfter Eingang
  → Herkunft und Datenklasse prüfen
  → in eigene Sprache abstrahieren
  → menschliche Entscheidung
  → kleiner Diff im Context
  → Verify und frischer Review
```

Brain, Kundenraum oder Agent dürfen Vorschläge liefern. Der bestätigte Context
ändert sich erst durch Review. Kundenspezifische Inhalte werden nicht in einen
allgemeinen Kursbestand kopiert.

## 5 · Agent Workspace

Claude Code oder Codex können in einem freigegebenen Development-Ordner mit
gezielten Datei-Pointern arbeiten. Ein Brief nennt:

- erwartetes Ergebnis;
- zu lesende Context- und Source-Dateien;
- erlaubte Dateien und Aktionen;
- Datenklasse;
- Prüfkriterien und Human Gate;
- Stop- und Recovery-Weg.

Die Browser-Spur bleibt als zugängliche Alternative erhalten. Beide Oberflächen
arbeiten mit demselben Context und denselben Grenzen.

## 6 · Klare Nicht-Trigger

Diese Signale rechtfertigen noch keinen Server oder RAG-Aufbau:

- wenige gut benannte Dateien;
- fehlende Startdatei oder ungeklärte Owner;
- keine echten Suchfragen;
- ungeprüfte Datenklassen;
- der Wunsch, pauschal „mit allen Daten zu chatten“;
- ein einmaliger Demo-Erfolg.

## 7 · Nächste Stufe wählen

| Beobachteter Engpass | Kleinste sinnvolle Ergänzung |
|---|---|
| Menschen finden den Einstieg nicht | `START-HIER.md` und Naming verbessern |
| genaue Begriffe sind schwer auffindbar | Dateisuche und Source Index |
| lange Dokumente liefern keine guten Ausschnitte | lokaler Volltextindex mit Snippets |
| mehrere Personen brauchen einen gemeinsamen Review-Stand | geteiltes System mit Rollen, Auth und Leak-Tests planen |
| Paraphrasen fehlen trotz guter Volltextbasis | semantische Suche gegen einen Goldstandard testen |
| wiederkehrender Ablauf braucht sicheren Maschinenzugriff | gezielten Connector oder programmatic step mit Human Gate prüfen |

Die nächste Stufe bleibt klein, messbar und rückbaubar.

## 8 · UI-Zustand und dauerhafte Wahrheit trennen

Eine lokale HTML-Konsole oder Lernoberfläche darf Checkboxes, Fortschritt und
aufgeklappte Karten im Browser speichern. Dieser Zustand erleichtert die
Session. Er kann gelöscht, zurückgesetzt oder auf einem anderen Gerät fehlen.

Der dauerhafte Betriebsstand wird in offenen Dateien festgehalten:

- eingerichtete Arbeitsmittel;
- bestandener Test;
- getroffene Entscheidung;
- verwendete Source-Dateien;
- eigener Handlungsschritt;
- Übergabe und nächster Trigger.

Der Fresh-Session-Test ist die technische Abnahme: Ein neuer Agent nennt die
Dateien hinter seiner Zusammenfassung und markiert nicht belegte Aussagen.