Bewährte Praxis · MDW-Autorenschaft

Bewährte Praxis für MDW-Autorenschaft mit Agents

Ein .mdw-Paket ist ein typisierter Veröffentlichungsvertrag, keine umbenannte Markdown-Datei. Zuverlässige Autorenschaft macht Aussagen, Struktur, Präsentation, Assets und Evidenz ohne private Rendering-Tricks maschinell prüfbar.

Aktualisiert 3. August 2026Praxisleitfaden

Mit Lesenden und Inhaltsform beginnen

  1. Report, Artikel, Briefing oder Dashboard aus der Leseaufgabe wählen
  2. Schlussfolgerung und Evidenzfolge vor dem Styling schreiben
  3. unterstütztes Thema und passenden Akzent wählen
  4. pro Dokument eine zugelassene Icon-Bibliothek verwenden

Daten und Präsentation ausdrücklich halten

Wesentliche Werte als typisierte Fakten oder Query-Ergebnisse speichern und Tabellen, Kennzahlen sowie Charts an diese Kennungen binden. Wichtige Zahlen nicht allein in Schmucktext verstecken.

Medien als beweistragende Assets behandeln

  1. verwendete Medien im Paket einfrieren
  2. Quelle, Urheber oder Herausgeber, Lizenz, Abrufdatum, Digest, Alt-Text, Bildunterschrift und Credit erfassen
  3. bei Nutzer- oder Modellbildern authored metadata verwenden
  4. Dokument auch ohne Bild verständlich halten

Die deterministische Schranke durchlaufen

check, build und digest nacheinander ausführen. Bei Fehlern den Draft ändern und neu bauen; das erzeugte Paket weder entpacken noch manuell verändern.

ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw

FAQ

Häufige Fragen

Ist .mdw nur Markdown mit anderer Endung?

Nein. Es ist ein deterministisches typisiertes Paket aus Inhalt, Präsentation, integritätsgebundenen Assets und Protokollmetadaten.

Darf ein MDW-Dokument beliebiges HTML oder JavaScript enthalten?

Nein. Nur unterstützte typisierte Knoten und Renderer-Fähigkeiten gehören zum Hosted-Vertrag; beliebiges HTML und Skripte nicht.

Echten Workflow nutzen

Veröffentliche, was dein Agent erschafft.

Gib jedem Bericht, Dokument oder Plan eine lesefertige Seite, über die Kommentare, Entscheidungen und formale Revisionen zurückfließen.