Nexhorizons-Public/claude-regelwerk
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
276e6051f5646dd599d78d5ed2da98b18cc25a56
claude-regelwerk/AI/Regelwerk/frontmatter.md
T
Pascal MichelandClaude Opus 5 e28dd9c280 Automatischer Push: 2 Datei(en) geändert 
- .vault-tools/frontmatter-migration/migriere.py
- AI/Regelwerk/frontmatter.md

Erzeugt vom PostToolUse-Hook .vault-tools/auto-push/auto_push.py.

Co-Authored-By: Claude Opus 5 <[email protected]>
2026-09-29 04:00:02 +02:00

7.9 KiB
Raw Blame History

type, title, status, summary, tags, created, updated
type title status summary tags created updated
resource Frontmatter-Vokabular pending-review Pflichtfelder, zulässige Werte für type und status, fertige Blöcke je Dateiart, Quoting gegen kaputtes YAML und die Schreibweise der Tags.
regelwerk
frontmatter
vault-navigation
2026-09-03 2026-09-28

Frontmatter-Vokabular

Festgelegt am 2026-09-03, ergänzt am 2026-09-13 um Quoting, fertige Blöcke und Tags. Die Werte unten sind aus dem Bestand abgeleitet, Synonyme sind zusammengelegt.

Pflichtfelder

type, title, status, summary, tags, created, updated — in dieser Reihenfolge.

uid ist optional. Es gibt mehrere Werkzeuge, die das Feld schreiben, aber keins, das es für etwas anderes als eine Link-Auflösung liest, und die nutzt im Bestand niemand. Wer eine uid setzt, nimmt JJJJMMTT-slug, stellt sie an den Anfang und prüft vorher per Grep, dass es sie noch nicht gibt. Bestehende uids bleiben stehen.

Quoting — sonst ist es kein YAML mehr

title, summary und jedes Feld mit Fließtext (zum Beispiel modell_begruendung) stehen immer in Anführungszeichen. YAML liest # als Kommentarbeginn und : als Trenner. Ohne Anführungszeichen wird der Wert still abgeschnitten, oder der ganze Block ist ungültig, und Obsidian, Bases und Skill-Liste sehen dann etwas anderes als du.

  • Normalfall: doppelte Anführungszeichen, title: "Task 04 — OpenSearch: Rollen".
  • Enthält der Wert ein gerades ", zum Beispiel als Schluss von „…", nimmst du einfache: summary: 'Sagt „nie überschreiben" und warum.'
  • Enthält er beides, einfache Anführungszeichen, und ein ' im Wert wird verdoppelt: 'Status ''fertig'' laut „Stand"'.

Dasselbe gilt für description in Skill-, Agenten- und Command-Dateien.

type

Allgemein

Wert Wofür Standard-status
moc Navigationsseite, Seed oder Oberseed reference
daily Tagesnotiz in /Inbox open
session Sitzungsprotokoll in /AI/sessions done
memory Gedächtnisdump in /AI/secondbrain reference
note Wissensnotiz, Artikel, Arbeitsdokument, Bericht, Recherche ohne eigene Kategorie active
konzept Konzept- und Strategiepapier draft
resource Regelwerk, Referenzmaterial, Nachschlagewerk reference
guide Anleitung, Checkliste, Betriebsdokumentation — alles, was jemand befolgt active
project Projekt-README active
spec Design-Spec unter docs/superpowers/specs/ draft
plan Umsetzungsplan unter docs/plans/ active
plan-task Einzelaufgabe innerhalb eines Planordners draft
todo Aufgabenliste eines Projekts (todo.md) active
lessons tasks/lessons.md — projektspezifische Funde active
changelog CHANGELOG.md active
codedoku Codedoku unter docs/code/ und Architekturpapiere active

Nicht zulässig, obwohl sie immer wieder entstehen: session-note → session in AI/sessions, sonst note; howto → guide; recherche und research → note, draft (ist ein status) → note, reference (ist ein status) → resource bzw. memory.

Spezialbereiche — nicht anfassen

isms-dokument, isms-kapitel, bookstack-seite, bookstack-kapitel, bookstack-buchbeschreibung, iam-projekt, netz-projekt.

Diese Werte gehören zu geschlossenen Dokumentensätzen mit eigener Logik. Sie stehen hier nur, damit niemand sie für vergessen hält.

status — 8 Werte

Wert Bedeutung
draft in Arbeit, noch nicht belastbar
ready fertig, aber noch nicht in Umsetzung (vor allem Pläne)
active in Verwendung oder in Umsetzung
done abgeschlossen
open offen im Sinne von unbearbeitet (Tagesnotizen, Nachweislisten, Notizen in der Inbox)
reference Nachschlagewerk, ändert sich nur bei Bedarf
vorlage Vorlage, aus der etwas erzeugt wird (Bookstack-Set)
pending-review nur für Regelwerk-Dateien nach einer Selbstoptimierung, bis Pascal freigibt ([[CLAUDE

Fertige Blöcke je Dateiart

Kopieren, Werte ersetzen, Anführungszeichen stehen lassen.

Tagesnotiz (Inbox/JJJJ-MM-TT.md):

---
type: daily
title: "JJJJ-MM-TT"
status: open
summary: "Tagesnotiz vom JJJJ-MM-TT."
tags: [daily]
created: JJJJ-MM-TT
updated: JJJJ-MM-TT
---

Sitzungsprotokoll (AI/sessions/JJJJ-MM-TT-HH.md) — Projekt-Tag nach AI/Regelwerk/projekte ergänzen, wenn die Sitzung einem Projekt gehört:

---
type: session
title: "Sitzung JJJJ-MM-TT, HH Uhr – <Thema>"
status: done
summary: "<ein Satz: was entstanden ist und was offen bleibt>"
tags: [session, <projekt-tag>]
created: JJJJ-MM-TT
updated: JJJJ-MM-TT
---

Dump (AI/secondbrain/<projekt-tag>-memory/JJJJ-MM-TT-<thema>.md):

---
type: memory
title: "<Thema> – <Kernaussage>"
status: reference
summary: "<ein Satz>"
tags: [memory, <projekt-tag>]
created: JJJJ-MM-TT
updated: JJJJ-MM-TT
---

Planübersicht (docs/plans/JJJJ-MM-TT-<thema>/00-uebersicht.md oder Einzeldatei):

---
type: plan
title: "<Thema>"
status: active
summary: "<ein Satz: was danach funktioniert>"
tags: [plan, <projekt-tag>]
created: JJJJ-MM-TT
updated: JJJJ-MM-TT
---

Plan-Task (task-NN-<thema>.md):

---
type: plan-task
title: "Task NN — <Titel>"
status: draft
summary: "<ein Satz>"
tags: [plan-task, <projekt-tag>]
created: JJJJ-MM-TT
updated: JJJJ-MM-TT
modell: sonnet
modell_begruendung: "<ein Satz, warum Ermessen nötig ist oder nicht>"
---

Seed-MOC (IT Workspace/<Ordner>/_MOC-<slug>.md):

---
type: moc
title: "<Ordnername>"
status: reference
summary: "<ein Satz: welches Wissen hier liegt — ohne Stückzahl>"
tags: [<Segment-Tag>]
created: JJJJ-MM-TT
updated: JJJJ-MM-TT
---

Tags

  • Tags im Frontmatter ohne #, als Liste: tags: [session, logging].
  • Projekt-Tag: Ableitung aus dem Ordnernamen in AI/Regelwerk/projekte.
  • Segment-Tag im IT Workspace: Es gilt die Schreibweise, die die Artikel des Ordners tragen, zum Beispiel #LinuxServer-Administration. Die Seed-MOC führt genau diesen Tag in ihren tags, damit eine Tag-Suche vom Seed aus die Artikel findet. Keine zweite Schreibweise einführen, auch keine „saubere" kebab-case-Fassung.
  • Review-Tags: #review heißt, Pascal nimmt ab; #review-done heißt, abgenommen; #needs-review heißt, Pascal muss etwas entscheiden. Ein Tag, der nur als Wort im Text erwähnt wird, steht in Backticks, sonst zählt Obsidian ihn als Tag.

Was bewusst kein Frontmatter bekommt

  • Artikel im IT Workspace mit alter Tag-Konvention. Begründung und Zählbefehl: AI/Regelwerk/navigation. Die Seeds leiten Titel und Zusammenfassung aus Überschrift und erstem Absatz ab. Nachrüsten nur auf Zuruf.
  • CLAUDE.md — der Stamm ist keine Notiz.
  • Index-Dateien wie AI/secondbrain/MEMORY.md. Sie sind Verzeichnisse, keine Inhalte.
  • Skill-, Agenten- und Command-Dateien (SKILL.md, .claude/agents/*.md, commands/*.md) haben das Format von Claude Code mit name und description — nicht auf dieses Schema umstellen.

Der Obsidian-Skill obsidian-markdown nennt als Frontmatter nur title, tags und aliases. In diesem Vault gilt diese Datei.

Was zusammengelegt wurde (2026-09-03)

Alt Neu Grund
projekt project Schreibvariante
task, aufgaben, project-todo todo drei Werte für todo.md
anleitung guide dasselbe
checklist guide eine Checkliste wird befolgt
architecture codedoku Architekturpapier ist Doku für den, der den Code ändert
arbeitsdokument note Einzelfall ohne eigene Kategorie
reference (als type) memory betraf ausschließlich Gedächtnisdumps; reference bleibt als status gültig
approved, abgeloest (status) done Einzelfälle

Referenzen

Reference in new issue View Git Blame Copy Permalink