chat-naming-regel

Chat-Naming-Konvention

Eine Regel gegen den parallele-Sessions-Chaos. Chat-Titel ist immer ein direkter Pointer ins Vault — wenn ich den Titel sehe, weiss ich sofort wo die Source-of-Truth liegt und in welcher Phase wir sind.

Format

<projekt-slug>:<phase-oder-artifact>

Beide Teile kebab-case, Doppelpunkt als Trenner.

• projekt-slug = der Ordner-Name unter intern/projekte/, intern/kunden/ oder intern/firma/. Source-of-Truth-File ist dann intern/<typ>/<slug>/_index.md (bei Projekten/Kunden) bzw. intern/firma/<slug>.md.
• phase-oder-artifact = was diese Session konkret macht. Frei waehlbar, aber konsistent kurz (1-3 Worte).

Beispiele

Aus aktuellen Workstreams (Stand 2026-05-19):

Chat-Titel	Vault-Pointer
public-mcp-audits:phase2-review	_index
openwebui-vf:welle4-rollout	_index
av-voice:phase2-mvp	_index (falls existent)
vf-liquiditaets-cockpit:phase1	_index
friseur-im-sueden-bot:build	_index
becker:phase1-discovery	becker
joern:pricing-roundtrip	joern
secret-konsolidierung:phase3-rotation	_index

Bei Themen die noch kein eigenes Vault-File haben (Brainstorm, Ad-hoc-Research): praefix mit brainstorm: oder research:, danach ein Topic-Slug.

Chat-Titel	Bedeutung
brainstorm:kmu-standard-stack	strategischer Brainstorm, noch kein Projekt
research:lobe-chat-vs-owui	Recherche, landet in intern/runs/
inbox:abend-aufraeumen	Vault-Hygiene-Session

Phasen-Konventionen

Gleiches Vokabular wie in den Vault-Files:

• phaseN (mit Nummer) bei mehrstufigen Projekten
• welleN bei Open-WebUI-VF-aehnlichen Rollouts
• discovery fuer initiale Lead/Kunden-Sessions
• mvp, build, rollout, qa, review, fix, cutover als Phasen-Marker
• plan, brainstorm, compound wenn der Skill der Hauptzweck ist
• phase-2a-validation ist OK wenn die Phase intern weiter gesplittet ist

Wann das nicht passt

• Sehr kurze Ad-hoc-Anfragen (eine Minute, dann fertig) → kein Naming noetig, ueberhaupt nicht im Chat-Titel auftauchen.
• Reine Tool-/MCP-Calls ohne Kontext → kein eigener Chat.
• Wenn die Session ueber drei Projekte gleichzeitig laeuft (selten, sollte vermieden werden) → benenne nach dem dominanten Projekt, leg fuer das Nebenthema einen Spawn-Task an statt mitzumischen.

Wartung

Wenn ein Projekt-Slug sich aendert (z.B. mcp-pipeline-aws → mcp-hosting-plattform), wandern die alten Chat-Titel mit. Aber: aktive Chats die laenger als eine Woche offen sind sollten umbenannt werden, sonst zeigt der Titel auf eine tote Doku-Stelle.

Wenn das Vault-Projekt-File geloescht oder archiviert wird → Chat-Titel-Praefix archiv: davor, oder Chat schliessen.

Verbindung zu Vault

Diese Konvention ist die Bruecke zwischen Claude-Code-/Claude-Desktop-Chats und dem Vault. Sie ersetzt nicht das _index.md jedes Projekts, sondern macht den Chat-Layer dazu auffindbar. Aktive Projekt-Liste fuer aktuelle Slug-Namen: active-work.