Inhalt verfassen. Regeln erklären. Ergebnis kompilieren.
Eine Word-Datei kann eine fehlende Empfängeradresse, einen alten Platzhalter, eine Überschrift am falschen Ort oder einen ungültigen Rechtswert enthalten. Das sind Dokumentfehler. docc legt dieses Wissen in ein Schema, damit es einheitlich geprüft werden kann.
Anforderungen werden dort geprüft, wo sie hingehören.
Das Schema bestimmt die gültige Form eines Dokumenttyps. Der Compiler vergleicht die Quelle damit und führt die Regeln des Typs aus.
| Ebene | Frage | Beispiel |
|---|---|---|
| Marker und Typ | Ist dies ein docc-Dokument und welcher Vertrag gilt? | docc: 1 und document_type: ch_letter wählen einen bekannten Typ. |
| Frontmatter-Schema | Sind Pflichtwerte vorhanden, typisiert und korrekt formatiert? | Eine Postleitzahl hat vier Ziffern; ein Enum nutzt einen erlaubten Wert. |
| Textstruktur | Sind verlangte Überschriften in erwarteter Reihenfolge vorhanden? | Eine Rechtsschrift kann feste Hauptabschnitte verlangen. |
| Semantik | Sind Blöcke, Spans und bewusste Leerfelder richtig verwendet? | Ein Parteienblock kann Name, Geburtsdatum und Adresse verlangen. |
| Regeln | Gelten dokumentübergreifende Vorgaben? | Eine Platzhalterregel verhindert [Name] in der Ausgabe. |
| Schema/Theme | Kann das Theme die Erklärung tatsächlich rendern? | Ein fehlender Stil wird vor dem ersten Absatz zurückgewiesen. |
Der Compiler sammelt alle Befunde in einem Durchlauf. Niemand soll nach jeder Korrektur nur den nächsten überraschenden Fehler sehen.
Jeder Fehler zeigt Ort und nächste Handlung.
Diagnosen besitzen stabilen Code, Quellposition und Hinweis. Damit funktionieren dieselben Ergebnisse im Terminal, im Editor, in CI oder in einem automatisierten Entwurfsablauf.
brief.md:8:13: error[DOC010]: Feld `case_ref` hat ungültigen Wert "ZG2026000" | 8 | case_ref: "ZG2026000" | ^^^^^^^^^^ Format AA.YYYY.NNN, | z. B. "ZG.2026.000"
Stabiler Code. Ein Workflow erkennt die Fehlerklasse, ohne Meldungstext zu erraten.
Cursor in der Quelle. Korrigiert wird die Markdown-Datei, nicht die generierte Word-Datei.
Handlungsfähiger Hinweis. Das erwartete Format steht beim Fehler, nicht nur in einer mündlichen Regel.
Ein Vertrag, mehrere sinnvolle Ansichten.
# Ohne Ausgabe validieren. docc check brief.md # Validieren und danach Word erzeugen. docc build brief.md # Vertrag und Diagnosen für Tools oder CI. docc describe --json ch_letter docc check --json brief.md # Geparste Tatsachen und Struktur als JSON lesen. docc read brief.md docc lsp
check --json liefert ok, Fehler- und Warnungszahlen sowie Diagnosen als strukturiertes JSON. So muss kein anderes Tool menschliche Terminalausgabe parsen.
Gleiche Eingaben, gleiche Dokument-Bytes.
docc schreibt das .docx selbst. Bei unveränderter Quelle, Schema und Theme ist das Archiv auf jeder Maschine byte-identisch. Das Dokument enthält die Profil-Provenienz; Uhrzeit, Netzwerk und sonstiger Umgebungszustand gehören nicht zur Ausgabe.
Das verbindliche Modell beschreibt die Philosophie.