# Markdown & Dokumentation

## 1. Allgemein
- Eine `#`-Überschrift pro Datei (= Titel), darunter Gliederung mit `##`/`###`. Optional direkt unter dem Titel ein Zitatblock `> Stand: TT.MM.JJJJ · …`.
- Kurz, konkret, prüfbar: Tabellen für Fakten, Checklisten (`- [ ]`) für Abläufe/Offenes, Code-Blöcke mit Sprache (` ```bash `).
- Datumsangaben im Text absolut `TT.MM.JJJJ`; in Frontmatter/Dateinamen ISO `JJJJ-MM-TT`.
- Relative Links innerhalb der Basis (`[bash.md](../common/bash.md)`), keine absoluten Pfade.
- Quellen als Link + Abrufdatum. Unbelegtes als „Einschätzung“ kennzeichnen.
- Platzhalter: `<NAME>` (auszufüllen), `<!-- TODO: … -->` (offener Punkt); Vorlagen-Variablen für Scripts: `@@NAME@@`.
- Diagramme: Mermaid oder ASCII im Code-Block (lesbar ohne Renderer); keine Binärbilder ohne Not.

## 2. READMEs
Jeder Ordner der Basis hat eine `README.md`: Zweck, Inhalt (Tabelle Datei → Inhalt), Pflege (wer, wann, wie).

## 3. Knowledge-Einträge
Format und Ablage: [`../context/knowledge/README.md`](../context/knowledge/README.md); Vorlage: [`templates/markdown/knowledge_entry.md`](templates/markdown/knowledge_entry.md).

## 4. `context.md` (Arbeitsgedächtnis im Root)
Abschnitte nicht umbenennen (Agenten suchen danach):
Metadaten · Ziel · Stand · Entscheidungen · Offene Fragen · Nächster Schritt · Sitzungsprotokoll.

## Änderungsprotokoll
- 07.10.2026 – angelegt.
- 23.10.2026 – `context.md` liegt im Root (Einzelprojekt).