ET-VAL-WORK-ITEM-ADMISSION-001

Work Item Admission and Change Control#

Zweck#

Dieser Validator verhindert, dass Discoveries, optionale Verbesserungen oder redaktionelle Änderungen den freigegebenen Pflichtumfang einer GAP-Roadmap stillschweigend erhöhen.

Verbindliche Regeln#

Eine Änderung von mandatoryTotal oder baselineVersion ist nur gültig, wenn ein maschinenlesbarer Change Record vorliegt, der:

classification: mandatory-roadmap-change trägt,
ausdrücklich approved: true ist,
den vorherigen und neuen Baseline-Zustand vollständig benennt,
eine Begründung und die Auswirkungen auf Completion Criteria enthält,
Gesamtzahl und Baseline-Version gemeinsam ändert,
eine eindeutige Change-ID besitzt.

Die Klassen optional-improvement, [[ART-DEF-0053|discovery]] und deferred dürfen weder die Pflichtzahl noch die Baseline-Version verändern.

Change-Record-Format#

{
                  "changeId": "MRC-0001",
                  "classification": "mandatory-roadmap-change",
                  "approved": true,
                  "reason": "...",
                  "completionCriteriaImpact": "...",
                  "previous": {"baseline": "MVP-001", "baselineVersion": "1.0", "mandatoryTotal": 24},
                  "proposed": {"baseline": "MVP-001", "baselineVersion": "1.1", "mandatoryTotal": 25}
                }

Ausführung#

python 40-validation/validate-work-item-admission.py \
                  <gap-root> <repository-roots> <runtime-root> \
                  --previous-baseline <snapshot.json> \
                  [--change-record <change-record.json>] \
                  --work-item KT-0019

Ohne Change Record muss der aktuelle Baseline-Zustand exakt dem vorherigen Snapshot entsprechen.

Seiteneffekte#

Der Validator erzeugt ausschließlich Materialisierung und versiegelte in Runtime. Er nimmt selbst keine Roadmap-Änderung, kein Deployment und keine vor.