README

Validierung#

• KNOWLEDGE_BASELINE_VALIDATION.md beschreibt die reproduzierbare Phase-2-Baseline-Prüfung.

Kanonischer Einstieg#

1. Validator Architecture
2. Finding and Severity Contract
3. Validation Execution Contract
4. Artifact Manifest Validator Tool Contract
5. Validator Verification

Vorhandene Werkzeuge#

• ◆validate-artifact-manifests.py – prüft Artifact-Manifeste, Referenzen und deklarierte ⌘EvidenceTechnical documentation artifact..
• ◆report-quality-model.py – erzeugt einen menschenlesbaren Quality-Model-Report.
• ◆report-verification-coverage.py – erzeugt einen Coverage- und Gap-Report.
• ◆validate-context-impact.py – prüft Kontextwirkungsnachweise bei Verschiebung, Umbenennung und Gültigkeitsänderung.

Beispiel#

python3 validate-artifact-manifests.py \
                  ~/engineering/engineering-platform \
                  --solution-architecture ~/engineering/solution-architecture \
                  --enterprise-architecture ~/engineering/enterprise-architecture

Regelquellen und Tests#

• ◆artifact-manifest-schema.json
• human-readable-code-contract-rules.md
• human-readable-test-contract-rules.md
• Tests unter ../98-tests/

Ein erfolgreicher Lauf bestätigt ausschließlich die implementierten Prüfregeln und ersetzt keine fachliche ⌘FreigabeEin Release ist ein bewusst freigegebener und nachvollziehbarer Stand von Artefakten und ihrer Realisierung. oder Regression.

Kontextwirkungs-Pflichtprüfung#

• Vertrag: CONTEXT_IMPACT_VALIDATION.md
• Validator: ◆validate-context-impact.py
• Test: ../98-tests/test_validate_context_impact.py

Der Validator fordert für jede Änderung betroffene Meanings, Beziehungen, Artefakte, Zeitkontext und Folgeprüfungen. not-applicable ist nur mit Begründung zulässig; fehlende Evidence führt zu FAILED. Fachlich offene, aber vollständig beschriebene Fälle werden als REVIEW_REQUIRED ausgegeben.

Zeitkontext und Gültigkeitsnetz#

• Vertrag: TEMPORAL_CONTEXT_VALIDATION.md
• Validator: ◆validate-temporal-context.py
• Test: ../98-tests/test_validate_temporal_context.py

Der Validator prüft Zeitkontext, zeitliche Reihenfolge und die deklarative Vollständigkeit von ⌘supersedessupersedes bedeutet: Ein neuer Stand löst einen früheren Stand explizit ab., evolves_from und valid_during. Er leitet keine fachliche Ablösung ab: nicht auflösbare Ziele oder fehlende Ablösungsbelege bleiben REVIEW_REQUIRED.

Learning Nuggets zu den frühen Validatoren#

Die zehn Nuggets NUG-SE0024-* bis NUG-SE0033-* erklären die jeweiligen Prüfer mit Problem, Beispiel, ⌘BedeutungBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen. und Grenzen. Sie ergänzen die knappen Verträge, ersetzen sie aber nicht. Die Struktur-Evidence liegt unter reports/SE-0033A-learning-nugget-validation.json; die Sprachheuristik wird mit ihren expliziten Reviewfällen getrennt ausgewiesen.

Frühes Semantic Quality Gate#

• Vertrag: SEMANTIC_QUALITY_GATE.md
• Validator: ◆validate-semantic-quality-gate.py
• Test: ../98-tests/test_validate_semantic_quality_gate.py

Das Gate fasst die Einzelreports zusammen. Deterministische Fehler und fehlende Pflichtreports blockieren; REVIEW_REQUIRED bleibt separat sichtbar.

Cross-Repository Reference Validation#

• Vertrag: CROSS_REPOSITORY_REFERENCE_VALIDATION.md
• Validator: ◆validate-cross-repository-references.py
• Test: ../98-tests/test_validate_cross_repository_references.py

Artifact-Manifest-Kette RC-0002#

◆validate-artifact-manifests.py ist die ausführbare Validierungsstufe von RC-0002. Es prüft konkrete Engineering-Manifeste gegen ihre Struktur, referenzierte Architekturartefakte, Module, Tests und Verification Evidence.

• Evidence Freshness Validation

Evidence ⌘promotionTechnical documentation artifact. and ⌘retentionTechnical documentation artifact.#

• EVIDENCE_PROMOTION_RETENTION.md
• ◆evidence_retention.py
• ◆promote-evidence.py

Nur automatisch versiegelte und fresh validierte Evidence darf active werden. Abgelöste und fehlgeschlagene Nachweise bleiben traceable.

Execution lifecycle end-to-end validation#

• EXECUTION_LIFECYCLE_END_TO_END_VALIDATION.md
• ◆validate-execution-lifecycle.py

The validator verifies success, controlled failure/rollback, ◆retentionTechnical documentation artifact. and ◆promotionTechnical documentation artifact. transitions as one lifecycle.

Build Contract Validation#

• BUILD_CONTRACT_VALIDATION.md
• ◆validate-build-contract.py

Der Validator realisiert die Validation-Stufe von RC-0003 und erzeugt Build-Materialisierung sowie versiegelte Runtime-Evidence, ohne Deployment oder Promotion auszuführen.

Workspace Contract Validation#

• ◆validate-workspace-contract.py
• WORKSPACE_CONTRACT_VALIDATION.md

Validation Contract Validation#

• VALIDATION_CONTRACT_VALIDATION.md
• ◆validate-validation-contract.py

Der Validator realisiert RC-0006 und erzeugt eine materialisierte Validation sowie versiegelte Runtime-Evidence.

Automated roadmap progress validation#

• Contract: ROADMAP_PROGRESS_VALIDATION.md
• Validator: ◆validate-roadmap-progress.py
• Verifies the finite GAP roadmap, phase state, manifest and dashboard consistency.

Work Item Admission and Change Control#

• Vertrag: WORK_ITEM_ADMISSION_CHANGE_CONTROL.md
• Validator: ◆validate-work-item-admission.py

Repeatable Bundle ⌘IntakeTechnical documentation artifact. Validation#

• Vertrag: BUNDLE_INTAKE_VALIDATION.md
• Validator: ◆validate-bundle-intake.py

KT-0021 Operational Runbook and Recovery#

• OPERATIONAL_RUNBOOK_RECOVERY.md
• ◆validate-operational-recovery.py
• materialisiert Wiederanlauf- und Recovery-Evidence in Runtime.

KT-0022 Mandatory ⌘DiscoveryTechnical documentation artifact. Closure Review#

• MANDATORY_DISCOVERY_CLOSURE_REVIEW.md
• ◆validate-mandatory-discovery-closure.py
• enumeriert Discoveries und trennt Abschlussblocker vom optionalen Backlog.

Full Repository Landscape Validation#

- -

Full Repository Landscape Validation#

• FULL_REPOSITORY_LANDSCAPE_VALIDATION.md
• ◆validate-repository-landscape.py

GAP MVP Completion and Maintenance Handover#

• Vertrag: GAP_MVP_COMPLETION_MAINTENANCE_HANDOVER.md
• Validator: ◆validate-gap-mvp-completion.py
• Zweck: terminale Prüfung des MVP-001-Baseline und Übergang in MAINTENANCE_READY.