Kairo-Jinkendo/docs/architecture/methods/SPEC_D_maturity_progression_v0.1.md
Lars 3a0ef3a734
Some checks failed
Deploy Development / deploy (push) Successful in 52s
Test Suite / pytest-backend (push) Failing after 5m3s
Test Suite / k6 /api/health Baseline (push) Has been skipped
Test Suite / playwright-smoke (push) Has been skipped
Test Suite / lint-backend (push) Successful in 3s
Test Suite / compose-smoke (push) Has been skipped
feat(A1): Progression Join-Graph und Multi-Strang-Horizon
join_gate, strand_project_id, Join-Auto-Schalten, multi-active Gates, Progression-Demo und PO-Lock-Spec. FE: Today strang-gruppiert, Join-Warteliste in Kontrolle.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-28 16:28:08 +02:00

8.9 KiB
Raw Permalink Blame History

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-28 (PO-Lock Progressionsmodell — SPEC_A1_Progression_Model_PO_Lock_v0.1.md)
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 parallele Strang-Pfade (Gate-Graph) steuern; Next = fällige Übungen auf aktiven Gates; bei Gate reached strangspezifischer Activity-Set-Wechsel. 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

PO-Lock (2026-07-28): SPEC_A1_Progression_Model_PO_Lock_v0.1.md §3 — ersetzt „eine aktive Stufe initiative-weit“ für Multi-Strang.

Horizont Bedeutung
Aktive Gates (Menge) Alle maturity_stage/Gate-Knoten mit Status active, die graph-ready sind; mehrere parallel (je Strang max. ein aktives Gate auf dem Pfad)
Strang Project — paralleler Fähigkeits-Pfad; Übungen mit project_id
Join-Gate wird active, wenn alle requires-Vorgänger reached
Plan-Nebenblick blockierte / geplante Gates — nicht Leading für Next
Ist CadenceInstances + Stage-Actions der aktiven Gates

Keine Next-Kandidaten aus Gates, die nicht active/graph-ready sind.

Lineares Demo-Kit (1 Strang, Stufe 13): Teilmenge mit effektiv einem aktiven Gate — kein PO-Kernbild.


D4 Leading Work Item

Primär: CadenceInstance (Übung am RecurringElement eines aktiven Gates, optional Strang via project_id).
Sekundär: Action (Gate-gebunden: Prüfung, Workshop — selten bei A1).
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 Gates)

Ein Work Item ist ready, wenn:

  1. gebunden an ein aktives, graph-ready Gate und Aktivität aktiv, und
  2. (Multi-Strang) project_id passt zum Strang des Gates, und
  3. 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) Activity Set dieses Gates deaktivieren; pro Strang nächstes Gate / neues Set (Join: strangspezifisch)
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 Menge aktiver, graph-ready Gates (Multi-Strang)
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 / Stränge — Kernbild A1 (PO-Lock); Gate-Graph verbindet Pfade
Single-active initiative-wide widerrufen für Multi-Strang — nur Demo-Kit

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