Björn RundenandClaude Opus 5.5
7f6b8ebe07
Regeln, Standards, Kontextstruktur und Werkzeuge übernommen; 2nd-brain- Inhalte (Stacks, Ansible-Inventar, Architektur, Knowledge) entfernt. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
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 ISOJJJJ-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; Vorlage: 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.mdliegt im Root (Einzelprojekt).