EA-PRI-EXPLAINABILITY-BY-REFERENCE-001

Prinzip der Erklärbarkeit durch Referenz#

Grundsatz#

Ein System erklärt eine Entscheidung oder einen Zustandsübergang nicht allein durch Freitext. Es verweist zusätzlich stabil auf die Bedeutungen, Regeln, Entscheidungen, Evidenzen und Wissensartefakte, die zur Erklärung beitragen.

Motivation#

Freitext ist für Menschen lesbar, aber schwer verlässlich auszuwerten, zu versionieren und über mehrere Materialisierungen hinweg zu verfolgen. Stabile Referenzen erlauben dagegen:

• dieselbe Begründung in Runtime, Report, UI und Audit wiederzuverwenden,
• Änderungen an Wissen und Regeln nachvollziehbar zu machen,
• maschinelle und menschliche Explainability auf dieselbe semantische Grundlage zu stellen,
• Reason Codes von sprachabhängigen Texten zu trennen,
• Execution und ⌘EvidenceTechnical documentation artifact. bis zu Architecture Decisions, Principles und ⌘VisionEine Vision beschreibt eine langfristig gewünschte Wirkung und gibt der Weiterentwicklung eine gemeinsame Richtung. zurückzuführen.

Verbindliche Regeln#

1. Reason Codes und technische Referenzen bleiben sprachneutral und stabil.
2. Menschenlesbare Erklärungstexte dürfen lokalisiert und zielgruppenspezifisch materialisiert werden.
3. Eine Erklärung muss die verwendeten Knowledge References und ihre Revision oder Gültigkeit nachvollziehbar machen.
4. Freitext darf Referenzen ergänzen, aber nicht ihre Identität ersetzen.
5. Eine fehlende oder nicht auflösbare Referenz ist ein Explainability- und Traceability-Defekt.
6. Erklärungen dürfen keine neue Architekturbehauptung erzeugen, die nicht durch eine führende Quelle getragen wird.

Konsequenz#

Solutions benötigen Mechanismen zur Auflösung von Knowledge References, zur Verwaltung von Reason Codes und zur Materialisierung menschenlesbarer Erklärungen. Die konkrete API, Persistenz, Suchtechnik oder UI bleibt Solution Design.

Migrationsprovenienz#

Semantisch konsolidiert aus der historischen Quelle SolutionArchitecture.zip:

• 40-concepts/architecture-knowledge-base/CON-002-Traceability-Knowledge-Graph.md
• 90-governance/GOV-006-Knowledge-Preservation-Governance.md
• 30-domain-model/DOM-005-Language-Terminology-Domain.md

Related Architecture#

• ◆Enterprise Knowledge GraphDokumentiert die semantischen Beziehungen zwischen den tragenden Enterprise-Artefakten. – derived-from
• ◆Knowledge Reference ModelOrdnet Wissensartefakte, Wissensbeziehungen, fachliche Heimat, Scope und Sprachfassungen universell ein. – realized-through
• ◆Explainability Reference ModelDefiniert die universellen Bestandteile einer nachvollziehbaren maschinellen und menschlichen Erklärung. – realized-through
• ◆Observability by DesignVerlangt beobachtbare und erklärbare Actions, Decisions, State Transitions und Results. – related-to
• ◆ADR-014Entscheidet, dass Explainability auf stabilen Reason Codes, Knowledge References und Evidence References basiert. – decided-by