RP-KNOWLEDGE-EVOLUTION

Wissensevolutionsprozess#

Ziel#

Der Prozess überführt konkrete Erfahrung in dauerhaft nutzbares, nachvollziehbares und auf der richtigen Architekturebene verankertes Wissen.

Lebenszyklus#

1. Observation
                2. Finding
                3. Analysis
                4. Decision or Rule
                5. Implementation
                6. Verification
                7. Evidence
                8. Consolidation and Scope Classification
                9. Institutionalization
                10. Learning and Promotion

1. Observation#

Ein unerwartetes Verhalten, ein Fehler, eine Abweichung oder eine positive Erkenntnis wird mit unveränderten Fakten und ihrem konkreten Kontext dokumentiert.

2. Finding#

Die Beobachtung erhält eine stabile Identity und einen abgegrenzten Scope. Findings sind keine Schuldzuweisungen und dürfen auch positive Beobachtungen enthalten.

3. Analysis#

Symptom, Ursache, Kontext und Reichweite werden getrennt betrachtet. Eine lokale Fehlermeldung darf nicht vorschnell zu einer allgemeinen Regel verallgemeinert werden.

4. Decision or Rule#

Aus der validierten Ursache entsteht je nach Tragweite:

• eine Engineering Rule,
• ein Architecture Principle,
• eine ADR,
• eine Änderung eines Reference Models oder Building Blocks,
• eine solutionspezifische Designentscheidung.

5. Implementation#

Die Regel wird im zuständigen Repository materialisiert. Ein Textvorschlag allein gilt nicht als Umsetzung.

6. Verification#

Die Änderung wird gegen das beabsichtigte Ergebnis geprüft. Wo sinnvoll, entsteht ein stabilisierender Regressionstest.

7. Evidence#

Verifikationsergebnisse, Reports und relevante Logauszüge werden als ⌘EvidenceTechnical documentation artifact. referenziert. Secrets und personenbezogene Daten werden entfernt oder geschützt.

Evidence bleibt von Learning unterscheidbar: Evidence belegt konkretes Geschehen; Learning formuliert die daraus validierte Erkenntnis.

8. Consolidation and Scope Classification#

Die Erkenntnis wird mit bestehenden Modellen, Decisions, Findings und Wissensartefakten verglichen.

Dabei wird entschieden:

• ob sie bereits beschrieben ist,
• ob sie bestehendes Wissen präzisiert,
• welche fachliche Heimat zuständig ist,
• auf welcher Architekturebene sie gilt,
• ob abweichende Aussagen erhalten und als Review-Konflikt markiert werden müssen.

Die Migrationseinheit ist der Gedanke, nicht das historische Dokument.

9. Institutionalization#

Ein ⌘FindingTechnical documentation artifact. erreicht Institutionalized, wenn Architektur, Implementierung, Verification, Evidence und Dokumentation synchron sind. Fachliche Information wird nicht stillschweigend gelöscht; konkurrierende Aussagen werden konsolidiert oder nachvollziehbar eingeordnet.

10. Learning and Promotion#

Die verallgemeinerbare Erkenntnis wird als ⌘Learning NuggetDidaktisches Wissensartefakt, das ein Architektur- oder Technikthema verständlich erklärt, ohne normative Architekturregeln zu ersetzen., Glossary Entry, Help Context, Known Pitfall, Story, Pattern oder Guideline verfügbar gemacht.

Wird ein Learning Nugget gewählt, gelten Auslöser, Pflichtstruktur, Abgrenzung und Verknüpfung des Learning Nugget Contract. Die Wahl erfolgt erst nach Konsolidierung und Scope-Klassifikation; sie ist keine automatische Reaktion auf eine einzelne Beobachtung.

Eine ⌘PromotionTechnical documentation artifact. erfolgt nur so weit, wie die Evidence trägt:

• konkrete Laufzeiterfahrung → Execution Learning,
• wiederholbare Engineering-Erkenntnis → Engineering Learning,
• lösungsweite Erkenntnis → Solution Learning,
• universell tragfähige Erkenntnis → Enterprise Learning.

Niedrigere Ebenen dürfen höheres Wissen spezialisieren, aber nicht neu definieren.

Governance#

• Fakten, Status, Daten und Zahlen aus führenden Quellen werden nicht eigenmächtig verändert.
• Mehrere Symptome dürfen auf ein Finding verweisen.
• Eine ADR darf mehrere Findings adressieren.
• Widersprüchliche Findings werden nicht gelöscht, sondern über Status und Beziehungen eingeordnet.
• Automatisierte Werkzeuge dürfen strukturieren, normalisieren und verlinken; fachliche Wahrheit wird durch Review und Entscheidung bestimmt.
• Quellartefakte werden erst entfernt, wenn ihre semantisch relevanten Inhalte gesichert übernommen oder bewusst verworfen wurden.

Beziehungen#

• ◆EA-SEMANTICS-LAYERED-KNOWLEDGE-001Definiert Gültigkeit, Herkunft und Entwicklung von Wissensartefakten entlang der Architekturebenen. — materializes
• ◆KNOWLEDGE-REFERENCE-MODELOrdnet Wissensartefakte, Wissensbeziehungen, fachliche Heimat, Scope und Sprachfassungen universell ein. — uses