YAML Frontmatter Schema Reference
Extracted from PRD.md Chapter 6 for quick reference.
Pflichtfelder (Required — all document types)
| Field |
Type |
Valid Values |
title |
string |
Non-empty |
type |
enum |
richtlinie, arbeitsanweisung, control, vorfall, massnahme, auditbericht, auditplan, kpi, schulung, verarbeitungstaetigkeit, dsfa, prozess, lieferant, dashboard, managementbewertung |
management_system |
enum |
IMS, ISMS, QMS, DSMS |
classification |
enum |
vertraulich, intern, extern |
status |
enum |
entwurf, aktiv, abgeschlossen, archiviert |
Empfohlene Felder (Recommended)
| Field |
Type |
Format |
review_date |
date |
YYYY-MM-DD |
approved_by |
string |
Approver name |
approved_date |
date |
YYYY-MM-DD |
lifecycle_stage |
enum |
entwurf, review, freigegeben, archiviert |
norm_refs |
list |
[ISO 27001, VDA ISA, NIS2, DSGVO, ISO 9001, Umweltschutz] |
last_ai_review |
date |
YYYY-MM-DD |
Type-Specific Fields
type: control
| Field |
Type |
Values |
norm |
string |
ISO 27001, VDA ISA, NIS2, ISO 9001, DSGVO |
chapter |
string |
e.g., A.5.01, 4.1, Art.32 |
reifegrad |
number/string |
0, 1, 2, 3, 4, 5, na |
bewertet_am |
date |
YYYY-MM-DD |
risiko_wahrscheinlichkeit |
number |
optional |
risiko_auswirkung |
number |
optional |
risiko_score |
number |
optional |
compliance_gap |
boolean |
optional, KI-detected |
type: vorfall
| Field |
Type |
Values |
schweregrad |
enum |
hoch, mittel, niedrig |
betroffene_systeme |
list |
System names |
entdeckungsdatum |
date |
YYYY-MM-DD |
datenpanne |
boolean |
true triggers DSMS entry |
type: massnahme
| Field |
Type |
Values |
kategorie |
enum |
korrektur, vorbeugung |
verantwortlicher |
string |
Person name |
frist |
date |
YYYY-MM-DD |
wirksamkeitspruefung |
date |
YYYY-MM-DD |
type: kpi
| Field |
Type |
Values |
einheit |
string |
Measurement unit |
zielwert |
string/number |
Target value |
messfrequenz |
enum |
monatlich, quartalsweise, jaehrlich |
kategorie |
enum |
qualitaet, sicherheit, datenschutz, umwelt, allgemein |
type: verarbeitungstaetigkeit
| Field |
Type |
Values |
zweck |
string |
Purpose of processing |
rechtsgrundlage |
string |
Art. 6 Abs. 1 lit. a/b/c/f DSGVO |
datenkategorien |
list |
Data categories |
empfaenger |
list |
Data recipients |
loeschfristen |
string |
Retention periods |
type: lieferant
| Field |
Type |
Values |
umwelt_bewertung |
enum |
nicht_bewertet, teilweise, vollstaendig |
score = (populated_fields / expected_fields) * 100
Where:
expected_fields = count(Pflichtfelder) + count(type_specific_fields) + count(recommended_fields)
populated_fields = count(fields that are present AND non-null AND valid)