Claude Code Prompt: ozmai Stack Dokumentation

Verwendung

cd /path/to/ozmai
claude

Dann diesen Prompt einfügen:

Der Prompt

Analysiere den gesamten ozmai Projekt-Stack vollständig.

Lies zuerst alle Dateien:
- api.py
- query.py
- ingest.py
- schema.sql
- public/index.html
- .env.example (falls vorhanden)
- requirements.txt (falls vorhanden)

Erstelle danach ozmai_code_dokumentation.md mit folgender Struktur:

---

# ozmai · Code Dokumentation

## Stack Übersicht
Kurze Beschreibung was ozmai ist und wie die Komponenten zusammenarbeiten.
Datenfluss-Diagramm als ASCII:
  Browser → api.py → query.py → pgvector → Claude API → Antwort

## Datei-für-Datei Dokumentation

Für JEDE Datei:

### dateiname.py
**Zweck:** Ein Satz was diese Datei macht.
**Abhängigkeiten:** Welche anderen Dateien/Module sie importiert.

**Funktionen/Routen:**
Für jede Funktion/Route:
- Name + Signatur
- Zeile (z.B. Zeile 47-83)
- Was sie macht (2-3 Sätze)
- Parameter und Rückgabewert
- Kritische Stellen mit Kommentar

**Kritische Zeilen:**
Liste der wichtigsten Zeilen mit Erklärung warum sie kritisch sind.

---

## Datenfluss: Frage → Antwort
Schritt-für-Schritt was passiert wenn ein User eine Frage stellt.
Zeige welche Funktion in welcher Datei an welcher Stelle aufgerufen wird.

## Datenfluss: Ingest
Schritt-für-Schritt was passiert wenn Text ingestiert wird.

## Datenbank Schema
Erkläre die pgvector Tabellen-Struktur.
Welche Felder, welche Typen, warum.

## Vektor-Modus vs LLM-Modus
Wo im Code wird zwischen den Modi unterschieden?
Zeige die genauen System-Prompts mit Zeilenangabe.

## Channel-System
Wie funktioniert das Channel-System im Code?
Wo wird channel_id gefiltert?

## Bekannte Schwachstellen / TODO
Was fehlt noch? Was könnte brechen?
Sicherheitshinweise (kein Auth, offene Ports etc.)

## Schnellreferenz für Admins
Tabelle: "Ich will X ändern → gehe zu Datei Y, Zeile Z"

Beispiele:
| Ich will...                    | Datei     | Zeile/Funktion        |
|--------------------------------|-----------|-----------------------|
| System Prompt ändern           | query.py  | Funktion: build_prompt|
| Chunk-Größe ändern             | ingest.py | Variable: CHUNK_SIZE  |
| Neuen API Endpoint hinzufügen  | api.py    | Nach Route /query     |
| Embedding-Modell wechseln      | query.py  | OLLAMA_MODEL Variable |

---

Sei präzise mit Zeilenangaben.
Schreibe für einen Admin der den Code nicht täglich sieht
aber schnell verstehen muss was wo passiert.
Keine unnötigen Füllsätze.

Nach der Dokumentation

# Dokumentation in ozmai ingestieren
# Im Browser: #general Channel öffnen
# Ingest Modal → Quellenname: ozmai_code_dokumentation.md
# Inhalt der MD-Datei einfügen → Ingestieren

# Dann testen:
"Wo im Code wird zwischen Vektor- und LLM-Modus unterschieden?"
"Was macht die Funktion embed_question und in welcher Zeile steht sie?"
"Wie groß sind die Chunks beim Ingest?"

Bonus: code-review-graph für lebende Dokumentation

# Nach der DevOps VM Freigabe:
pip install code-review-graph
cd /path/to/ozmai
code-review-graph init      # .mcp.json erstellen
code-review-graph build     # Graph bauen
code-review-graph visualize # HTML-Karte öffnen
                            # → zeigt deepbit EXAKT
                            #   welche Funktion was aufruft