docs: Backlog-Hierarchie, Dual Commit Path und Epic-Zielbild

ADP v0.1 plus Updates in B2b-Spec, agile_iteration, Katalog und Truth Table.
This commit is contained in:
Lars committed 2026-07-26 18:25:12 +02:00
1 parent 1c10e5b798
commit f7d65dde01
11 files changed
+327 -15

No files matched your search

@@ -41,6 +41,7 @@ Kairo_Implementation_Truth_Table_v0.1.md ← Was ist wirklich da?
|---------|----------|--------|
| Katalog | ADP v0.2 §3–§5 | Inventar, Nutzerbild, Scope Lock |
| Plugin | ADP AP2.3 / AP2.4 | Archetyp ↔ Methode, Element-Registry, Operating Context |
| Backlog / Epic | `docs/architecture/ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md` | Dual Commit, Epic-Baum, Agile-Vollmodell, Agent-Steuerung |
| UI-Navigation | `docs/product/archetypes/ARCHETYPE_UI_NAVIGATION_v0.1.md` | Nav, Outline, Default-Routen, Slice-Gating — Spec-§6 |
| Spec | `docs/product/archetypes/` | Implementierbare Detail-Spec |
| Auftrag | Sprint Assignments | Scope + DoD für ein AP |
@@ -48,6 +48,10 @@ Verhindert, dass Zielbild-Dokumente als Ist-Stand gelesen werden.
| `action_kind` (planning/delivery) | ◐ | Migration 023, API AP1.16a |
| `actions.sort_order` | ◐ | Migration 023 |
| BacklogItem | ✓ | Gate-Zuordnung AP1.6, `sort_order` |
| BacklogItem kinds (MVP) | ◐ | `story`/`bug`/`issue` AP2.2e — global, nicht profilgebunden |
| Backlog Epic-Hierarchie | ✗ | ADP P2: `epic` + `parent_backlog_id` — dokumentiert 2026-07-26 |
| Dual Commit (Direct AP) | ◐ | ADP P1: Plan→Arbeit im Product-Outline (2026-07-26) |
| Profil-Vokabular Backlog | ✗ | ADP P3: Continuous vs. Agile labels via Operating Context |
| Blocker | ✓ | `action_id` optional |
| Milestone | ◐ | Legacy-Tabelle MVP-Brücke; RoadmapItem bevorzugt |
| Evidence | ✓ | `roadmap_item_id`, `action_id`; Gitea-Links in `description` (manuell) |
@@ -224,6 +228,7 @@ Details: `Kairo_Status_Review_and_Next_Steps_v0.1.md` §2.1
|----|-----------|
| AP2.3/4 | ✓ Plugin-Architektur + Element-Registry (2026-07-25) |
| AP2.2a | Starter-Kits ◐→✓ |
| ADP Backlog/Epic | P1 Direct AP · P2 Epic-Baum · P3 Profil-Vokabular · P4 Roll-up (2026-07-26 Doku) |
| AP2.2b–e | Referenz-Archetypen End-to-End ◐→✓ |
| AP2.1 | MVP-Abnahfe ✗→✓ |
| AP1.7b | Op-API Parität |
@@ -120,7 +120,20 @@ In **§6 UI / IA** jeder Archetyp-Spec:
---
## 7. Abnahme-Checkliste (Archetyp-Slice)
## 9. Dual Commit Path (Plan vs. Ist)
Verbindlich: [`ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md`](../../architecture/ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md)
| Pfad | Route (typisch) | Archetyp-Spec |
|------|-----------------|---------------|
| **A — Intake → Commit** | `/plan/inbox` → convert | Eingang Pflicht oder empfohlen |
| **B — Direct AP** | `/plan/work` → create action | Continuous-Pflicht; Agile optional |
Specs müssen beide Pfade in §4 Ist-Objekte und §8 UI benennen. Agile Epic-Hierarchie nur wenn `agile_iteration` / Profil — nicht global hardcodieren.
---
## 10. Abnahme-Checkliste (Archetyp-Slice)
- [ ] Operating Context liefert `ui_profile` mit Spec-konformen Keys und Routen
- [ ] `data_slices` enthält alle für den Archetyp deklarierten Slices, die die Methode unterstützt
@@ -140,4 +153,5 @@ In **§6 UI / IA** jeder Archetyp-Spec:
| FE Resolver | `frontend/src/registry/resolveOperatingProfile.js` |
| Route Gating | `frontend/src/registry/OperatingRouteGate.jsx`, `modeRouteRegistry.js` |
| Plugin-ADP | `docs/architecture/ADP_Archetype_Method_Plugin_Architecture_v0.1.md` |
| **Dual Commit / Epic / Agile** | `docs/architecture/ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md` |
| Spec-Template §6 | `docs/product/archetypes/_TEMPLATE_Archetype_Spec_v0.1.md` |
+2 -1
View File
@@ -4,7 +4,8 @@
**Decision-Lock:** [`../Kairo_Archetype_Decision_Lock_Interview_2026-07-25.md`](../Kairo_Archetype_Decision_Lock_Interview_2026-07-25.md)
**Methodenkern:** [`../../architecture/Kairo_Steering_Method_Kernel_v0.1.md`](../../architecture/Kairo_Steering_Method_Kernel_v0.1.md)
**Methoden Spec-D:** [`../../architecture/methods/README.md`](../../architecture/methods/README.md)
**UI-Navigation (Archetyp):** [`ARCHETYPE_UI_NAVIGATION_v0.1.md`](ARCHETYPE_UI_NAVIGATION_v0.1.md)
**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.
@@ -84,12 +84,31 @@ evidence, decisions, reviews, work_cycles, steering_methods
| Objekt | Rolle | Commit-Regel |
|--------|-------|--------------|
| Action | Leading nach Commit | aus Backlog oder direkt; Assignment |
| Task | unter Action | nicht Leading |
| Action | Leading nach Commit | **Pfad A:** aus Backlog convert · **Pfad B:** direkt anlegen (ad-hoc, Erkenntnis, Agent-Auftrag) |
| Task | unter Action | nicht Leading; Agent-Granularität (ADP Recursive Tasks) |
| Sprint-Backlog | Actions mit `work_cycle_id` | **nicht** BacklogItem-Liste |
| Evidence / Blocker / Decision | Normalbetrieb | Incident/Bug = Normalzustand |
| Review | optional (Sprint/Product-Lage) | |
**Dual Commit Path** (verbindlich): [`ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md`](../../architecture/ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md) §3.1.
| Pfad | Nutzerbild |
|------|------------|
| **A — Intake → Commit** | Eingang triagieren → „In Arbeitspaket umwandeln“ (optional in Sprint) |
| **B — Direct Commit** | Plan → Arbeit: AP direkt — z. B. Erkenntnis aus laufender Entwicklung, kein Bug, kein Backlog-Umweg |
Pfad B ist für **Continuous/Programmentwicklung** gleichwertig, nicht Ausnahme.
### 4.2b Eingang & Epic (Agile optional)
| Objekt | Continuous (Default) | Mit `agile_iteration` |
|--------|---------------------|------------------------|
| BacklogItem-Typen (Ziel) | Idee, Bug, Störung | Epic, Story, Bug, Issue (Jira-nah) |
| Hierarchie | flach oder Gate-Link | Epic → Story/Bug/Issue via `parent_backlog_id` |
| Epic | **nicht** als Gate/Meilenstein | Liefercontainer im Eingang; Fortschritt = Roll-up aus Commits |
**MVP-Ist:** nur `story`/`bug`/`issue` (AP2.2e); Epic + Direct-AP-UI = dokumentiert, Implementierung P1–P3 (ADP §7).
### 4.3 Continuous vs. Sprint
| Situation | Verhalten |
@@ -110,6 +129,8 @@ Kein Closure-Zwang. Archiv nur Ausnahmefall. Gates sind Orientierung, nicht „P
- Leerer Sprint-Screen ohne aktiven Sprint
- Closure erzwingen
- Product-Backlog als separates B1-Vorhaben erzwingen
- **Epic als RoadmapItem/Meilenstein** — Lieferumfang ≠ Gate-Horizont
- **Jeden AP nur über Backlog** — Direct Commit (Pfad B) für Continuous unterbinden
---
@@ -165,8 +186,9 @@ Kein Closure-Zwang. Archiv nur Ausnahmefall. Gates sind Orientierung, nicht „P
| Fläche | Inhalt |
|--------|--------|
| **Plan → Profil** | Vision, Notizen, EFS |
| **Plan → Eingang / Inbox** | Backlog triage, Commit → Action (`/plan/inbox`) |
| **Plan → Gates** | optionale Orientierungs-Meilensteine |
| **Plan → Eingang / Inbox** | Backlog triage, Commit → Action (Pfad A); optional Epic-Baum bei Agile |
| **Plan → Arbeit** | **Direct AP** (Pfad B) — committete Arbeitspakete am Vorhaben |
| **Plan → Gates** | optionale Orientierungs-Meilensteine (≠ Epic) |
| **Plan → Struktur** | Projects Entwicklung/Betrieb |
| **Plan → Sprint** | anlegen, planen, aktiv, abschließen/Carryover (wenn Agile) |
| **Ausführen / Today** | Continuous Next ohne Sprint |
@@ -175,19 +197,23 @@ Kein Closure-Zwang. Archiv nur Ausnahmefall. Gates sind Orientierung, nicht „P
| **Kontrolle** | Next + reason_code; Attention; Sprint-Banner wenn aktiv |
| **Journey** | Commits, Sprint-Events, Incidents, Gate-Verify |
| **Process** | Eingang → (optional Sprint) → Ausführen → Kontrolle |
| **Outline** | profile, inbox, sprint, gates |
| **Product Language** | Sprint, Arbeitspaket, Eingang = Product Backlog |
| **Outline (Ziel)** | profile, inbox, work, sprint, gates |
| **Outline (MVP)** | profile, inbox, work, sprint, gates |
| **Product Language** | Sprint, Arbeitspaket, Eingang; Continuous: Idee/Bug/Störung |
| **Agile Language** | Epic, Story, Bug, Issue (nur wenn Modifier aktiv / Profil) |
| **Nicht** | Closure-Wizard als Kern; Checklisten-Queue als Product-Backlog; leere Sprint-Sackgasse |
Agent-Steuerung: Actors führen Tasks unter AP aus; Leading Next aus Steering Kernel — siehe ADP Dual Commit §3.5.
---
## 9. Happy Path (Abnahme-Flow)
1. Product anlegen → Kit (Gate, Projects, Beispiel-BacklogItem).
2. Item committen → Action.
2. **Pfad A:** Item committen → Action **oder Pfad B:** AP direkt unter Plan → Arbeit.
3. Kontrolle: Next begründet **ohne** Sprint.
4. Kritischen Bug erfassen → Attention/Ranking Incident.
5. Optional: Sprint anlegen → planen → Work zeigt Sprint → complete/Carryover.
5. Optional (Agile): Epic anlegen → Stories → Sprint planen → Work zeigt Sprint → complete/Carryover.
6. Ohne Sprint navigieren → Continuous, kein leerer Sprint-Zwang.
7. Kein Closure nötig für „Erfolg“.
@@ -206,10 +232,12 @@ Kein Closure-Zwang. Archiv nur Ausnahmefall. Gates sind Orientierung, nicht „P
| # | Kriterium | Erfüllt wenn |
|---|-----------|--------------|
| 1 | Anlegen | Kit + `continuous_product` |
| 2 | Commit | Eingang → Action |
| 2 | Commit A | Eingang → Action |
| 2b | Commit B | Direct AP unter Plan → Arbeit |
| 3 | Next ohne Sprint | begründet, Horizon ok |
| 4 | Incident | kritische Issue beeinflusst Attention/Ranking |
| 5 | Optional Agile | Sprint-Flow durchspielbar |
| 5b | Optional Agile | Epic → Stories → Commit; Epic-Fortschritt sichtbar |
| 6 | Anti Sprint-Leere | kein leerer Sprint-Screen ohne Sprint |
| 7 | Leitfrage | ≤2 Min |
| 8 | Closure | kein Zwang |
@@ -224,7 +252,9 @@ Kein Closure-Zwang. Archiv nur Ausnahmefall. Gates sind Orientierung, nicht „P
|---------|------|------------|-------|
| Registry / Kit | B2b | AP2.2a/d/e/f vorhanden | EFS-Seeds |
| Methode | `continuous_product` | registriert | Strategie an Spec-D halten |
| Agile | composes_with product | vorhanden | nicht Programm-Meta |
| Agile | composes_with product | vorhanden | Epic-Hierarchie, Profil-Vokabular (ADP P2–P3) |
| Dual Commit | Pfad A + B | Pfad A + B UI Plan→Arbeit | — |
| Backlog-Typen | Continuous + Agile getrennt | global story/bug/issue | Profil-gebundene kinds |
| UI Continuous/Sprint | diese Spec | weitgehend | Feinschliff leerer Sprint |
| Op-API / Vibe-Coder | Parität | später | AP1.7b |
| EFS | product_vision etc. | lückenhaft | Seed-AP |
@@ -239,6 +269,8 @@ Fachmodell vollständig. Feinschliff und Seeds in APs — Spec nicht kürzen.
## 13. Nachfolger
- ADP Backlog-Hierarchie & Dual Commit — [`ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md`](../../architecture/ADP_Backlog_Hierarchy_and_Dual_Commit_Path_v0.1.md)
- EFS-Seeds
- Strategy-Parität Spec-D D6/D7
- Vibe-Coder Op-API Parität
- AP P1: Plan→Arbeit Product · P2: Epic/`parent_backlog_id` · P3: Profil-Vokabular
@@ -55,8 +55,8 @@
| Objekt | Rolle | Commit-Regel |
|--------|-------|--------------|
| BacklogItem | | |
| Action | | |
| BacklogItem | Eingang | triage; convert → Action (Pfad A) |
| Action | Arbeitspaket | Pfad A: aus Backlog · Pfad B: direkt — ADP Dual Commit |
| Task | | |
| RecurringElement | | |
| Evidence / Decision / Review | | |