ADR-006-REFERENCE-FIRST-ENGINEERING
ADR-006 – Referenzorientiertes Engineering und schnelle Materialisierung#
Status#
Accepted.
Kontext#
Architekturkonzepte dürfen nicht erneut über längere Zeit nur als Dokumentation wachsen, während eine Referenzimplementierung fehlt.
Entscheidung#
Neue allgemeingültige Konzepte werden zunächst als Reference GlossarbegriffEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird. Alles Modellierbare wird als Artefakt geführt. Dazu gehören unter anderem Systeme, Beziehungen, Features, Dokumente, ADRs, Tests, UI-Buttons, Menüs, Farben, Icons, Konfigurationen, Diagramme, Runtime-Ressourcen, fachliche Objekte und reale Objekte wie ein Blumentopf, sofern sie modelliert werden. Knowledge ist keine Sonderklasse. UI- und Applikationsartefakte werden fachlich nach demselben Grundmodell behandelt.Glossareintrag vollständig lesen oder Architecture Decision beschrieben und spätestens innerhalb der nächsten zwei Engineering GlossarbegriffEin Plateau ist ein zeitlich eingeordneter, freigegebener Reife- oder Materialisierungsstand.Glossareintrag vollständig lesen im produktiven GlossarbegriffEin MVP ist eine kleinste überprüfbare Materialisierung mit bewusst begrenztem Umfang.Glossareintrag vollständig lesen materialisiert oder ausdrücklich verworfen.
Regeln#
- Architekturänderungen werden durch einen konkreten Engineering-Bedarf ausgelöst.
- Das MVP ist die erste produktive Referenzimplementierung.
- Implementierungserfahrung wird in Contracts und Reference Artifacts zurückgeführt.
- Nicht materialisierte Konzepte erhalten Status, Owner und spätestes Zielplateau.
- Nach zwei Plateaus erfolgt Review: materialisieren, neu schneiden oder verwerfen.
Konsequenzen#
- Architektur und GlossarbegriffCode ist eine ausführbare oder interpretierbare technische Realisierung, die durch Tests und Runtime-Evidence überprüfbar bleibt.Glossareintrag vollständig lesen entwickeln sich synchron.
- Plateaus liefern sichtbare Produktfortschritte.
- Meta-Dokumentation ohne absehbare Nutzung wird vermieden.
Beziehungen#
- Kontext & ZeitEngineering PhasesTechnical documentation artifact.Vollständig lesen — constrains