RM-ENGINEERING-FINDING

Engineering-Finding-Modell#

Zweck#

Engineering Findings erfassen Erkenntnisse, die während Implementierung, Materialisierung, Deployment, Verifikation oder Betrieb entstehen. Sie bewahren Erfahrungswissen, das sonst in Chats, Tickets, Logs oder Erinnerungen einzelner Beteiligter verloren ginge.

Ein ist weder bloß ein Fehlerbericht noch automatisch eine Architekturentscheidung.

Observation
                → Engineering Finding
                → Architecture Decision oder Engineering Rule
                → Implementation
                → Verification
                → Evidence
                → Learning Nugget
                → Institutionalization

Abgrenzung#

	Leitfrage
Architecture Principle	Welcher allgemeine Grundsatz gilt?
ADR	Warum wurde eine konkrete Entscheidung getroffen?
Engineering Finding	Was wurde bei der realen Umsetzung oder im Betrieb gelernt?
	Wie lässt sich die Erkenntnis verständlich vermitteln?
Verification	Wodurch ist die Aussage praktisch belegt?

Mindeststruktur#

Ein Finding dokumentiert mindestens:

stabile ID EF-xxx,
Titel und Kategorie,
Reifegrad,
Kontext und Beobachtung,
sichtbares Symptom,
analysierte Ursache,
abgeleitete Engineering Rule,
Architektur-Auswirkung,
Implementierung oder geplante Maßnahme,
Regression beziehungsweise Verifikation,
Evidence,
Beziehungen zu ADRs, Building Blocks, Tests und Learning Nuggets.

Reifegrad#

Observed
                → Validated
                → Institutionalized
                → Superseded

Observed#

Die Beobachtung ist reproduzierbar beschrieben, aber noch nicht vollständig bestätigt oder verallgemeinert.

Validated#

Ursache und Regel wurden durch Analyse oder wiederholbare Verifikation bestätigt.

Institutionalized#

Architektur, Implementierung, Regressionstest und Dokumentation setzen die Erkenntnis verbindlich um.

Superseded#

Eine spätere Erkenntnis oder Entscheidung ersetzt die Regel. Das Finding bleibt aus Gründen der Nachvollziehbarkeit erhalten.

Kategorien#

Runtime
Storage
Bootstrap
Configuration
Deployment
Roundtrip
Verification
Evidence
Security
Performance
UX
Platform

Beziehungen#

Ein Finding kann Beziehungen besitzen wie:

observed-in → Execution Evidence oder Runtime,
caused-by → Implementierungs- oder Konfigurationsartefakt,
leads-to → ADR oder Engineering Principle,
changes → oder Engineering Tool,
verified-by → Verification Artifact,
explained-by → Learning Nugget,
beziehungsweise superseded-by → Engineering Finding.

Invarianten#

Ein Finding darf nicht allein aus einer Vermutung als Validated gelten.
Ein Fix ohne dokumentierte Ursache institutionalisiert keine Erkenntnis.
Institutionalized verlangt mindestens eine Architektur- oder Regelreferenz sowie Verification Evidence.
Evidence darf keine Secrets enthalten.
Ein Finding bleibt auch nach Behebung des Symptoms erhalten.
Fakten, Zeiten, Versionen und Status werden nicht rückwirkend umformuliert.

Beziehungen#

— contributes_to