feat(A1): Progression Join-Graph und Multi-Strang-Horizon
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
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
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>
This commit is contained in:
1 parent
192a65a798
commit
3a0ef3a734
29 files changed
+1457
-230
No files matched your search
@@ -2,14 +2,14 @@
|
||||
|
||||
**Prozess:** `../M1_Hybrid_Path_and_Depth_D_v0.1.md`
|
||||
**Methodenkern (Freeze):** [`../Kairo_Steering_Method_Kernel_v0.1.md`](../Kairo_Steering_Method_Kernel_v0.1.md) — Methodentypen: Kernel §6
|
||||
**PO 2026-07-26:** Architektur beibehalten; Spec-D-Batch **vorläufig freigegeben** (Implementierungsausreichendheit noch offen)
|
||||
**PO 2026-07-28:** Spec-D `maturity_progression` — **Horizon/Progression PO-Lock** in [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](../../product/archetypes/SPEC_A1_Progression_Model_PO_Lock_v0.1.md); Spec-D D3/D6/D8 angepasst.
|
||||
|
||||
| Methode | Typ | Datei | Status |
|
||||
|---------|-----|-------|--------|
|
||||
| `sequential_dependency` | Primary (Ausführung) | SPEC_D_sequential_dependency_v0.1.md | vorläufig freigegeben|
|
||||
| `continuous_product` | Primary (Ausführung) | SPEC_D_continuous_product_v0.1.md | vorläufig freigegeben|
|
||||
| `recurring_control` | Primary (Ausführung) | SPEC_D_recurring_control_v0.1.md | vorläufig freigegeben|
|
||||
| `maturity_progression` | Primary (Ausführung) | SPEC_D_maturity_progression_v0.1.md | vorläufig freigegeben|
|
||||
| `maturity_progression` | Primary (Ausführung) | SPEC_D_maturity_progression_v0.1.md | PO-Lock Horizon (2026-07-28) |
|
||||
| `checklist_flow` | Primary (Ausführung) | SPEC_D_checklist_flow_v0.1.md | vorläufig freigegeben|
|
||||
| `care_navigation` | Primary (Ausführung) | SPEC_D_care_navigation_v0.1.md | vorläufig freigegeben|
|
||||
| `dispute_procedure` | Primary (Ausführung) | SPEC_D_dispute_procedure_v0.1.md | vorläufig freigegeben|
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
## 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
|
||||
**Stand:** 2026-07-28 (PO-Lock Progressionsmodell — [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](../../product/archetypes/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
|
||||
@@ -17,7 +17,7 @@
|
||||
| `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. |
|
||||
| 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. |
|
||||
|
||||
---
|
||||
|
||||
@@ -34,20 +34,26 @@
|
||||
|
||||
## D3 Horizon
|
||||
|
||||
**PO-Lock (2026-07-28):** [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](../../product/archetypes/SPEC_A1_Progression_Model_PO_Lock_v0.1.md) §3 — ersetzt „eine aktive Stufe initiative-weit“ für Multi-Strang.
|
||||
|
||||
| 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 |
|
||||
| **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 inaktiven Stufen.
|
||||
Keine Next-Kandidaten aus Gates, die nicht `active`/graph-ready sind.
|
||||
|
||||
**Lineares Demo-Kit (1 Strang, Stufe 1–3):** Teilmenge mit effektiv einem aktiven Gate — kein PO-Kernbild.
|
||||
|
||||
---
|
||||
|
||||
## D4 Leading Work Item
|
||||
|
||||
**Primär:** `CadenceInstance` (Übung/Ritual am RecurringElement der aktiven Stufe).
|
||||
**Sekundär:** `Action` (Stage-gebunden: Prüfung, Workshop, Nachweis).
|
||||
**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).
|
||||
@@ -77,12 +83,13 @@ Kernel-Schlitznamen: Abbildung auf §4 Kernel (Intake … Closure).
|
||||
|
||||
## D6 Next Action — konkrete Regeln
|
||||
|
||||
### Ready-Menge (aktive Stufe)
|
||||
### Ready-Menge (aktive Gates)
|
||||
|
||||
Ein Work Item ist ready, wenn:
|
||||
|
||||
1. gebunden an die **aktive** `maturity_stage` und Aktivität **aktiv**, und
|
||||
2. eines von:
|
||||
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
|
||||
@@ -141,7 +148,7 @@ Unabhängige Cadences am gleichen Stage → mehrere ready am selben Tag möglich
|
||||
| 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) |
|
||||
| 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 |
|
||||
|
||||
@@ -175,7 +182,7 @@ Felder `alternation_group_id`, `alternation_order`: Archetyp-Vollspec A1 §10.
|
||||
|-----|------|
|
||||
| next_work_strategy | `maturity_progression` |
|
||||
| attention_rules | Codes D7 |
|
||||
| horizon_resolver | aktive `maturity_stage` |
|
||||
| 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` |
|
||||
@@ -191,6 +198,7 @@ Felder `alternation_group_id`, `alternation_order`: Archetyp-Vollspec A1 §10.
|
||||
| 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 |
|
||||
| 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.
|
||||
@@ -7,12 +7,12 @@
|
||||
**UI-Navigation (Archetyp):** [`ARCHETYPE_UI_NAVIGATION_v0.1.md`](ARCHETYPE_UI_NAVIGATION_v0.1.md)
|
||||
**Backlog / Epic / Dual Commit:** [`../../architecture/ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md`](../../architecture/ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md)
|
||||
|
||||
**PO 2026-07-26:** Specs **vorläufig freigegeben** — Implementierungsausreichendheit noch nicht abschließend bewertet.
|
||||
**PO 2026-07-28:** A1 **PO-Lock Progressionsmodell** — [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](SPEC_A1_Progression_Model_PO_Lock_v0.1.md) (Option C nach Validation No-Go).
|
||||
|
||||
| ID | Datei | Status |
|
||||
|----|-------|--------|
|
||||
| C1 | [SPEC_C1_dispute_case_v0.1.md](SPEC_C1_dispute_case_v0.1.md) | vorläufig freigegeben |
|
||||
| A1 | [SPEC_A1_maturity_journey_v0.1.md](SPEC_A1_maturity_journey_v0.1.md) | vorläufig freigegeben |
|
||||
| A1 | [SPEC_A1_maturity_journey_v0.1.md](SPEC_A1_maturity_journey_v0.1.md) | PO-Lock Progression (2026-07-28) |
|
||||
| A2 | [SPEC_A2_linear_project_v0.1.md](SPEC_A2_linear_project_v0.1.md) | vorläufig freigegeben |
|
||||
| A3 | [SPEC_A3_recurring_program_v0.1.md](SPEC_A3_recurring_program_v0.1.md) | vorläufig freigegeben |
|
||||
| B1 | [SPEC_B1_checklists_v0.1.md](SPEC_B1_checklists_v0.1.md) | vorläufig freigegeben |
|
||||
|
||||
@@ -0,0 +1,220 @@
|
||||
# A1 — Progressionsmodell PO-Lock
|
||||
## v0.1 (Option C, AP2.1)
|
||||
|
||||
**Status:** **PO-lock** (2026-07-28) — präzisiert Spec A1 §4 und Spec-D D3/D6 vor Implementierung
|
||||
**Auslöser:** AP2.1 PO-Validation — flache Rhythmus-Liste deckt Nutzerbild nicht ab
|
||||
**Bezug:** `SPEC_A1_maturity_journey_v0.1.md`, `SPEC_D_maturity_progression_v0.1.md`
|
||||
|
||||
---
|
||||
|
||||
## 1. PO-Kernentscheidung
|
||||
|
||||
A1 ist **kein lineares Stufenmodell mit losem „Wiederkehrend“**, sondern ein **Progressionsmodell über parallele Stränge (Pfade)** mit **Gate-Graph**, **Activity Sets pro Gate** und **wiederkehrenden Übungen als Ist-Tracking**.
|
||||
|
||||
| PO-These | Lock |
|
||||
|----------|------|
|
||||
| Primär ist **Üben / Wiederholung**, nicht committete Einmal-APs | ✓ Spec-D D4 unverändert |
|
||||
| Komplexität liegt in **Planung + Durchführung paralleler Progressionen** | ✓ ab jetzt explizit |
|
||||
| **Rhythmus** ist Eigenschaft der **Übung** (`RecurringElement`), kein losgelöstes Planungsobjekt | ✓ |
|
||||
| **Strang** = `Project` (`container_kind=stream`); **Work-Gate** = `maturity_stage` mit Activity Set | ✓ |
|
||||
| **Join** = Schaltknoten — kein Activity Set; konsolidierter Status; multi-in / multi-out | ✓ (§10) |
|
||||
| **Kein Terminalgate-Typ** — letztes Gate vor Join ist normales Gate; Kante genügt | ✓ (§10) |
|
||||
|
||||
---
|
||||
|
||||
## 2. Referenzbeispiel (PO) — Mawashi Geri
|
||||
|
||||
**Vorhaben:** Fähigkeit „Mawashi Geri zum Kopf treffen“.
|
||||
|
||||
**Stränge (Projects):**
|
||||
|
||||
| Strang | Beispiel-Gates (Pfad) |
|
||||
|--------|------------------------|
|
||||
| Dehnung | D1 → D2 |
|
||||
| Hüftrotation | H1 → H2 |
|
||||
| Technik | T1 → T2 |
|
||||
|
||||
**Join (Schaltknoten):** „Mawashi Geri zur Hüfte“ — **keine Übungen**; Eingänge von D2, H2, T2; Ausgänge z. B. zu D3, G1 (Gleichgewicht). Konsolidierter Status **liegt am Join**, nicht an D2/H2/T2.
|
||||
|
||||
**Nach Schalten (MVP):** alle Ausgänge feuern → Nachfolge-Gates je Strang `active` → Activity Sets frei.
|
||||
|
||||
**Leitfrage:** *Welche Übungen sind heute auf aktiven Strang-Gates fällig — und welche Joins warten noch auf welche Eingänge?*
|
||||
|
||||
---
|
||||
|
||||
## 3. Horizon — Ersetzt „eine aktive Stufe initiative-weit“
|
||||
|
||||
### 3.1 Alt (v0.1, zu eng)
|
||||
|
||||
> Genau **eine** `maturity_stage` mit Status `active` pro Initiative.
|
||||
|
||||
Gilt **nicht mehr** für Multi-Strang-Progression (nur noch für lineares Demo-Kit „Spagat 1–2–3“).
|
||||
|
||||
### 3.2 Neu (PO-lock)
|
||||
|
||||
| Regel | Bedeutung |
|
||||
|-------|-----------|
|
||||
| **H1 — Parallele aktive Gates** | Initiative-weit **mehrere** Gates dürfen `active` sein — je Strang höchstens **ein** aktives Gate auf dem linearen Pfadfortschritt |
|
||||
| **H2 — Strang** | `Project` mit Archetyp-Spiegel `project.maturity_journey`; optional `roadmap_item_id` am Gate für Zuordnung |
|
||||
| **H3 — Join (Schaltknoten)** | Join **nie** in Today/Next; Status am Join = welche **Eingänge** noch nicht `reached`; Schaltbedingung = alle Eingänge erfüllt |
|
||||
| **H4 — Ready / Next** | Ready-Menge = Activity Sets aller **aktiven Work-Gates** (`maturity_stage`); Joins ausgeschlossen |
|
||||
| **H5 — Inaktive Pfade** | Gates `planned` / blockiert durch Graph → deren Übungen **nicht** in Next/Today |
|
||||
|
||||
**Horizon-Resolver (Ziel):** Menge `{ work_gate_id | status=active ∧ graph_ready ∧ hat Activity Set }` — Join-Knoten nie enthalten.
|
||||
|
||||
---
|
||||
|
||||
## 4. Activity Set — Bindung Übung ↔ Pfad
|
||||
|
||||
### 4.1 Was eine „Übung“ ist
|
||||
|
||||
| Begriff UI | OM-Entität | Pflicht-Bindung |
|
||||
|------------|------------|-----------------|
|
||||
| Übung / Ritual | `RecurringElement` | `roadmap_item_id` → Gate |
|
||||
| Strang | `project_id` → Project (Strang) | **ja**, wenn ≥2 Stränge |
|
||||
| Rhythmus | `interval_days`, Alternanz-Felder | am Recurring |
|
||||
| Heute erledigt | `CadenceInstance` | pro Recurring |
|
||||
|
||||
**Anti-Pattern (PO):** flache Liste „Wiederkehrend“ ohne Gate- und Strang-Bezug.
|
||||
|
||||
### 4.2 Einmal-Aktivitäten
|
||||
|
||||
`Action` nur **sekundär** (Prüfung, Workshop, Nachweis) — an Gate + optional Strang. Nicht Träger täglicher Übung.
|
||||
|
||||
### 4.3 Messbarkeit
|
||||
|
||||
| Ebene | Mechanismus |
|
||||
|-------|-------------|
|
||||
| Ist (Tages-) | `CadenceInstance.measurement_note` |
|
||||
| Plan (Gate) | `RoadmapItemCriterion` mit `criterion_kind: metric` |
|
||||
| Verify | Evidence + Kriterien vor `reached` |
|
||||
|
||||
---
|
||||
|
||||
## 5. Verify, Schalten, Set-Wechsel
|
||||
|
||||
### 5.1 Work-Gate (mit Activity Set)
|
||||
|
||||
Bei `reached` eines Work-Gates **G**:
|
||||
|
||||
1. Activity Set von **G** deaktivieren.
|
||||
2. Hat **G** einen **Join** als direkten Nachfolger (Kante G → Join): **kein** auto-next auf dem Strang — Beitrag zum Join ist erfüllt; Strang pausiert bis Join schaltet.
|
||||
3. Hat **G** ein **Work-Nachfolge-Gate** auf demselben Strang: dieses → `active` (wenn unblocked).
|
||||
4. Audit + Journey-Event.
|
||||
|
||||
### 5.2 Join (Schaltknoten, §10)
|
||||
|
||||
Bei **Schaltbedingung erfüllt** (alle Eingänge `reached`):
|
||||
|
||||
1. Join-Status → `reached` (automatisch oder explizites „Schalten“ — **kein** Verify über Übungs-Kriterien).
|
||||
2. **MVP:** **alle** Ausgangs-Gates → `active` (sofern Work-Gates mit Activity Set).
|
||||
3. Activity Sets der neu aktiven Gates freischalten.
|
||||
4. Audit + Journey-Event („Join geschaltet: {Titel}“).
|
||||
|
||||
**Stufe B:** selektives Schalten von Ausgängen (If/Else) — §10.4.
|
||||
|
||||
**Nicht:** pauschal „nächste lineare Stufe 2“ initiative-weit (Demo-Kit-Ausnahme).
|
||||
|
||||
---
|
||||
|
||||
## 6. UI-Pflicht (Plan vor Today)
|
||||
|
||||
| Fläche | Inhalt (PO) |
|
||||
|--------|-------------|
|
||||
| **Plan → Struktur** | Stränge + Graph; Joins als **Knoten** (Eingänge/Ausgänge sichtbar) |
|
||||
| **Plan → Gate-Detail** | Nur **Work-Gates**: Activity Set, Strang, Cadence, metric-Kriterien |
|
||||
| **Plan → Join-Detail** | Titel, Eingänge, Ausgänge, Schaltstatus — **kein** Activity Set |
|
||||
| **Ausführen → Today** | fällige Übungen nur von **aktiven Work-Gates** |
|
||||
| **Kontrolle** | Join-Warteliste: *„{Join-Titel} wartet auf: Dehnung/D2, …“* |
|
||||
| **Journey** | Set-Wechsel, Verify, Messwerte |
|
||||
|
||||
**Nicht** als Haupt-IA: generisches „Wiederkehrend“ ohne Plan-Kontext.
|
||||
|
||||
---
|
||||
|
||||
## 7. MVP-Stufe A — Abgrenzung nach PO-Lock
|
||||
|
||||
| Ebene | Inhalt | Stufe A |
|
||||
|-------|--------|---------|
|
||||
| **Demo Minimum** | Lineares Kit (Spagat 3 Stufen, 1 Strang) | Validation **technisch** — nicht PO-Kernbild |
|
||||
| **PO-Kernbild** | ≥2 Stränge + Graph + Gate-Activity-Set + Today | **Voraussetzung** für A1 Go in MVP §4 |
|
||||
| **Reich** | Alternanz, Templates (Kumite, Mawashi) | Stufe B / Template-APs |
|
||||
|
||||
**Konsequenz AP2.1:** A1 bleibt **No-Go** bis Progressions-IA (§6) mindestens für **2 Stränge + 1 Join** durchspielbar — nicht nur Cadence-Plumbing.
|
||||
|
||||
---
|
||||
|
||||
## 8. Implementierungsfolge (nach Lock, keine Spec-Neuerfindung)
|
||||
|
||||
```text
|
||||
AP-A1-PM-1 Spec-D D3/D6/D8 + A1 §4 (dieses Lock) ✓
|
||||
AP-A1-PM-2 Persistenz: recurring.project_id; strand_project_id am Gate; gate-activity-set API
|
||||
AP-A1-PM-3 Horizon multi-active; Join-Resolver (§10); single-active revoke
|
||||
AP-A1-PM-3b Join-Schalten: alle Ausgänge (MVP)
|
||||
AP-A1-PM-4 UI: Plan Struktur + Work-Gate-Detail + Join-Knoten
|
||||
AP-A1-PM-5 Today/Kontrolle: strang-gruppiert; Join-Warteliste
|
||||
AP-A1-PM-6 Template: 2 Stränge → 1 Join → 2+ Ausgänge
|
||||
```
|
||||
|
||||
Kein ADP für OM-Grundmodell — Erweiterung innerhalb RoadmapItem + Project + Recurring + CadenceInstance.
|
||||
|
||||
---
|
||||
|
||||
## 9. Offene Feinentscheide ( später )
|
||||
|
||||
| # | Thema | Default bis PO anders |
|
||||
|---|--------|------------------------|
|
||||
| 1 | Join als `item_type: join_gate` vs. `review_gate` + Flag | `join_gate` (neu, schlank) |
|
||||
| 2 | Max. aktive Work-Gates pro Strang | 1 |
|
||||
| 3 | Ranking zwischen Strängen | überfällig > heute > EFS später |
|
||||
| 4 | Join-Schalten automatisch vs. Bestätigung | automatisch wenn alle Eingänge `reached` |
|
||||
|
||||
---
|
||||
|
||||
## 10. Join als Schaltknoten (PO-Lock 2026-07-28)
|
||||
|
||||
### 10.1 Warum kein Terminalgate
|
||||
|
||||
Der Nutzer modelliert **normale Gates** auf Strang-Pfaden und **verbindet** deren letztes relevantes Gate per Kante mit einem **Join**. Ein extra Typ „Terminalgate“ ist **nicht nötig** und würde Graph-Logik sichtbar machen, die die Engine ohnehin aus Kanten ableitet.
|
||||
|
||||
### 10.2 Join — Definition
|
||||
|
||||
| Eigenschaft | Lock |
|
||||
|-------------|------|
|
||||
| **Rolle** | Konsolidierungs- und Schaltpunkt; **trägt den sichtbaren Meilenstein-Status** (z. B. „Mawashi Geri zur Hüfte“) |
|
||||
| **Activity Set** | **Keins** — keine `RecurringElement`, keine Tagesarbeit am Join |
|
||||
| **Eingänge** | Work-Gates aus ≥1 Strang (`requires`: Join wartet auf Gate) |
|
||||
| **Ausgänge** | Work-Gates auf Strang-Pfaden (`requires`: Nachfolger wartet auf Join) |
|
||||
| **Schaltbedingung (MVP)** | Alle Eingänge `reached` |
|
||||
| **Effekt (MVP)** | **Alle** Ausgänge schalten → Nachfolge-Gates `active` → deren Activity Sets frei |
|
||||
| **Horizon / Today** | Join erscheint **nicht** — nur in Kontrolle / Plan-Graph |
|
||||
|
||||
### 10.3 Graph-Kanten (bestehende Engine)
|
||||
|
||||
Semantik unverändert (`roadmap_engine`):
|
||||
|
||||
```text
|
||||
Eingang: join requires D2 (D2 muss reached sein, bevor Join schaltet)
|
||||
Eingang: join requires H2
|
||||
Ausgang: D3 requires join (D3 wird active, wenn Join reached)
|
||||
Ausgang: G1 requires join
|
||||
```
|
||||
|
||||
Der Join **entscheidet**, auf welche Stränge/Gates noch gewartet wird: UI listet offene Eingänge am Join-Titel — nicht als leere Strang-Strecke.
|
||||
|
||||
### 10.4 Stufe B — bedingte Ausgänge (If/Else)
|
||||
|
||||
| Stufe | Verhalten |
|
||||
|-------|-----------|
|
||||
| **A (MVP)** | Alle Ausgänge feuern gemeinsam |
|
||||
| **B** | Pro Ausgang optional Bedingung (Kriterium, Metrik, manuelle Wahl); Engine schaltet nur erfüllte Ausgänge |
|
||||
|
||||
Technische Andockpunkte vorhanden: `optional_branch`, später Kriterium an Kante — **nicht** Stufe A.
|
||||
|
||||
### 10.5 Strang ohne Ausgang nach Join
|
||||
|
||||
Hat ein Strang **keinen** Ausgangs-Gate am Join, endet sein Beitrag dort — **ohne** Dummy-Gates. Strang-Project kann `completed` / ruhend; Today bleibt leer für diesen Strang bis ggf. ein späterer Join einen neuen Ausgang öffnet.
|
||||
|
||||
---
|
||||
|
||||
*Bei Widerspruch zu A1 v0.1 / Spec-D v0.1 ohne PO-Lock-Vermerk gilt **dieses Dokument** für Progressions- und Horizon-Fragen.*
|
||||
@@ -2,8 +2,8 @@
|
||||
## Archetyp-Vollspec (implementierbar) v0.1
|
||||
|
||||
**Status:** vorläufig freigegeben (PO 2026-07-26) — Zielbild; Implementierungsausreichendheit noch nicht abschließend bewertet
|
||||
**Stand:** 2026-07-26
|
||||
**MVP-Stufe:** A
|
||||
**Stand:** 2026-07-28 (PO-Lock Progressionsmodell — siehe §14)
|
||||
**MVP-Stufe:** A (PO-Kernbild: Multi-Strang — §14.4)
|
||||
**Decision-Lock:** A1 Reifegrad
|
||||
**Default-Methode:** [`SPEC_D_maturity_progression_v0.1.md`](../../architecture/methods/SPEC_D_maturity_progression_v0.1.md)
|
||||
**Methodenkern:** `Kairo_Steering_Method_Kernel_v0.1.md`
|
||||
@@ -52,7 +52,10 @@ Kontinuierliche Entwicklung einer Fähigkeit über **Phasen/Stufen**. Eine Phase
|
||||
6. Innerhalb Mittelstufe Übung hinzufügen (Adaptation), auditiert.
|
||||
7. Optional zweites Fähigkeits-Project + Graph-Voraussetzung.
|
||||
|
||||
**Leitfrage:** Welche Stufe ist aktiv — und welche Übung/Aktivität ist **jetzt** dran (inkl. Alternanz/Zeitversatz)?
|
||||
**Leitfrage:** Welche **Strang-Gates** sind aktiv — und welche Übung ist **jetzt** auf welchem Pfad dran (inkl. Alternanz/Zeitversatz)?
|
||||
|
||||
**Referenzbeispiel (PO 2026-07-28) — parallele Progression „Mawashi Geri“:**
|
||||
Mehrere Stränge (Projects: Dehnung, Hüftrotation, Technik), je Strang Gate-Kette im Graph, Join-Gate („sicher zur Hüfte“), Activity Set pro Gate, nach Join strangspezifischer Set-Wechsel. Vollständig: [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](SPEC_A1_Progression_Model_PO_Lock_v0.1.md) §2.
|
||||
|
||||
---
|
||||
|
||||
@@ -67,25 +70,28 @@ evidence, decisions, reviews, steering_methods
|
||||
|
||||
## 4. Plan- / Ist-Vertrag
|
||||
|
||||
### 4.1 Stufen / Phasen
|
||||
### 4.1 Stufen / Phasen / Stränge
|
||||
|
||||
| Element | Rolle |
|
||||
|---------|--------|
|
||||
| `maturity_stage` (RoadmapItem) | Phase/Stufe; eine **aktive** Stufe (Horizon) |
|
||||
| Kriterien / Evidence | Verify vor `reached` |
|
||||
| Graph | Voraussetzungen zwischen Stufen und/oder Fähigkeits-Projects |
|
||||
| Project `project.maturity_journey` | Fähigkeit/Spur; eine oder mehrere |
|
||||
| `maturity_stage` (RoadmapItem) | Gate / Reifegrad-Checkpoint auf einem **Pfad** |
|
||||
| **Strang** | `Project` (`project.maturity_journey`) — z. B. Dehnung, Technik, Hüftrotation |
|
||||
| Kriterien / Evidence | Verify vor `reached`; inkl. `metric` |
|
||||
| Graph | Parallele Pfade, `requires`-Kanten, **Join-Gates** zwischen Strängen |
|
||||
| **Horizon (PO-lock)** | **Mehrere** aktive Gates initiative-weit; **pro Strang** höchstens ein aktives Gate auf dem Pfad — siehe [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](SPEC_A1_Progression_Model_PO_Lock_v0.1.md) §3 |
|
||||
|
||||
> **Hinweis:** Lineares Demo-Kit (Stufe 1–3, ein Strang) ist **Teilmenge**, nicht das PO-Kernbild.
|
||||
|
||||
### 4.2 Aktivitäts-Set einer Phase (verbindlich)
|
||||
|
||||
| Aktivitätstyp | Persistenz | Rolle |
|
||||
|---------------|------------|--------|
|
||||
| Übung / Ritual | `RecurringElement`, gebunden an `maturity_stage` | wiederkehrend |
|
||||
| Übung / Ritual | `RecurringElement`, gebunden an **Gate** (`roadmap_item_id`) **und Strang** (`project_id` bei Multi-Strang) | wiederkehrend |
|
||||
| Einmal-/Sonderaktivität | `Action`, gebunden an Stufe | Prüfung, Workshop, Nachweis |
|
||||
|
||||
- Pro Stufe: **beliebig viele** Aktivitäten; **≥1 reicht**.
|
||||
- Pro **Gate**: beliebig viele Übungen; **≥1** pro aktivem Gate auf einem Strang.
|
||||
- Pro Recurring: **eine** offene CadenceInstance (kein Duplikat bei Verpassen).
|
||||
- Inaktive Stufen: kein Next, keine neuen Instanzen; Historie bleibt.
|
||||
- Inaktive / nicht-graph-ready Gates: kein Next, keine neuen Instanzen; Historie bleibt.
|
||||
|
||||
### 4.3 Zeitversatz und Alternanz (gleiche Phase)
|
||||
|
||||
@@ -97,29 +103,30 @@ evidence, decisions, reviews, steering_methods
|
||||
|
||||
Alternanz-Regeln: Rotation nach Erfüllung; Overdue nur auf aktuelles Mitglied; Gruppe an Stufe gebunden.
|
||||
|
||||
### 4.4 Modifikation bei Stage `reached`
|
||||
### 4.4 Modifikation bei Gate `reached`
|
||||
|
||||
1. Altes Activity Set deaktivieren.
|
||||
2. Nächste Stufe aktiv; neues Set aktiv.
|
||||
3. Neues Set darf Übungen/Cadences/Alternanz/Actions ersetzen/erweitern/reduzieren.
|
||||
4. Adaptation innerhalb Stufe (manuell) erlaubt und auditiert.
|
||||
|
||||
Erweitert AP2.0e auf ganze Activity Sets.
|
||||
1. Activity Set **dieses Gates** deaktivieren.
|
||||
2. **Pro Strang:** nächstes Gate auf dem Pfad `active` (Graph-regelkonform); bei **Join-Gates** nach Verify.
|
||||
3. Neues Set **strangspezifisch** — Stränge dürfen divergieren (z. B. Technik ↓, Dehnung ↑).
|
||||
4. Adaptation innerhalb aktiven Gates (manuell) erlaubt und auditiert.
|
||||
|
||||
### 4.5 Datenfelder am Recurring (verbindlich)
|
||||
|
||||
| Feld | Zweck |
|
||||
|------|-------|
|
||||
| Bindung an `maturity_stage` | Stage Activity Set |
|
||||
| `roadmap_item_id` | Gate / Activity Set |
|
||||
| `project_id` | Strang (Pfad); Pflicht bei Multi-Strang |
|
||||
| Cadence | Zeitversatz |
|
||||
| `alternation_group_id` + `alternation_order` | Alternanz (leer = keine Gruppe) |
|
||||
| status aktiv/inaktiv | Set-Wechsel / Adaptation |
|
||||
|
||||
### 4.6 Anti-Patterns
|
||||
|
||||
- Flache Liste „Wiederkehrend“ ohne Gate/Strang-Bezug
|
||||
- Übungen aller Stufen als flache Action-Liste
|
||||
- Verpasste Übung → Duplikat-Task
|
||||
- Alternanz ohne Gruppen-Semantik
|
||||
- Ein uniformes Initiative-Set nach Join (statt strangspezifisch)
|
||||
|
||||
---
|
||||
|
||||
@@ -130,7 +137,7 @@ Erweitert AP2.0e auf ganze Activity Sets.
|
||||
| Aspekt | Kurz |
|
||||
|--------|------|
|
||||
| Dominanz | hybrid |
|
||||
| Horizon | aktive `maturity_stage` |
|
||||
| Horizon | aktive Gates (multi-strang) — PO-Lock §14 |
|
||||
| Leading | CadenceInstance; sekundär Stage-Action |
|
||||
| Next / Ranking | Spec-D D6 |
|
||||
| Attention / Events | Spec-D D7 / D8 |
|
||||
@@ -175,12 +182,12 @@ Cadence im Detail am RecurringElement.
|
||||
|
||||
| Fläche | Inhalt |
|
||||
|--------|--------|
|
||||
| **Plan → Stufen** | Timeline/Liste; aktiv; Kriterien; Verify |
|
||||
| **Plan → Stufe Detail** | Activity Set: Übungen (Cadence, Alternanz), Stage-Actions |
|
||||
| **Plan → Struktur** | Fähigkeits-Projects + Graph |
|
||||
| **Plan → Struktur** | Stränge (Projects) + Gate-Graph (parallel, Join) |
|
||||
| **Plan → Gate-Detail** | Activity Set: Übungen, Strang, Cadence, metric-Kriterien |
|
||||
| **Plan → Stufen** | Graph-/Listen-Ansicht aktiver Gates |
|
||||
| **Plan → Profil** | EFS Fokus/Frequenz/Disziplin |
|
||||
| **Ausführen / Today** | fällige Übungen + Alternanz-aktuell + Stage-Actions |
|
||||
| **Kontrolle** | Stufe, Next + Begründung, Attention, Verify-Fortschritt |
|
||||
| **Ausführen / Today** | fällige Übungen **gruppiert nach Strang/Gate** |
|
||||
| **Kontrolle** | aktive Gates, Join-Status, Kriterien-Fortschritt |
|
||||
| **Journey** | Stufenwechsel, Set-Modifikationen, erfüllte Übungen |
|
||||
| **Process** | Stufen → Stufe/Übungen → Ausführen → Kontrolle |
|
||||
| **Elements** | `next_action_primary`, `maturity_stage`, `recurring_rhythm` |
|
||||
@@ -231,17 +238,16 @@ Cadence im Detail am RecurringElement.
|
||||
**PO-Validation 2026-07-28:** Detaillierte Findings + Architektur-Urteil →
|
||||
`docs/sprints/Sprint1_AP2_1_Validation_Findings_Register_v0.1.md` (F-A1-01…10)
|
||||
|
||||
**PO-Produkturteil A1:** **No-Go** — Leitfrage nicht erfüllt; Tages-Tracking, Messgrößen, Gate-Fortschritt und IA fehlen für echten Einsatz. Architektur/Spec **nicht** falsch; **Minimal-Slice** (CadenceInstance, Work=Übung) vor Re-Abnahme nötig.
|
||||
**PO-Produkturteil A1 (2026-07-28):** **No-Go** — Cadence ohne Progressions-IA. **Option C (PO-Lock):** [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](SPEC_A1_Progression_Model_PO_Lock_v0.1.md) — Multi-Strang vor Re-Abnahme.
|
||||
|
||||
| Bereich | Spec | Code/Truth | Lücke |
|
||||
|---------|------|------------|-------|
|
||||
| Registry / Kit | A1 + Stufen | weitgehend AP2.0e/Kit | Multi-Übung/Alternanz |
|
||||
| Methode | `maturity_progression` | vorhanden | Ranking Alternanz Spec-D |
|
||||
| Stage Activity Set | verbindlich | Teilmenge | Stage-Bindung + UI Detail |
|
||||
| Alternanz-Felder | verbindlich | fehlt/teilweise | Persistenz + Strategy |
|
||||
| EFS Pflicht | focus/frequency | Seeds prüfen | Seed-AP |
|
||||
| steering_elements | D11 | teilweise | FE/BE Parität |
|
||||
| UI Stufe-Detail | Pflicht | lückenhaft | UI-AP |
|
||||
| Progressionsmodell | PO-Lock | linear + flat recurring | Multi-Strang + Gate-Activity-Set |
|
||||
| Horizon multi-active | PO-Lock §3 | single-active (widerrufen) | AP-A1-PM-3 |
|
||||
| Stage Activity Set | Gate + Strang | Teilmenge | Gate-Detail UI + `project_id` |
|
||||
| Registry / Kit | Demo Spagat | geliefert | reicht nicht für PO-Kernbild |
|
||||
| UI Plan Struktur/Gate | Pflicht | fehlt | AP-A1-PM-4 |
|
||||
| Alternanz / metric | verbindlich | fehlt/teilweise | AP-A1-PM-5+ |
|
||||
|
||||
---
|
||||
|
||||
@@ -254,5 +260,25 @@ Fachmodell vollständig. Lücken (Alternanz, Multi-Übung-UI, EFS-Seeds) = Imple
|
||||
## 13. Nachfolger
|
||||
|
||||
- Alternanz-Persistenz + Strategy
|
||||
- UI Stufe-Detail / Activity Set
|
||||
- Template Kumite
|
||||
- UI Plan → Struktur + Gate-Detail / Activity Set
|
||||
- Template Kumite / Mawashi (Multi-Strang)
|
||||
|
||||
---
|
||||
|
||||
## 14. PO-Lock Progressionsmodell (2026-07-28, Option C)
|
||||
|
||||
**Verbindlich** für Horizon, Stränge, Gate-Activity-Sets und MVP-Abgrenzung:
|
||||
|
||||
→ [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](SPEC_A1_Progression_Model_PO_Lock_v0.1.md)
|
||||
|
||||
Kurzfassung:
|
||||
|
||||
| Thema | Lock |
|
||||
|-------|------|
|
||||
| Strang | `Project` — parallele Fähigkeits-Pfade |
|
||||
| Gate | `maturity_stage` im Graph; Join-Gates mit `requires` |
|
||||
| Übung | `RecurringElement` = Übung; Rhythmus = Feld; **nicht** losgelöstes Objekt |
|
||||
| Horizon | **Multi-active** Gates; pro Strang max. 1 aktives Gate auf Pfad |
|
||||
| MVP A1 Go | ≥2 Stränge + Join + Gate-Activity-Set + Today — nicht nur lineares Spagat-Demo |
|
||||
|
||||
Implementierungsfolge: PO-Lock §8 (`AP-A1-PM-1` … `PM-6`).
|
||||
@@ -19,18 +19,18 @@
|
||||
|
||||
## 1. Executive Summary
|
||||
|
||||
| Entscheidung | ☐ Go Stufe A · ☐ Bedingt · ☑ No-Go (bis A1 nachgezogen oder Scope-PO) |
|
||||
| Entscheidung | ☐ Go Stufe A · ☐ Bedingt · ☑ No-Go (A1 bis Progressions-IA; Option C PO-Lock) |
|
||||
|--------------|-------------------------------------|
|
||||
|
||||
**Kurzfazit (3–5 Sätze):**
|
||||
|
||||
Technisch: pytest grün, A1-Happy-Path (Anlage → Verify → Stufenwechsel) durchspielbar.
|
||||
Produkt (PO): **A1 No-Go** — Leitfrage nicht beantwortbar; tagesbezogenes Tracking, Messgrößen und Gate-Fortschritt fehlen; extreme Unübersichtlichkeit; **Hürden > Nutzen**. A2/B2b noch offen.
|
||||
Produkt (PO): **A1 No-Go** — Cadence-Plumbing reicht nicht; Nutzerbild = **parallele Stränge + Gate-Graph + Activity Sets**, nicht flache „Wiederkehrend“-Liste. **PO-Entscheid Option C:** Spec schärfen → [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](../product/archetypes/SPEC_A1_Progression_Model_PO_Lock_v0.1.md). A2/B2b noch offen.
|
||||
|
||||
**Blocker (falls No-Go / Bedingt):**
|
||||
|
||||
- **A1:** CadenceInstance/Tages-„erledigt“, Work=Übung, Gate-Fortschritt, IA — siehe Findings Register §6.1 (F-A1-02…10)
|
||||
- **Gesamt Stufe A:** MVP §4 verlangt A1 — Go erst nach A1 Minimum Slice **oder** PO-Scope-Entscheidung (A1 aus Stufe-A-Abnahfe)
|
||||
- **A1:** Progressions-IA gemäß PO-Lock §6–8 (`AP-A1-PM-2` … `PM-6`) — Multi-Strang, Gate-Activity-Set, Plan-UI, Today gruppiert
|
||||
- **Gesamt Stufe A:** MVP §4 verlangt A1 — Go erst nach PO-Kernbild (≥2 Stränge + Join) durchspielbar
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -206,13 +206,22 @@ Alternanz, volle Metric-Engine, Activity-Set-Automation → **nach** Slice 1–4
|
||||
|
||||
## 7. Konsequenz für AP2.1 / MVP Stufe A
|
||||
|
||||
| Option | Bedeutung |
|
||||
|--------|-----------|
|
||||
| **A — A1 nachziehen** | Validation pausieren; **A1 Minimum Slice** (§6.1) liefern; A1 erneut smoke-testen |
|
||||
| **B — MVP-Definition anpassen** | A1 vorübergehend aus Stufe-A-Abnahfe (PO-Entscheidung + Doku) — **nur wenn A2+B2b als MVP reichen** |
|
||||
| **C — Gesamt No-Go** | AP2.1 stoppt bei Stufe A bis A1 oder Scope-Entscheidung |
|
||||
| Option | Bedeutung | PO 2026-07-28 |
|
||||
|--------|-----------|---------------|
|
||||
| **A — A1 nachziehen** | Minimum Slice liefern | ◐ Cadence done; Progressions-IA offen |
|
||||
| **B — MVP-Definition anpassen** | A1 aus Stufe-A-Abnahfe | nicht gewählt |
|
||||
| **C — Spec schärfen, dann implementieren** | PO-Lock vor Coding | **✓ gewählt** |
|
||||
|
||||
**Empfehlung:** **Option A** — Architektur trägt; Spec war richtig; Implementierung war zu dünn. A2/B2b-Smoke **parallel** möglich, Gesamt-Go aber nicht ohne A1-Lösung (Option A oder explizite B).
|
||||
**PO-Lock (Option C):** [`docs/product/archetypes/SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](../product/archetypes/SPEC_A1_Progression_Model_PO_Lock_v0.1.md)
|
||||
|
||||
Kernentscheide:
|
||||
|
||||
- **Multi-Strang** (Projects) + **Gate-Graph** + **Join-Gates**
|
||||
- **Horizon:** mehrere aktive Gates (nicht eine Stufe initiative-weit)
|
||||
- **Übung** = `RecurringElement` am Gate + Strang; Rhythmus = Feld
|
||||
- **A1 Go MVP:** ≥2 Stränge + 1 Join + Gate-Activity-Set + Today — nicht nur Spagat-Demo
|
||||
|
||||
**Validation A1:** pausiert bis `AP-A1-PM-4` (Plan Struktur + Gate-Detail). A2/B2b-Smoke **parallel** möglich.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# AP A1 — Minimum Usability Slice
|
||||
## Auftrag v0.1
|
||||
|
||||
**Status:** freigegeben (PO folgt Option A, 2026-07-28) · **Implementierung A1.1–A1.3 abgeschlossen** (Re-Abnahme ausstehend)
|
||||
**Status:** freigegeben (PO folgt Option A, 2026-07-28) · **superseded by Option C PO-Lock** — siehe [`SPEC_A1_Progression_Model_PO_Lock_v0.1.md`](../archetypes/SPEC_A1_Progression_Model_PO_Lock_v0.1.md)
|
||||
**Auslöser:** AP2.1 PO No-Go A1 — [`Sprint1_AP2_1_Validation_Findings_Register_v0.1.md`](Sprint1_AP2_1_Validation_Findings_Register_v0.1.md) §6.1
|
||||
**Ziel:** A1 **real nutzbar** für Tages-Tracking + Gate-Einschätzung + klare Today-Ansicht — **ohne** Architektur-Neudesign.
|
||||
|
||||
|
||||
Reference in new issue
Block a user