Language & Publishing

Die Publishing-Schicht trennt Ausgabekanäle strukturell statt kosmetisch. AGT, DE und EN sind eigene Channels mit eigener Sprache, Zielgruppe und Template-Pflicht.

1. Warum Channel-Separation eine Strukturregel ist

Im IIO-Modell ist Sprache keine reine Darstellungsschicht. Ein Publishing Artifact gehört genau einem Kanal. Gemischte Artefakte sind fail-closed zu blockieren.

Ein Artifact = ein Channel Template Pflicht Mixed Language forbidden Publikation ohne Template blocked

2. Die 3 Kanäle

AGT — Agentic / Machine-Optimized

  • Zielgruppe: Agents, Automations, Pipelines
  • Format: YAML, JSON, strukturiertes Markdown
  • Keine freie Prosa als Pflichtbestandteil
  • Muss maschinenlesbar bleiben

DE — German Narrative

  • Zielgruppe: deutschsprachige Operatoren und Stakeholder
  • Format: HTML Manuals, strukturierte Markdown-Dokumente
  • Technische Abkürzungen erlaubt, wenn klar eingebettet
  • Keine englischen Fließtext-Abschnitte als Mischkanal

EN — English Narrative

  • Zielgruppe: internationale Operatoren und Partner
  • Format: strukturierte Narrative, HTML, Docs
  • Deutsche Fließtext-Teile verboten
  • Für internationale Spezifikations- und Onboarding-Texte

3. Channel Assignment Rules

RegelBedeutung
Jedes Artifact deklariert seinen ChannelÜber Frontmatter, Header oder Template-Zuordnung
Template muss existierenVor der Publikation muss ein passendes Channel-Template registriert sein
Keine Kanalmischung im selben ArtifactDE-Body mit EN-Section oder AGT-Struktur mit Prosa-Mischung ist unzulässig
AGT muss parsebar bleibenMaschinenkanal darf kein NLP benötigen, um Basisstruktur zu verstehen
Language Switch UI mischt nichtDie UI zeigt den aktiven Channel an, erzeugt aber keine Misch-Ausgabe

4. Template Enforcement

Ein Channel ist erst veröffentlichbar, wenn ein passendes Template deklariert ist.

template:
  channel: DE
  id: iio-operator-manual-de-v1
  format: html
  structure: [hero, panels, controls, references]
  audience: operator
  version: 1

Damit bleibt Publishing an eine konkrete, versionierte Form gebunden und kann nicht still in unkontrollierte Freiform ausweichen.

5. Verbindung zu anderen Layern

LayerBezug
Communication Modebestimmt, wie ein Actor bevorzugt angesprochen wird; der Publishing Channel ist der strukturelle Ausgabekontext
TransactionChannel-Zuordnung gehört in den Audit-Kontext eines publizierten Artefakts
BoundaryZugriff auf Channels kann rollen- und audience-gebunden sein
Theme / Publishingdürfen lokal variieren, ohne die harte Kanaltrennung aufzuweichen

6. Was konkret geblockt wird

DE Artifact mit eingebetteter EN Section AGT Output mit unstrukturierter Prosa Publikation ohne registriertes Channel-Template

Diese Blocks sind keine Stilfragen, sondern direkte Umsetzungen der Layer-Premises.

P-LANG-001 P-LANG-002 P-LANG-003 P-BOUND-002 P-TXN-005