EA-GOV-EXPLAINABILITY-KNOWLEDGE-REFERENCE-001

Erklärbarkeits- und Wissensreferenz-Governance#

Zweck#

Diese Governance schützt die Nachvollziehbarkeit von Erklärungen über Repository-, Sprach-, Versions- und Runtime-Grenzen hinweg.

Reason-Code-Governance#

• Reason Codes besitzen eine stabile Identity und werden nicht übersetzt.
• Umbenennungen oder Bedeutungsänderungen benötigen einen nachvollziehbaren Lifecycle.
• Ein bestehender Reason ⌘CodeCode ist eine ausführbare oder interpretierbare technische Realisierung, die durch Tests und Runtime-Evidence überprüfbar bleibt. darf nicht stillschweigend für eine andere ⌘BedeutungBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen. wiederverwendet werden.
• Menschenlesbare Titel und Texte können je Sprache und Zielgruppe materialisiert werden.

Reference-Governance#

• Referenzen zeigen auf kanonische ⌘ArtifactEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird. Identities, nicht auf zufällige Darstellungen.
• Dateipfade dürfen technische Auflösung unterstützen, sind aber nicht die semantische Identity.
• Nicht auflösbare Referenzen werden als ⌘FindingTechnical documentation artifact. behandelt und nicht durch erfundene Ziele ersetzt.
• Cross-Repository-Referenzen müssen Repository-Identität und Artifact Identity eindeutig machen.

Revisions- und Gültigkeitsregel#

Eine Erklärung muss erkennen lassen, auf welchem Wissensstand sie beruht. Wird eine Quelle geändert, darf ein historisches Event nicht so dargestellt werden, als habe es bereits die neue Bedeutung verwendet.

Zulässige Strategien sind beispielsweise:

• explizite Revision,
• Gültigkeitszeitraum,
• unveränderlicher Snapshot,
• nachvollziehbare ⌘ProvenanceProvenienz beschreibt die nachvollziehbare Herkunft eines Wissenselements, einer Aussage oder einer abgeleiteten Darstellung. zur Quellrevision.

Die konkrete technische Strategie ist Solution Design.

Lokalisierung#

• Semantische Identity, Reason Code und technische Referenzen bleiben stabil.
• Lokalisierte Texte bewahren die Originalsprache und Provenance.
• Fehlt eine Übersetzung, bleibt die semantische Referenz gültig; die Darstellung kennzeichnet den Fallback.
• Übersetzungen dürfen keine zusätzliche fachliche Aussage einführen.

Evidence#

⌘EvidenceTechnical documentation artifact. wird von Interpretation getrennt. Eine Explanation darf auf Evidence verweisen und daraus eine begründete Aussage ableiten, muss aber kenntlich machen, welcher Teil beobachtet und welcher Teil interpretiert wurde.

Qualitätsgate#

Eine Explainability-Materialisierung ist nicht promotionsfähig, wenn:

• Reason Codes mehrdeutig oder sprachabhängig sind,
• Knowledge References nicht auflösbar sind,
• Revision oder Gültigkeit nicht nachvollziehbar ist,
• Evidence und Interpretation vermischt werden,
• lokalisierte Texte die semantische Aussage verändern.

Migrationsprovenienz#

Semantisch konsolidiert aus der historischen Quelle SolutionArchitecture.zip:

• 90-governance/GOV-006-Knowledge-Preservation-Governance.md
• 30-domain-model/DOM-005-Language-Terminology-Domain.md
• 30-domain-model/DOM-007-Workflow-Lifecycle-Domain.md

Related Architecture#

• ◆Explainability by Reference PrincipleVerlangt erklärbare Entscheidungen und Zustandsübergänge durch stabile Referenzen auf Wissen, Regeln und Evidenz. – governed-by
• ◆Knowledge Reference ModelOrdnet Wissensartefakte, Wissensbeziehungen, fachliche Heimat, Scope und Sprachfassungen universell ein. – governs
• ◆Explainability Reference ModelDefiniert die universellen Bestandteile einer nachvollziehbaren maschinellen und menschlichen Erklärung. – governs
• Terminology Lifecycle Governance – related-to