README

Lernen#

Zweck#

Dieser Bereich enthält kurze, wiederverwendbare und nachvollziehbar hergeleitete Enterprise-Erkenntnisse. Enterprise Learning ist universell, lösungsunabhängig und auf ⌘EvidenceTechnical documentation artifact. oder konsolidierter Architekturbegründung aufgebaut.

Verantwortlichkeit#

99-learning/ verantwortet ausschließlich Learning-Artefakte, deren höchste tragfähige Gültigkeitsebene Enterprise ist.

Solution-, Design-, Engineering- und Execution-Learning verbleiben in ihrer fachlichen Heimat. Sie können später auf Enterprise-Ebene promoviert werden, wenn ihre Verallgemeinerung durch ausreichende Evidence getragen wird.

Charakter eines Learning Nuggets#

Ein Enterprise ⌘Learning NuggetDidaktisches Wissensartefakt, das ein Architektur- oder Technikthema verständlich erklärt, ohne normative Architekturregeln zu ersetzen.:

• beantwortet, warum etwas grundsätzlich gilt,
• besitzt eine stabile Identity und ⌘ProvenanceProvenienz beschreibt die nachvollziehbare Herkunft eines Wissenselements, einer Aussage oder einer abgeleiteten Darstellung.,
• verweist auf tragende Modelle, Decisions, Findings oder Evidence,
• erklärt statt nur eine Regel zu wiederholen,
• bleibt von konkreten Implementierungsdetails unabhängig,
• kann von Solutions spezialisiert, aber nicht stillschweigend umdefiniert werden.

Inhalt#

• Learning Nugget Contract – verbindliche ⌘BedeutungBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen., Auslöser, Struktur, Verknüpfung und Qualitätsgrenze.
• Learning Nugget Template – kanonische Eintragsvorlage.
• freigegebene oder zur Review gestellte Enterprise Learning Nuggets,
• Navigation und Querverweise zu tragenden Architekturartefakten,
• bewusst hier geführte Herleitungen universeller Erkenntnisse.

Gehört ausdrücklich nicht hier hinein#

• rohe Beobachtungen oder unverarbeitete Logs,
• veränderliche Laufzeitzustände und generierte Betriebsausgaben,
• rein solutionspezifische oder komponentenspezifische Erkenntnisse,
• unkontrollierte Duplikate bereits führender Quellen,
• Regeln ohne Herleitung oder Evidence-Bezug.

Wissensentwicklung#

Observation
                → Finding
                → Analysis
                → Decision or Rule
                → Implementation
                → Verification
                → Evidence
                → Consolidation
                → Learning

Nicht jede Evidence führt zu Enterprise Learning. Die ⌘PromotionTechnical documentation artifact. endet auf der höchsten Ebene, für die die Erkenntnis tatsächlich trägt.

Beziehungen#

• 70-semantics/explainability-knowledge-evidence-learning-structure.md ordnet Learning in die gemeinsame Referenzkette mit Explainability, Knowledge und Evidence ein.
• 70-semantics/layered-knowledge-model.md definiert Scope und Ebenen.
• 85-reference-artifacts/reference-process/knowledge-evolution-process.md definiert die Entstehung und Promotion.
• 85-reference-artifacts/reference-model/knowledge-reference-model.md definiert die Wissensartefakte.
• ADRs und Principles ordnen normative Konsequenzen ein.

Typischer Workflow#

Ein Nugget wird aus validierter Erkenntnis erstellt oder konsolidiert, gegen führende Quellen geprüft, mit Provenance und Beziehungen versehen und erst danach promoted.

Der vollständige Auslöser- und Strukturvertrag steht im Learning Nugget Contract.

Dokumente#

• Ln Arch 001 Architecture Grows Through Consolidation
• Ln Obs 001 Systems Must Explain Themselves
• Ln Exp 001 Reason Codes Are Not Explanations
• Ln Exp 002 Localization Must Not Change The Reason
• Ln Test 001 Tests As Executable Specification
• Ln Test 002 Happy Path Is Not A Safety Net
• Ln Test 003 Boundaries Concurrency And Transactions
• Evidence Closes The Engineering Loop
• Import Success Is Not Engineering Success
• Verification Coverage Not Test Counting
• Verify Your Own Work
• Historische Learning-Nugget-Konsolidierung