Start

Next

Team-Dokumentation

Willkommen! Diese Website wird automatisch aus Markdown-Dateien erzeugt und bei jedem Push auf main neu deployt.

Aufbau dieses Repos

Ordner Zweck Veröffentlicht?
docs/anleitungen/ Anleitungen — hauptsächlich vom Menschen ja
docs/research/ Recherche-Notizen des KI-Agenten ja
docs/entwuerfe/ Entwürfe und Notizen nein (vom Deploy ausgeschlossen)

Konventionen für jede Seite

Jede Markdown-Datei beginnt mit diesem Block (eingerückt, damit es im Seitenquelltext lesbar bleibt):

---
title: Titel der Seite
status: draft | review | published
autor: mensch | ki-agent
---
  • status: draft — Arbeit in Progress, gehört nach entwuerfe/
  • status: review — fertig geschrieben, wartet auf Gegenlesen
  • status: published — final und auf der Website sichtbar

Wer schreibt wo?

  • Mensch: schreibt direkt auf main, am besten über Obsidian (Vault auf den Projektordner zeigen, Plugin Obsidian Git macht automatisch commit & push).
  • KI-Agent: arbeitet auf einem eigenen Branch (z. B. ki/recherche-thema), legt Dateien an und öffnet einen Pull Request. Erst nach Review wird gemergt — und damit automatisch deployt.