docs: Plan-Modus-Design und ADP AP1.10 (Archetypen, Entity Field System).

Festlegung Vorhaben als Wurzel, Plan-Outline, Modal/DnD, Gate-Graph und Roadmap AP1.9b–AP1.13.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
LarsandCursor committed 2026-07-09 11:13:54 +02:00
1 parent 09feddae4a
commit afb07f70b9
4 files changed
+514 -19

No files matched your search

@@ -69,7 +69,25 @@ Siehe `ADP_Recursive_Containers_and_Execution_Granularity_v0.1.md`.
Siehe `Kairo_PM_Frontend_UI_Concept_v0.1.md`, `ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md`.
**Reihenfolge Code:** AP1.9a (Shell) → 9b–9e (Modus-Inhalte); AP1.5d parallel nach 9b wo sinnvoll.
**Reihenfolge Code:** AP1.9a (Shell) ✓ → 9b–9e; AP1.10 + AP1.12 (Planen); AP1.5d parallel nach 9b.
---
## 1.4 PO-Entscheidung 2026-07-09 — Planen ausbauen & Vorhaben als Wurzel
**Auslöser:** Planen braucht Outline, Modal-Edit, Archetypen/Felder, Gate-Graph; Breadcrumb noch nicht modus-sensitiv.
| Entscheidung | |
|--------------|--|
| **Vorhaben = Wurzel** für alle Plan-Objekte | vorgeschlagen |
| Standardfelder (indexiert) + **Entity Field System** zentral | vorgeschlagen |
| Plan-**Outline** statt loser Untertabs | vorgeschlagen |
| Gate-**Graph-Editor** (Mitai-Pattern, Kairo-Semantik) | vorgeschlagen |
| Modal-Edit + DnD (Desktop) / ↑↓ (Mobile) | vorgeschlagen |
Siehe `Kairo_Plan_Mode_Design_v0.1.md`, `ADP_AP1_10_Initiative_Archetypes_and_Entity_Field_System_v0.1.md`.
**Reihenfolge Code:** AP1.9b → AP1.12 → AP1.10 → AP1.5d → AP1.13.
---
@@ -86,9 +104,10 @@ Phase F Gate-Backend AP1.4 + AP1.4b ✓ (Backend); UI minimal
Phase G Ist-Hierarchie AP1.5 ✓
Phase G2 Rekursive Container AP1.5c–5d ✓ 5c / → 5d nach AP1.6
Phase H Plan/Ist-Verknüpfung AP1.6 ✓
Phase H2 PM Work Modes IA AP1.9 ← **NÄCHSTES CODE** (PO 2026-07-08)
Phase H3 Rekursive Tasks AP1.5d nach AP1.9b
Phase I Gate-Graph AP1.4d–4e nach AP1.9d
Phase H2 PM Work Modes IA AP1.9 ✓ 9a / → 9b–9e
Phase H3 Plan Outline & Archetypes AP1.10–12 ← **NÄCHSTES DESIGN+CODE** (PO 2026-07-09)
Phase H4 Rekursive Tasks AP1.5d nach AP1.12d
Phase I Gate-Graph AP1.4d + AP1.13 nach AP1.12
Phase J Portfolio & Kontext AP1.8 geplant
Phase K Agent Interface AP1.7 geplant (unverändert)
Phase L Validation AP0.10d (laufend PO) parallel
@@ -112,7 +131,9 @@ Phase L Validation AP0.10d (laufend PO) parallel
| AP1.4b | 0.13.1-ap1.4b | Gate-Checkliste Backend + Detail-Route |
| AP1.5c | 0.14.1-ap1.5c | Rekursive Projects |
| AP1.6 | 0.15.0-ap1.6 | Plan/Ist, Journey, Gate-Beiträge |
| AP1.5e | 0.15.1-ap1.5e | Projekt-Detail, Lifecycle-Chip (Übergang — ersetzt durch AP1.9) |
| AP1.5e | 0.15.1-ap1.5e | Projekt-Detail (Übergang) |
| AP1.9a | 0.16.x-ap1.9a | PM Work Modes Shell, Scope, Redirects |
| DOC Plan | 2026-07-09 | Plan Mode Design v0.1, ADP AP1.10 |
| DOC PM UI | 2026-07-08 | PM Frontend UI Concept v0.1, ADP AP1.9 |
| DOC PO | 2026-07-06 | ADP Product Layering & IA-Reset |
| DOC Container | 2026-07-06 | ADP Recursive Containers & Execution Granularity |
@@ -176,23 +197,48 @@ Backlog/Action/Project/Task → RoadmapItem; Decision-Spur; Journey-Timeline.
---
### AP1.9 — PM Work Modes & Frontend IA Reset ← **NÄCHSTES CODE**
### AP1.9 — PM Work Modes & Frontend IA Reset ✓ (9a) / → 9b–9e
**Ziel:** App-weite Arbeitsmodi statt Vorhaben-Tab-Omnibus; Querschnitt für PM-Use-Cases.
**Ziel:** App-weite Arbeitsmodi statt Vorhaben-Tab-Omnibus.
| Teil | Scope | Status |
|------|--------|--------|
| **9a** | Shell, Routen, Scope, Redirects, Objekt-Routen | ✓ |
| **9b** | Scope-Breadcrumb modus-sensitiv | offen |
| **9c** | Cockpit + Ausführen polish | offen |
| **9d** | Kontrolle | offen |
| **9e** | Plan-Tabs vorläufig (→ AP1.12) | teilweise |
| **9f** | Team | offen |
**ADP:** `ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md`
---
### AP1.10 — Initiative-Archetypen & Entity Field System ← **NÄCHSTES (mit 9b/12)**
| Teil | Scope |
|------|--------|
| **9a** | App-Shell, Routen `/cockpit`, `/work`, `/plan`, `/control`, `/team`, Scope-Provider, Redirects |
| **9b** | Cockpit + Ausführen/Heute (AP-Querschnitt) |
| **9c** | Kontrolle: Snapshot, Journey, Plan-Ist-Aggregate |
| **9d** | Planen: Struktur, Gates, Inbox (Migration von Initiative-Tabs) |
| **9e** | Team: Workload, Zuweisungsübersicht |
| **10a** | Standardfelder + `archetype_key` |
| **10b** | EFS Registry + Seeds |
| **10c** | Field API + Modal FieldRenderer |
**ADP:** `ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md`
**UI Concept:** `Kairo_PM_Frontend_UI_Concept_v0.1.md`
**Version-Ziel:** `0.16.0-ap1.9a` (Shell), dann inkrementell
**ADP:** `ADP_AP1_10_Initiative_Archetypes_and_Entity_Field_System_v0.1.md`
**Explizit nicht:** Weitere Features unter `InitiativeExecutionPage` / `InitiativeSubNav`.
---
### AP1.12 — Plan-Modus Outline & Interaktion
| Teil | Scope |
|------|--------|
| **12a–d** | Outline, Modal, Reorder, Arbeit-Knoten |
**Design:** `Kairo_Plan_Mode_Design_v0.1.md`
---
### AP1.13 — Gate Map Editor
Graph-UI für Gate-Dependencies (Mitai-Pattern). **Nach AP1.4d + AP1.12.**
---
@@ -209,7 +255,7 @@ Backlog/Action/Project/Task → RoadmapItem; Decision-Spur; Journey-Timeline.
| **Kein** nested Action (Default) |
**ADP:** `ADP_Recursive_Containers_and_Execution_Granularity_v0.1.md`
**Nach AP1.9b** (Tasks füllen `/work`, IA bleibt)
**Nach AP1.12d** (Tasks im Plan-Baum + `/work`)
**Version:** `0.16.x-ap1.5d`
---
@@ -115,9 +115,11 @@ Planen ist **scope-pflichtig auf mindestens ein Vorhaben** (Struktur hängt an I
**Nicht hier:** Tagesausführung, Blocker-Status aller APs, Team-Workload.
**Route:** `/plan` (+ `/plan/structure`, `/plan/gates`, `/plan/inbox`)
**Route:** `/plan` (+ Outline-Knoten; Legacy `/plan/structure`, `/plan/gates`, `/plan/inbox`)
**Migration:** Heutige Tabs `plan`, `inbox` und Projektbaum aus `execution` **wandern hierher**.
**Design (2026-07-09):** `Kairo_Plan_Mode_Design_v0.1.md` — Outline, Modal, DnD, Gate-Graph.
**Migration:** Heutige Plan-Untertabs → AP1.12 Outline.
---
+235
View File
@@ -0,0 +1,235 @@
# Kairo — Plan-Modus Design v0.1
**Status:** PO-Arbeitsentwurf (Entscheidung ausstehend)
**Stand:** 2026-07-09
**Bezug:** `Kairo_PM_Frontend_UI_Concept_v0.1.md` §4.3, `ADP_AP1_10_Initiative_Archetypes_and_Entity_Field_System_v0.1.md`
**Auslöser:** Planen soll von Tab-Fragmenten zu durchgängiger Programmgestaltung werden — bis Struktur, Gates, Eingang, Arbeitspakete und Tasks
---
## 1. Leitfrage
**Wie soll das Programm aufgebaut sein — von der Vorhabens-Identität bis zur ausführbaren Granularität?**
Planen beantwortet **Struktur- und Zielfragen**. Es committet **keine Tagesausführung** (das ist Ausführen) und **kein Lagebild** (das ist Kontrolle).
---
## 2. Grundsatz: Vorhaben als Wurzel
```text
/plan?initiative={id}&project={optional}
Initiative (Wurzel — immer im Scope)
├── Profil — Archetyp, Standard- + dynamische Felder
├── Struktur — Project-Baum (rekursiv)
├── Zielzustände — Gates / RoadmapItems (Liste + Graph)
├── Eingang — Backlog (triage → convert)
└── Arbeit — Actions (+ Tasks ab AP1.5d) im Plan-Kontext
```
**Flache Vorhaben:** Actions ohne `project_id` erscheinen als direkte Kinder der Initiative im Plan-Baum.
**Commit-Grenze Plan → Ist:**
| Objekt | In Plan | Commit-Aktion |
|--------|---------|---------------|
| BacklogItem | Ja | Convert → Action |
| Project / Gate | Ja | sofort „Struktur“ (kein separater Commit) |
| Action | Sichtbar | Anlage = committet |
| Task | Sichtbar (AP1.5d) | Anlage unter Action |
---
## 3. IA: Von Tabs zur Plan-Outline
### 3.1 Heute (AP1.9a)
```text
/plan/structure | /plan/gates | /plan/inbox — drei lose Untertabs
```
### 3.2 Ziel (AP1.12)
**Eine Planungsseite** mit linker **Outline** (Baum) und rechtem **Kontextbereich** (Desktop) bzw. **Drill-down** (Mobile).
```text
┌──────────────────────────────────────────────────────────────┐
│ Modus: Planen Scope: Portfolio › Vorhaben X › [Projekt Y] │
├──────────────────┬───────────────────────────────────────────┤
│ OUTLINE │ KONTEXT │
│ ▼ Vorhaben X │ [Profil-Karte / Mini-Snapshot] │
│ ▼ Struktur │ oder │
│ Phase 1 │ [Liste der Kinder des gewählten Knotens] │
│ Phase 2 │ oder │
│ Zielzustände │ [Graph-Ansicht Gates] │
│ Eingang (3) │ │
│ Arbeit (12) │ │
└──────────────────┴───────────────────────────────────────────┘
```
**Routen (evolutionär):**
| Route | Bedeutung |
|-------|-----------|
| `/plan` | Portfolio: „Vorhaben ohne Struktur“, „Gates ohne Kriterien“ (Einstieg) |
| `/plan?initiative=` | Outline für ein Vorhaben |
| `/plan?initiative=&node=structure\|gates\|inbox\|work` | Outline-Fokus (Query, kein Pflicht-Split) |
| `/gates/:id`, `/projects/:id` | Objekt-Modal / Deep Link (bestehend AP1.9) |
Untertabs `/plan/structure` etc. bleiben als **Deep-Link-Aliase** mit Redirect auf `/plan?initiative=&node=…` bis Entfernung in AP1.12.
---
## 4. Interaktion
### 4.1 Bearbeiten — Modal (verbindlich)
| Objekt | Trigger | Modal-Inhalt |
|--------|---------|----------------|
| Initiative | Outline „Profil“ / Stift-Icon | Standardfelder + EFS (AP1.10) |
| Project | Klick / Stift | Titel, Status, container_kind, Gate-Link, Parent |
| Gate | Klick / Stift | RoadmapItem + Kriterien (bestehend, polish) |
| Backlog | Klick | Triage-Felder, Gate-Link, Convert-Button |
| Action | Klick | ActionForm (bestehend) — oder Link zu `/actions/:id` |
| Task | Klick (AP1.5d) | TaskForm |
**Regel (UI Concept P4):** Kein dauerhaftes Inline-Formular in der Outline.
### 4.2 Reihenfolge
| Plattform | Mechanismus | Gilt für |
|-----------|-------------|----------|
| Desktop (≥1024px) | Drag & Drop innerhalb gleicher Elternebene | Projects, Backlog (sort_order), Gates (optional Phase 2) |
| Mobile / Touch | ↑ / ↓ Buttons pro Zeile | gleich |
**API:** `PATCH` mit `sort_order` oder dediziertes `POST …/reorder` — idempotent, tenant-scoped.
### 4.3 Anlegen
„+“ am **elterlichen Knoten** in der Outline (nicht globaler FAB ohne Kontext).
---
## 5. Zielzustände — Graph-Editor
### 5.1 Zwei Ansichten
| Ansicht | Wann | UI |
|---------|------|-----|
| **Liste** | Flache Vorhaben, wenige Gates | `RoadmapPlanSection` (evolviert) |
| **Graph** | Komplexe Abhängigkeiten, Parallel-Gates | **GateMapEditor** (neu) |
Umschalter: „Liste | Graph“ im Knoten Zielzustände — Default **Liste** wenn ≤5 Gates, sonst letzter User-Choice (localStorage pro Initiative).
### 5.2 Graph-Editor (AP1.13) — Mitai-Pattern, Kairo-Semantik
**Referenz (Pattern only):** Mitai `WorkflowEditorPage` — Canvas, Zoom, Pan, Snap-to-grid.
**Kairo-Scope (kein Workflow):**
| Element | Semantik |
|---------|----------|
| Knoten | RoadmapItem (Gate, Meilenstein, Reifegrad) |
| Kanten | `roadmap_item_dependencies` (sequential / parallel / optional) |
| Kein | Lifecycle-Workflow, keine Prompt-Knoten, keine Mitai-Domäne |
**Phase 1:** Gates + Kanten CRUD im Graph
**Phase 2:** Project→Gate-Bezug als Badge am Knoten oder Filter-Layer
**Verify / Kriterien:** Weiterhin Detail-Modal / `/gates/:id` — nicht im Graph inline CRUD-Wand
### 5.3 Backend
Baut auf AP1.4d (Graph Engine read models) auf — UI AP1.13 **nach** 4d oder parallel wenn read APIs vorhanden.
---
## 6. Ebenen bis Workpackage & Task
| Ebene | Typ | Plan-Outline-Knoten | Tiefe |
|-------|-----|---------------------|-------|
| 0 | Initiative | Wurzel | 1 |
| 1 | Project | rekursiv | max. 5 (bestehend) |
| 2 | RoadmapItem | Zielzustände (Graph/Liste) | parallel zur Struktur |
| 3 | BacklogItem | Eingang | flach unter Initiative |
| 4 | Action | Arbeit | unter Project **oder** Initiative |
| 5 | Task | (AP1.5d) | unter Action, UI max. ~3 |
**Plan-Baum „Arbeit“:** Zeigt committete Actions + Tasks (read-heavy); Anlage öffnet Modal. Filter: optional nur „ohne Project“ / „unter gewähltem Project“ (Scope `?project=`).
---
## 7. Scope-Breadcrumb (AP1.9b — Zuverlässigkeit)
**Problem:** Klick auf Vorhaben im Breadcrumb führt immer nach `/control/status` — in Planen falsch.
**Regel:** Mittlerer Breadcrumb-Klick ist **modus-sensitiv**:
| Aktiver Modus | Klick „Vorhaben X“ |
|---------------|-------------------|
| `/plan/*` | `/plan?initiative=X` |
| `/control/*` | `/control/status?initiative=X` |
| `/work/*` | `/work/today?initiative=X` |
| Objekt-Route | passender Modus aus Objekttyp (`/projects/` → Plan, `/actions/` → Work) |
Portfolio-Klick: Scope leeren, Modus beibehalten.
**Technik:** `ProgramScopeBar` liest `useLocation` + Modus-Registry; kein hardcoded `/control/status`.
---
## 8. Implementierungspakete
```text
AP1.9b Scope-Breadcrumb modus-sensitiv; Scope-Sync bei Deep Links härten
AP1.12a Plan-Outline Shell (Desktop Split / Mobile Drill-down)
AP1.12b Modal-Edit für Project, Backlog, Initiative-Profil (Standardfelder)
AP1.12c Reorder: sort_order API + DnD (Desktop) + ↑↓ (Mobile)
AP1.12d Outline-Knoten „Arbeit“ (Actions listen, Link zu Detail)
AP1.13a GateMapEditor read-only (Layout aus Dependencies)
AP1.13b GateMapEditor edit (Knoten/Kanten CRUD)
AP1.5d Tasks in Outline-Knoten „Arbeit“
AP1.10 Archetyp + EFS für Initiative-Profil-Modal (parallel ab 10a)
```
**Empfohlene Reihenfolge:**
```text
9b → 12a → 12b → 10a/10c (Profil) → 12c → 12d → 5d → 13a → 13b
```
---
## 9. Nicht-Ziele (Scope Lock)
- Kein Sprint-/Capacity-Planning in Planen (später Team-Modus-Erweiterung)
- Kein Inline-CRUD aller Gates in der Outline-Liste
- Kein Mitai-Workflow-Clone
- Kein Steering pro Project-Ebene (ADP Recursive Containers)
---
## 10. Erfolgskriterien (PO)
1. PO kann ein Vorhaben wählen und **in einer Ansicht** Struktur, Gates, Eingang und Arbeit sehen.
2. Bearbeitung läuft **nur im Modal** — Outline bleibt übersichtlich.
3. Project-Reihenfolge per DnD (Desktop) änderbar.
4. Gates mit Abhängigkeiten im **Graph** darstellbar (AP1.13).
5. Breadcrumb-Klick auf Vorhaben bleibt im Modus Planen.
---
## 11. PO-Freigabe
- [ ] Outline statt drei Tabs (AP1.12) angenommen
- [ ] Modal-Edit + DnD/↑↓ OK
- [ ] GateMapEditor (Mitai-Pattern) Scope OK
- [ ] AP1.9b Breadcrumb-Regel OK
---
## Referenzen
- `docs/architecture/ADP_AP1_10_Initiative_Archetypes_and_Entity_Field_System_v0.1.md`
- `docs/architecture/ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md`
- `docs/reference/design-principles/mitai/PROMPT_ENGINE_DESIGN_PRINCIPLES.md` (WorkflowEditor-Referenz)