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.