Vault-Konventionen

Dateinamen

• kebab-case: splash-logik-cloudflare.md, nicht Splash Logik Cloudflare.md
• Keine Umlaute: ae, oe, ue, ss statt ä, ö, ü, ß
• Kein Datum-Prefix: Git hat History — ddos-doings.md statt 20250630 - DDos Doings.md
• Nur ASCII: keine Sonderzeichen außer -

Ordnerstruktur

Ordner	Inhalt
00-meta/	Onboarding, Konventionen, Vault-Infos
10-team/	Prozesse, Meeting-Notizen, Jahresziele
20-architecture/	Tech-Entscheidungen, ADRs, Infrastruktur
30-projects/	Laufende Initiativen, Projekte mit To-Dos
40-knowledge/	Snippets, How-Tos, KI-Kontext, Wissenssammlung
50-people/	1:1-Notizen (privat — 50-people/private/ ist gitignored)
assets/img/	Bilder, Screenshots
assets/excalidraw/	Excalidraw-Diagramme

Tags

• #area/architecture, #area/frontend, #area/infrastructure, #area/security
• #status/draft, #status/wip, #status/done
• #type/adr, #type/meeting, #type/howto, #type/project

Frontmatter

Jede Datei sollte ein YAML-Frontmatter haben:

---
title: Titel der Notiz
date: 2026-05-13
tags: [architecture, frontend]
authors: [github-username]
---

Assets

• Bilder in assets/img/, eingebettet via ![[assets/img/name.png]]
• Excalidraw in assets/excalidraw/, eingebettet via ![[assets/excalidraw/diagram.excalidraw]]

Workflow

• Kleine Edits → direkt commit + push (obsidian-git übernimmt automatisch)
• Größere Umbauten (Ordner umbenennen, viele Dateien verschieben) → Pull Request
• Merge-Konflikte → Datei öffnen, <<<<<<<-Marker auflösen, speichern, Plugin pusht weiter