Kairo-Jinkendo/docs/architecture/methods/SPEC_D_maturity_progression_v0.1.md

SPEC-D — maturity_progression

Steuerungsmethode — Spec-Tiefe D v0.1

Status: vorläufig freigegeben (PO 2026-07-26) — mit zugehöriger Archetyp-Vollspec; Implementierungsausreichendheit noch offen Stand: 2026-07-26
Default für: A1 initiative.maturity_journey
Prozess: M1_Hybrid_Path_and_Depth_D_v0.1.md
Quellen: Decision-Lock A1, Archetyp-Vollspec A1, Kernel Freeze, AP2.0e
OM-Struktur (Stage Activity Set, Felder): verbindlich in SPEC_A1_maturity_journey_v0.1.md §4 / §10

---

D1 Identität

Feld	Wert
method_key	maturity_progression
Rolle	primary (Ausführung — Kernel §6)
Label (DE)	Reifegrad-Progression
Zweck	Fähigkeit über Stufen steuern: Active Stage als Horizont; Next = fällige/alternierende Übung oder Stage-Action; bei Stage reached Activity Set wechseln. Weiches Vorhaben-Ende.

---

D2 Geltung

Feld	Wert
Default	A1 initiative.maturity_journey
kompatibel	nur A1 (Project-Spiegel project.maturity_journey)
nicht	Care (Wohlergehen); A3 (Rhythmus ohne Stufen); A2 (Liefer-DoD)
Dominanz	hybrid — Cadence-Zeit (Event) + Stufen-Plan (Plan)

---

D3 Horizon

Horizont	Bedeutung
Aktive maturity_stage	fokussierte Stufe; nur deren Stage Activity Set liefert Next
Plan-Nebenblick	nächste Stufe / Graph-Voraussetzungen — nicht Leading für Next
Ist	CadenceInstances + Stage-Actions der aktiven Stufe

Keine Next-Kandidaten aus inaktiven Stufen.

---

D4 Leading Work Item

Primär: CadenceInstance (Übung/Ritual am RecurringElement der aktiven Stufe).
Sekundär: Action (Stage-gebunden: Prüfung, Workshop, Nachweis).
Hinweis-Objekt (kein Leading Work): offenes Stufen-Kriterium / Verify-Fortschritt — erscheint in Next/Attention als Steuerhinweis.

Pro Recurring: genau eine offene Instanz (kein Duplikat bei Verpassen).

---

D5 Lifecycle-Pfad

Schritt	Status	Bedeutung
intake	active	Fähigkeit/Fokus, Vorhaben anlegen
method_bind	active	Default maturity_progression
structure_setup	active	Stufen, Graph, Stage Activity Sets (Recurrings + Stage-Actions), Alternanz-Gruppen
planning	light	Fokus/Frequenz; keine Vollprojekt-Planungspflicht
next_work / action_selection	active	Ready-Menge + Ranking (D6)
assignment	active	Owner-Actor an Ritual/Action (oft Selbst)
waiting	active	auf Cadence-Zeitpunkt / Erfüllung
result / event	active	practice done; externe/situative Events möglich
dod / validation	active	Stufenkriterien + Evidence vor reached
review	optional	bei Stufenwechsel / Nachweis — nicht jede Übung
adaptation	active	Set-Wechsel bei reached; manuelle Set-/Cadence-/Alternanz-Änderung
closure	soft / skip	Vorhaben-Ende nicht erzwungen

Kernel-Schlitznamen: Abbildung auf §4 Kernel (Intake … Closure).

---

D6 Next Action — konkrete Regeln

Ready-Menge (aktive Stufe)

Ein Work Item ist ready, wenn:

1. gebunden an die aktive maturity_stage und Aktivität aktiv, und
2. eines von:
   • Cadence ohne Alternanz: Instanz fällig oder überfällig (heute laut Cadence / overdue), oder
   • Cadence in Alternanz-Gruppe: Instanz ist das aktuelle Gruppenmitglied und fällig/überfällig (bzw. „dran“ laut Gruppenpolicy, wenn Cadence der Gruppe geteilt ist), oder
   • Stage-Action: Status offen und Deps/Blocker erlauben Arbeit

Nicht ready: Mitglieder einer Alternanz-Gruppe, die nicht aktuell sind — auch wenn ihre Kalender-Cadence „heute“ wäre.

Ranking

1. überfällige CadenceInstances (inkl. Alternanz-aktuell overdue)
2. heutige fällige Cadences (ohne Alternanz)
3. Alternanz-aktuell (fällig / dran)
4. offene Stage-Actions (sort_order / Fälligkeit)
5. Steuerhinweis offenes Stufen-Kriterium (wenn Verify offen und keine höher priorisierte Arbeit)

reason_codes:

Code	Bedeutung
maturity_practice_overdue	Übung überfällig
maturity_today_practice	Übung heute fällig
maturity_alternation_current	aktuelles Alternanz-Mitglied
maturity_stage_action	Stage-Action
maturity_stage_criteria	Kriterien/Verify-Hinweis

Leerer Fall: aktive Stufe, nichts fällig → „nächste geplante Übung am …“ / Fokus auf Kriterien — keine Fake-Action, keine Todo-Wand aus allen Stufen.

Alternanz (Steuerregeln)

1. Pro alternation_group_id genau ein aktuelles Mitglied (State am Group- oder Recurring-Kontext).
2. Nach erfolgreicher Erfüllung des aktuellen Mitglieds: Rotation zum nächsten alternation_order (zyklisch).
3. Attention bei overdue nur auf aktuelles Mitglied.
4. Bei Stage-Wechsel: Gruppen der alten Stufe inaktiv; neue Stufe eigene Gruppen.

Zeitversatz

Unabhängige Cadences am gleichen Stage → mehrere ready am selben Tag möglich; Ranking wie oben. Kein Zwang zur Alternanz.

---

D7 Attention

Code	Wann
maturity_practice_overdue	fällige/überfällige Übung (inkl. Alternanz-aktuell)
maturity_alternation_blocked	aktuelles Mitglied dauerhaft nicht erfüllbar / ohne Owner
maturity_stage_stagnant	aktive Stufe ohne Fortschritt (keine fulfilled practice / kein Kriterien-Fortschritt über Schwellwert)
maturity_criteria_open	Verify/Kriterien offen bei sonst leerer Ready-Menge oder Stage „bereit“
maturity_inactive_set	aktive Stufe ohne aktives Activity Set (Strukturfehler)

---

D8 Events

Event	Wirkung
practice done / Cadence erfüllt	Instanz schließen; nächste Instanz laut Cadence; bei Alternanz Rotation
Stage-Action done	aus Ready; ggf. Kriterien-Fortschritt
Evidence / Kriterium erfüllt	Validation-Fortschritt
stage reached (Verify ok)	altes Activity Set deaktivieren; nächste Stufe aktiv; neues Set aktiv (AP2.0e erweitert)
manuelle Adaptation (Set/Cadence/Alternanz)	Ready-Menge neu; auditiert
Cadence-Zeitpunkt erreicht	Event-Schub → Ready neu bewerten

---

D9 Nested

n/a als Parent-Methode. Kann Kind unter B2a sein — dann Parent-Impulse ≠ Child-Next (Kernel Q4).

Multi-Fähigkeit = mehrere Projects im selben Vorhaben, kein Nested-Parent/Child im Methoden-Sinn.

---

D10 OM-Voraussetzungen

Minimal	Optional / Template
Initiative A1 + Methode gebunden	Graph-Voraussetzungen
≥1 maturity_stage, eine aktiv	mehrere Fähigkeits-Projects
Stage Activity Set der aktiven Stufe (≥1 Recurring oder Stage-Action)	Alternanz-Gruppen
Recurring: Stage-Bindung, Cadence, aktiv/inaktiv	EFS Fokus/Frequenz
Evidence/Kriterien-Pfad für Verify

Felder alternation_group_id, alternation_order: Archetyp-Vollspec A1 §10.

---

D11 Extension Points

Art	Ziel
next_work_strategy	maturity_progression
attention_rules	Codes D7
horizon_resolver	aktive maturity_stage
dod_policy	Stage-Kriterien / Verify
adaptation_hooks	on_stage_reached → Set-Wechsel; manuelle Set-Änderung
steering_elements	next_action_primary, maturity_stage, recurring_rhythm
compatible_archetype_keys	initiative.maturity_journey
data_slices	recurring, roadmap, actions, evidence, decisions, reviews, projects, steering_methods

---

D12 Spannungen · PO

Punkt	Lage
Hybrid Dominanz	Cadence-Event + Stage-Plan — Kernel trägt Dual-Auslöser
Leading polymorph	Cadence + Action — Kernel Q2
Alternanz-State	Persistenz am Group-/Recurring-Kontext — Implementierungsdetail, fachlich hier verbindlich
Multi-Fähigkeit	mehrere Projects ok; kein Abnahme-Zwang für Kern-Kit

PO-Empfehlung: A1-Vollspec §4 OM + diese Spec-D = Steuervertrag; UI nur in Archetyp-Vollspec.