AP1.9a: Arbeitsmodi-Shell mit Scope, Objekt-Routen und Legacy-Redirects.
Deploy Development / deploy (push) Successful in 47s
Test Suite / pytest-backend (push) Failing after 1m46s
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 2s
Test Suite / compose-smoke (push) Has been skipped

Ersetzt die Vorhaben-Tab-Navigation durch Cockpit/Ausführen/Planen/Kontrolle/Team, Deep Links für APs/Projekte/Gates und Programm-Scope im Header.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
LarsandCursor committed 2026-07-08 12:55:37 +02:00
1 parent 33831a8c2c
commit e42edd86fa
54 files changed
+2489 -150

No files matched your search

@@ -0,0 +1,146 @@
# ADP — AP1.9 PM Work Modes & Frontend IA Reset v0.1
**Status:** vorgeschlagen (PO-Freigabe ausstehend)
**Stand:** 2026-07-08
**Autor:** Product/Architektur (Cursor-Session, PM-Feedback)
**UI-Konzept:** `docs/product/Kairo_PM_Frontend_UI_Concept_v0.1.md`
**Auslöser:** Frontend strukturiert nach Objekten (Vorhaben-Tabs), nicht nach Programmmanager-Arbeitslogik
---
## Problem
Nach AP1.2c–AP1.6 existiert ein IA-Skeleton (Workspace, Initiative-Übersicht, Unterseiten), aber:
1. **Alle Arbeitsflächen hängen unter `/initiatives/:id/...`** — Querschnitt (alle Tasks, alle Blocker, Next Step portfolio-weit) fehlt als eigene Fläche.
2. Tab **Ausführung** vermischt Struktur (Projects), Ist (Actions), Blocker — widerspricht Plan/Ist-Trennung und PM-Use-Cases.
3. **Workspace** ist Widget-Sammlung ohne klaren Modus „Cockpit“.
4. Weitere UI-Patches auf Unterseiten **verstärken** das Anti-Pattern (Vision §7, Canonical OM §8.1).
Ohne Entscheidung wird jede weitere Feature-Arbeit (Tasks, KI, Portfolio-Prio) erneut „irgendwo unter Vorhaben“ landen.
---
## Betroffene Regeln
| Dokument | Regel |
|----------|--------|
| Vision v0.2 §7 | Drei Ebenen: Workspace → Initiative-Übersicht → Unterseiten |
| Vision v0.2 §7.1–7.2 | Workspace = Querschnitt; Initiative-Übersicht = Steuerung im Alltag |
| Canonical OM §8.1–8.4 | Übersicht entscheidet; getrennte Hauptflächen Plan / Ausführung / Eingang / Journey |
| ADP PO Product Layering | Gates ≠ operativer Plan; Ausführung = Ist-Kern |
| Principle Gate / Sprint0 | Kein weiteres InitiativeDetail-Omnibus |
**Erweiterung (dieses ADP):** Vision-Ebenen bleiben fachlich; **Präsentation** wird um **App-weite Arbeitsmodi** ergänzt. Unterseiten-Inhalte **migrieren in Modi + Scope**, nicht in tiefere Verschachtelung.
---
## Optionen
| Option | Kurzbeschreibung | Pro | Contra |
|--------|------------------|-----|--------|
| **A** | Status quo + weiter patchen | Kein Migrationsaufwand | PM-Use-Cases bleiben unbedienbar; KI ohne Einstieg |
| **B** | Nur Widgets auf Workspace erweitern | Schnell | Kein Plan/Kontrolle-Modus; Vorhaben-Tabs bleiben |
| **C** | **Fünf App-Modi + Scope-Selector** (UI Concept v0.1) | Entspricht PM-Logik; Querschnitt; Agent-ready | Einmaliger IA-Umbau; Redirects nötig |
---
## Entscheidung (Empfehlung: Option C)
### 1. App-Hauptnavigation = Arbeitsmodi
| Modus | Route | Ersetzt / absorbiert |
|-------|-------|----------------------|
| Cockpit | `/cockpit` | `/workspace`, Portfolio-Widgets |
| Ausführen | `/work/*` | `/my-actions`, Tab Ausführung (Ist-Teil) |
| Planen | `/plan/*` | Tabs Plan, Eingang, Project-Struktur |
| Kontrolle | `/control/*` | Initiative-Steuerung, Journey, Plan-Ist-Aggregate |
| Team | `/team` | Workload (neu) |
**Objekt-Routen (first-class, parallel zur Modus-Nav):** `/actions/:id`, `/projects/:id`, `/gates/:id`, `/tasks/:id` (AP1.5d). Beim Öffnen: Scope und aktiver Modus aus Objektdaten ableiten; Redirects von legacy nested URLs.
Vorhaben-Katalog: `/initiatives` — **Scope setzen**, nicht primärer Arbeitscontainer.
### 2. Scope-Selector (global)
- Portfolio | Initiative | optional Project
- URL: `?initiative=&project=` (Query) — **Scope Lock** bis ADP v0.2
- React Context: `ProgramScopeProvider` in `AppLayout`
### 3. InitiativeSubNav — deprecate
- Tabs `Steuerung | Zielzustände | Ausführung | Eingang | Nachvollziehbarkeit` werden **entfernt** (nach AP1.9a Redirects)
- Inhalt wandert in Modi (siehe UI Concept §11)
### 4. Harte Guardrails (Scope Lock)
| Verboten | Erlaubt |
|----------|---------|
| Neue Sektionen auf `InitiativeExecutionPage` | Hotfix bis AP1.9a |
| Inline-CRUD auf Modus-Übersichten | Detail-Route / Modal |
| Dritte parallele Navigationshierarchie | Scope + Modus nur |
| Project-Lifecycle / Steering pro Project | ADP Recursive Containers |
### 5. Implementierungspakete
```text
AP1.9a Shell, Routen, Scope, Redirects, Platzhalter-Screens
AP1.9b Cockpit + Work/Heute (AP-Querschnitt)
AP1.9c Control (Snapshot, Journey, Plan-Ist)
AP1.9d Plan (Structure, Gates, Inbox)
AP1.9e Team (Workload)
```
AP1.5d (Tasks) **füllt** `/work` — ändert IA nicht.
AP1.8 (Portfolio-Prio) **erweitert** `/cockpit`.
AP1.7 (Agent API) **mappt** auf Modus-Endpunkte.
---
## Risiko
| Risiko | Mitigation |
|--------|------------|
| Große Migration / gebrochene Bookmarks | Redirect-Tabelle, 6 Monate |
| Doppelpflege alt/neu | Freeze auf alten Tabs ab AP1.9a Start |
| Scope in URL vs. State | Ein Provider, Tests für Deep-Links |
| Überengineering Mobile | 9a nur Desktop+Mobile Nav-Parität; Detail polish later |
---
## Rückbaubarkeit
- Modi-Routen isoliert unter `frontend/src/modes/` (neu)
- Alte Initiative-Routen als Redirect-Layer bis Entfernung
- Scope-Provider optional abschaltbar für Tests
- ADP v0.2 kann Modus-Namen anpassen ohne OM-Änderung
---
## Auswirkung auf Roadmap
| Paket | Änderung |
|-------|----------|
| AP1.5d | Bleibt; liefert Task-Daten für `/work` |
| AP1.4c Gate-UI | Gehört in `/plan/gates`, nicht Initiative-Tab |
| AP1.8 | Cockpit-Feature |
| AP1.7 | Nach AP1.9b+c (Leseschnittstellen stabil) |
**Nächstes Code-Paket nach PO-Freigabe:** AP1.9a (Shell) — **nicht** weiter AP1.5e-UI.
---
## PO-Freigabe
- [ ] Option C angenommen
- [ ] UI Concept v0.1 bestätigt
- [ ] AP1.9a–e Reihenfolge OK
- [ ] InitiativeSubNav-Abschaffung OK
---
## Referenzen
- `docs/product/Kairo_PM_Frontend_UI_Concept_v0.1.md`
- `docs/product/Kairo_Corrected_MVP_Roadmap_v0.2.md` (Abschnitt AP1.9)
- `docs/product/Kairo_Implementation_Truth_Table_v0.1.md`
@@ -52,7 +52,24 @@ Siehe `ADP_PO_Product_Layering_and_IA_Reset_v0.1.md`.
Siehe `ADP_Recursive_Containers_and_Execution_Granularity_v0.1.md`.
**Reihenfolge:** AP1.5c → AP1.6 → AP1.5d
**Reihenfolge:** AP1.5c → AP1.6 → **AP1.9 (PM Work Modes IA)** → AP1.5d
---
## 1.3 PO-Entscheidung 2026-07-08 — PM Work Modes (Frontend IA)
**Auslöser:** Programmmanager-Feedback — Vorhaben-Unterseiten decken Arbeitslogik nicht ab; Querschnitt fehlt.
| Entscheidung | |
|--------------|--|
| App-Navigation = **Arbeitsmodi** (Cockpit, Ausführen, Planen, Kontrolle, Team) | vorgeschlagen |
| Scope = Filter (Portfolio / Vorhaben / Projekt), nicht Navigationstiefe | vorgeschlagen |
| Initiative-Tabs (`InitiativeSubNav`) abschaffen | vorgeschlagen, mit Redirects |
| Kein weiteres UI-Patching auf Ausführungs-Tab | Scope Lock ab AP1.9a |
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.
---
@@ -69,8 +86,9 @@ 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 Rekursive Tasks AP1.5d ← **NÄCHSTES CODE**
Phase I Gate-Graph AP1.4d–4e nach 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 J Portfolio & Kontext AP1.8 geplant
Phase K Agent Interface AP1.7 geplant (unverändert)
Phase L Validation AP0.10d (laufend PO) parallel
@@ -94,6 +112,8 @@ 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) |
| 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 |
@@ -156,6 +176,26 @@ Backlog/Action/Project/Task → RoadmapItem; Decision-Spur; Journey-Timeline.
---
### AP1.9 — PM Work Modes & Frontend IA Reset ← **NÄCHSTES CODE**
**Ziel:** App-weite Arbeitsmodi statt Vorhaben-Tab-Omnibus; Querschnitt für PM-Use-Cases.
| 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 |
**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
**Explizit nicht:** Weitere Features unter `InitiativeExecutionPage` / `InitiativeSubNav`.
---
### AP1.5d — Rekursive Tasks & Roll-up
**Ziel:** Task-Baum (`parent_task_id`); Mensch UI max. ~3 Ebenen; Agent tiefer.
@@ -169,8 +209,8 @@ 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.6**
**Version:** `0.15.1-ap1.5d`
**Nach AP1.9b** (Tasks füllen `/work`, IA bleibt)
**Version:** `0.16.x-ap1.5d`
---
@@ -0,0 +1,444 @@
# Kairo — PM Frontend UI Concept v0.1
**Status:** PO-Arbeitsentwurf (Entscheidung ausstehend)
**Stand:** 2026-07-08
**Auslöser:** Programmmanager-Feedback — Objekt-Hierarchie ohne Arbeitslogik; Vorhaben-Unterseiten als Sackgasse
**Bezug:** Vision v0.2 §7, Canonical OM v0.2 §8, `ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md`
**Ersetzt als UI-Leitbild:** Ad-hoc-Layout unter `InitiativeExecutionPage` / Tab-Omnibus
---
## 1. Problem in einem Satz
Kairo hat **Objekte** (Vorhaben, Projekt, Arbeitspaket) und **Tabs**, aber keine **Arbeitsmodi** — deshalb findet ein Programmmanager weder Querschnitt noch Planung noch Kontrolle, und KI/Agenten haben keinen kanonischen Einstieg.
---
## 2. Leitprinzipien (verbindlich für UI)
| # | Prinzip | Konsequenz |
|---|---------|------------|
| P1 | **Modi für Überblick, Objekte direkt** | Modi beantworten Querschnittsfragen; **bekannte** APs/Projekte/Gates sind per **Deep Link** sofort erreichbar — ohne vorher Modus wählen. |
| P2 | **Scope ist Filter, kein Gefängnis** | Portfolio, ein Vorhaben oder ein Projekt sind **Filter** auf dieselben Modi — nicht separate Welten. |
| P3 | **Querschnitt auf Top-Level** | „Alle meine Tasks“, „Was klemmt?“, „Nächster Schritt?“ leben **global**, nicht unter `/initiatives/:id/...`. |
| P4 | **Übersicht entscheidet, Detail pflegt** | Modi zeigen Steuerungsantworten; Anlage/Bearbeitung nur auf **Objekt-Detail-Routen** oder Modal — nie als dauerhafte Inline-CRUD-Wand. |
| P5 | **Plan ≠ Ausführung ≠ Kontrolle** | Drei kognitive Tätigkeiten — drei Flächen. Nicht in einem Tab stapeln. |
| P6 | **Methodenneutral** | Gates optional; flache Vorhaben ohne Roadmap müssen in jedem Modus sinnvoll leer oder reduziert sein (`generic_operating`). |
| P7 | **Gleiche Logik für Mensch und Agent** | Jeder Modus mappt auf lesbare/schriftbare API-Oberflächen (`steering/`, Workspace Data Layer). |
| P8 | **Stabile Objekt-URLs** | `/actions/:id`, `/projects/:id` usw. sind bookmarkbar; Scope und Modus werden aus dem Objekt **abgeleitet**, nicht manuell vorher gesetzt. |
---
## 3. Navigationsmodell — drei Ebenen
```text
┌─────────────────────────────────────────────────────────────┐
│ EBENE 1 — MODUS (Sidebar): Querschnitt & Arbeitsintention │
│ Cockpit │ Ausführen │ Planen │ Kontrolle │ Team │
└─────────────────────────────────────────────────────────────┘
+
┌─────────────────────────────────────────────────────────────┐
│ EBENE 2 — SCOPE (Header): Filter auf Modus-Inhalte │
│ Portfolio > Vorhaben X > [ optional Projekt Y ] │
└─────────────────────────────────────────────────────────────┘
+
┌─────────────────────────────────────────────────────────────┐
│ EBENE 3 — OBJEKTFokus (Route): Konkretes Ding bearbeiten │
│ /actions/:id /projects/:id /gates/:id … │
└─────────────────────────────────────────────────────────────┘
```
**Modus allein reicht nicht** — du springst oft **direkt** auf ein Arbeitspaket oder Projekt (Link, Lesezeichen, Next-Action-Klick, Agent).
**Modus allein reicht auch nicht ohne Querschnitt** — „Was ist heute dran über alles?“ braucht `/work/heute` ohne vorher ein Vorhaben zu öffnen.
| Ebene | Wann | Beispiel |
|-------|------|----------|
| **Modus** | Ich weiß noch nicht *welches* Objekt, aber *welche Aufgabe* | „Heute“, „Was klemmt?“, „Planen“ |
| **Scope** | Ich will alles in einem Vorhaben/Projekt sehen | Filter auf Queue, Kontrolle, Plan |
| **Objekt** | Ich kenne die ID / den Namen | AP „API-Auth“, Projekt „Phase 2“ |
**Regel:** Objekt-Route hat **Vorrang**. Beim Öffnen von `/actions/:id` setzt die App automatisch Scope (Initiative, ggf. Project) und markiert den passenden Modus in der Sidebar — du musst nicht „erst Ausführen klicken“.
Wechsel des Modus **behält** Scope, solange sinnvoll. Wechsel des Objekts **aktualisiert** Scope aus den Objektdaten.
---
## 4. Die fünf Arbeitsmodi (Product Language)
### 4.1 Cockpit — *Wo stehe ich im Portfolio?*
**Leitfrage:** Welches Vorhaben braucht Aufmerksamkeit — und was ist programmweit als Nächstes dran?
| Inhalt | Quelle (heute / geplant) |
|--------|---------------------------|
| Portfolio-Kacheln mit Lifecycle, Signal, Prio | `InitiativePortfolioWidget`, AP1.8 Prio |
| Attention / Showstopper quer | `AttentionWidget`, Snapshot-Signale |
| Next Action (Portfolio-Scope) | `NextActionWidget` scope=portfolio |
| Kurz-KPIs (offen, blockiert, Gates at risk) | `WorkspaceSummaryWidget` |
**Nicht hier:** Gate-CRUD, Projektbaum, Sprint-Planung im Detail.
**Route:** `/cockpit` (Alias `/workspace` → Redirect)
---
### 4.2 Ausführen — *Was mache ich jetzt konkret?*
**Leitfrage:** Welche committete Arbeit (Arbeitspaket / Task) ist dran — **über alle Vorhaben und Projekte**?
| Inhalt | Beschreibung |
|--------|--------------|
| **Heute** | Mir zugewiesen, überfällig zuerst, Next-Action-Ranking |
| **Meine Queue** | Alle offenen Tasks/APs (filterbar) |
| **Nach Vorhaben / Projekt** | Gruppierung optional — kein Navigationszwang |
| Detail-Drill | Link zu AP-/Task-Detail |
**Nicht hier:** Programmstruktur anlegen, Gates definieren, Portfolio-Priorität setzen.
**Route:** `/work` (+ Unterrouten `/work/today`, `/work/mine`, `/work/queue`)
**Abhängigkeit:** Task-Querschnitt braucht AP1.5d; MVP von 4.2 startet mit **Arbeitspaketen**, Tasks folgen ohne IA-Wechsel.
---
### 4.3 Planen — *Wie soll das Programm aufgebaut sein?*
**Leitfrage:** Struktur, Gates, Eingang — was ist geplant, noch nicht committet?
| Zone | Inhalt |
|------|--------|
| **Struktur** | Project-Baum (Container), optional flach |
| **Zielzustände** | Gates / RoadmapItems, Kriterien, Abhängigkeiten |
| **Eingang** | Backlog, Triage, Convert-to-Action |
Planen ist **scope-pflichtig auf mindestens ein Vorhaben** (Struktur hängt an Initiative). Portfolio-Scope zeigt **Planungs-Inbox**: „Vorhaben ohne Struktur“, „Gates ohne Kriterien“ — Einstieg, nicht Vollplanung.
**Nicht hier:** Tagesausführung, Blocker-Status aller APs, Team-Workload.
**Route:** `/plan` (+ `/plan/structure`, `/plan/gates`, `/plan/inbox`)
**Migration:** Heutige Tabs `plan`, `inbox` und Projektbaum aus `execution` **wandern hierher**.
---
### 4.4 Kontrolle — *Erreichen wir die Ziele? Was blockiert den Fortschritt?*
**Leitfrage:** Plan vs. Ist, Zielerreichung, Risiken, kritischer Pfad, Showstopper.
| Zone | Inhalt |
|------|--------|
| **Programm-Status** | Lifecycle, Snapshot, Signale (pro Scope) |
| **Plan vs. Ist** | Gate-Beiträge, offene Kriterien, Journey |
| **Roadblocker** | Blockierte APs, offene Blocker, Gates at risk |
| **Kritischer Pfad** | Gate-Graph + Ist-Blocker (AP1.4d+, progressive) |
**Nicht hier:** Neue APs anlegen, Backlog triagieren.
**Route:** `/control` (+ `/control/status`, `/control/plan-ist`, `/control/journey`)
**Migration:** Teile von Initiative-Übersicht + Journey + Gate-Detail-Contributions.
---
### 4.5 Team — *Wer arbeitet an was?*
**Leitfrage:** Zuweisungen, Kapazität, Delegation.
| Inhalt | Quelle |
|--------|--------|
| Actor-Workload | `GET /api/workspace/actors/workload` |
| Offene Zuweisungen ohne Fortschritt | Snapshot / Assignments |
| Delegation (später) | Bulk-Zuweisung, Umhängen |
**Route:** `/team`
---
## 5. Vorhaben-Katalog — nicht der Arbeitsort
`/initiatives` wird **Katalog & Scope-Auswahl**, kein Omnibus:
- Liste / Suche aller Vorhaben
- Anlegen neues Vorhaben
- Klick setzt **Scope-Filter** und springt in sinnvollen Default-Modus (Cockpit scoped oder Kontrolle scoped) — **nicht** in verschachtelte Tab-Welt
**Abschaffen (Ziel):** Vorhaben als „App-in-App“ mit fünf Tabs, in denen alles passiert.
**Legacy-Redirects:** Alte URLs `/initiatives/:id/plan` → `/plan/gates?initiative=:id` etc. (siehe ADP AP1.9).
---
## 6. Direkte Objektnavigation (Deep Links)
### 6.1 Stabile Objekt-Routen (first-class)
Diese URLs funktionieren **ohne** vorherigen Modus- oder Scope-Schritt. Sie sind sharebar, bookmarkbar, Agent-Ziele.
| Objekt | Route (Ziel) | Modus (Sidebar) | Scope (auto) |
|--------|--------------|-----------------|--------------|
| **Arbeitspaket** | `/actions/:actionId` | Ausführen | Initiative + Project aus AP |
| **Task** (AP1.5d) | `/tasks/:taskId` | Ausführen | über Action → Initiative |
| **Projekt** | `/projects/:projectId` | Planen | Initiative + Project |
| **Gate** | `/gates/:gateId` | Planen (Detail) / Kontrolle (Ist) | Initiative |
| **Vorhaben** | `/initiatives/:id` | Kontrolle (Status-Home scoped) | Initiative |
| **Backlog-Item** | `/backlog/:id` | Planen → Inbox | Initiative |
**Bestehende Route** `/initiatives/:id/actions/:actionId` → Redirect auf `/actions/:actionId` (kanonische URL).
API-IDs sind global im Tenant — Pfad **ohne** `/initiatives/:id/...`-Präfix ist gewollt (kürzer, agentenfreundlich).
### 6.2 Verhalten beim Direktsprung
```text
Nutzer öffnet /actions/abc-123
│
▼
GET /api/actions/abc-123
│
├── Scope: initiative_id, project_id gesetzt
├── Sidebar: „Ausführen“ aktiv
├── Breadcrumb: Ausführen › {Vorhaben} › {AP-Titel}
└── Inhalt: AP-Detail (wie heute ActionDetailPage)
```
**Zurück-Navigation:** „Zur Queue“ → `/work/mine?initiative=` (Scope bleibt), nicht in Tab-Hölle.
### 6.3 Schnellzugriff (App-Chrome)
Neben Modus-Nav braucht es **Sprung-Hilfen** — unabhängig vom Modus:
| Element | Funktion | Phase |
|---------|----------|-------|
| **Springen zu…** (Suche) | Titel/ID: AP, Projekt, Gate, Vorhaben | AP1.9a minimal (Liste), 9f Volltext |
| **Zuletzt geöffnet** | 5–10 Objekte | AP1.9a |
| **Angepinnt** (optional) | PM pinnt laufende APs/Projekte | AP1.9b+ |
| Links aus Widgets | Next Action, Attention, Queue → Objekt-Route | AP1.9b |
```text
┌──────────┬──────────────────────────────────────────────────┐
│ … │ [ 🔍 Springen zu… ] Scope: Portfolio ▼ │
│ Cockpit ├──────────────────────────────────────────────────┤
```
Command Palette (⌘K) ist **optional später** — MVP: Suchfeld mit Typ-Ahead über offene APs/Projekte/Vorhaben.
### 6.4 Zwei Wege zum gleichen AP (beide gültig)
| Weg | Nutzen |
|-----|--------|
| **Querschnitt** | `/work/heute` → Liste → Klick | „Was ist überall dran?“ |
| **Direkt** | `/actions/:id` oder Suche | „Ich weiß schon, welches AP“ |
Das ist kein Widerspruch zu Modus-Nav — **Modi listen auf, Objekt-Routen fokussieren**.
---
## 7. Scope-Selector (globale Komponente)
Im **App-Chrome** (Sidebar-Header / Mobile-Header), in allen Modi sichtbar:
```text
┌─────────────────────────────────────────────┐
│ Scope: [ Portfolio ▼ ] > [ optional ] │
└─────────────────────────────────────────────┘
```
| Scope | Filterwirkung |
|-------|----------------|
| **Portfolio** | Alle Initiativen im Tenant |
| **Vorhaben** | Eine Initiative (+ implizit deren Projekte/APs) |
| **Projekt** | Subtree eines Blatt-/Container-Projects |
Scope wird in URL codiert: Query `?initiative=&project=` auf Modus-Listen; **Objekt-Routen** brauchen keinen Query (Scope aus Objekt). Bei Wechsel Scope → Modus-Liste aktualisieren; bei Objekt-Route Scope read-only anzeigen (änderbar über Scope-Dropdown → navigiert zur scoped Modus-Liste).
---
## 8. Routen-Zielbild (v0.1)
```text
── Modus-Listen (Querschnitt / scoped) ──
/cockpit Portfolio-Cockpit
/cockpit?initiative=:id Programm-Cockpit (scoped)
/work Ausführen — Default: Heute
/work/mine Meine Queue (APs → später Tasks)
/work/today Heute (überfällig, Next Action)
/work?initiative=:id Queue scoped
/plan/structure?initiative=:id Project-Baum
/plan/gates?initiative=:id Zielzustände
/plan/inbox?initiative=:id Backlog / Triage
/control/status?initiative=:id Lifecycle, Snapshot
/control/plan-ist?initiative=:id Gate-Beiträge
/control/journey?initiative=:id Timeline
/team Workload & Zuweisungen
/initiatives Katalog
/initiatives/new Anlage
── Objekt-Routen (Direktsprung, Scope auto) ──
/actions/:actionId Arbeitspaket-Detail ★
/tasks/:taskId Task-Detail (AP1.5d)
/projects/:projectId Projekt-Detail ★
/gates/:gateId Gate-Detail
/backlog/:backlogId Backlog-Detail
/initiatives/:id Vorhaben-Status (Kontrolle scoped)
── Legacy-Redirects ──
/initiatives/:id/actions/:aid → /actions/:aid
/initiatives/:id/execution/projects/:pid → /projects/:pid
/initiatives/:id/plan/items/:gid → /gates/:gid
```
★ = häufigste Direktsprünge für PM im Alltag.
**Objekt-Details** sind **keine Unterseiten eines Vorhabens** — sie sind tenant-globale Routen mit automatischem Kontext.
---
## 9. Screen-Matrix (PM Use Cases → Modus)
| PM Use Case | Primärer Modus | Sekundär |
|-------------|----------------|----------|
| Programm/Vorhaben strukturieren | **Planen** → Struktur | Planen → Gates |
| Meilensteine / Gates planen | **Planen** → Gates | Kontrolle (Ist-Beitrag lesen) |
| Roadmap / Abhängigkeiten | **Planen** → Gates | AP1.4d Graph |
| Sprint / nächste APs planen | **Planen** → Inbox + Struktur | Ausführen (Queue) |
| Konkrete nächste Schritte tun | **Ausführen** | Cockpit (Next Action) |
| Status innerhalb AP | **Ausführen** → Detail | — |
| Gesamtfortschritt / Zielerreichung | **Kontrolle** | Cockpit |
| Risiken / Showstopper | **Kontrolle** + Cockpit Attention | — |
| Kritischer Pfad | **Kontrolle** (später Graph) | — |
| Wer arbeitet an was | **Team** | Ausführen (Filter Actor) |
| Nächsten besten Schritt | **Cockpit** + **Ausführen/Heute** | Steering API |
| Beauftragung / Delegation | **Team** | AP-Detail |
| Direkt zu AP / Projekt springen | **Objekt-Route** `/actions/:id`, `/projects/:id` | Suche, Zuletzt |
| Alle Tasks quer (alle Projekte) | **Ausführen** → Queue | AP1.5d Tasks |
---
## 10. Layout-Anatomie (Wireframe)
### 10.1 App-Shell (Desktop)
```text
┌──────────┬──────────────────────────────────────────────────┐
│ Kairo │ [ Springen zu… ] Scope: Portfolio ▼ │
│ ├──────────────────────────────────────────────────┤
│ Cockpit │ MODUS- oder OBJEKT-INHALT │
│ Ausführen│ (Liste/Übersicht ODER AP/Projekt-Detail) │
│ Planen │ │
│ Kontrolle│ Breadcrumb: Ausführen › Vorhaben › AP-Titel │
│ Team │ │
│──────────│ Zuletzt: AP Auth · Projekt Phase 2 · … │
│ Vorhaben │ │
│ User │ │
└──────────┴──────────────────────────────────────────────────┘
```
### 10.2 Mobile
- Bottom-Nav: **Cockpit | Ausführen | Planen | Mehr** (Kontrolle + Team unter „Mehr“)
- Scope-Selector im Header
### 10.3 Anti-Pattern (ab AP1.9 verboten)
```text
✗ InitiativeExecutionPage = Projektbaum + AP-Hub + Blocker + Inline-Forms
✗ Tab „Ausführung“ als Müllhalde für Planung und Ist
✗ Querschnitt nur als kleines Widget ohne eigene Fläche
✗ AP-Detail nur unter /initiatives/:id/actions/:id erreichbar (kein /actions/:id)
```
---
## 11. Daten & API — Modus-Map (keine Parallel-Logik)
| Modus | Read Models / APIs |
|-------|---------------------|
| Cockpit | `workspace/*`, `attention`, `next-actions`, Initiative-Liste |
| Ausführen | `workspace/actions/*`, `actions/me/open`, Tasks (AP1.5d) |
| Planen | `projects`, `roadmap/*`, `backlog/*` |
| Kontrolle | `steering-snapshot`, `journey`, `plan-ist` contributions |
| Team | `actors`, `workspace/actors/workload`, Assignments |
Alles weiter über `TenantContext` + Capabilities — Modus ist **pure IA**, keine neue Domäne.
---
## 12. Migrationsplan — vom Ist zum Zielbild
| Heute | Ziel | Phase |
|-------|------|-------|
| `/workspace` Widget-Grid | `/cockpit` strukturierte Flächen | 9b |
| `/my-actions` | `/work/mine` | 9b |
| `/initiatives/:id` Steuerung | `/control/status?initiative=` | 9c |
| Tab Plan | `/plan/gates?initiative=` | 9d |
| Tab Eingang | `/plan/inbox?initiative=` | 9d |
| Tab Ausführung (Stack) | `/work?initiative=` + AP-Detail | 9c |
| Tab Journey | `/control/journey?initiative=` | 9c |
| Projekt-Detail unter execution | `/projects/:projectId` | 9d |
| AP-Detail nested unter initiative | `/actions/:actionId` (kanonisch) | 9a |
| `InitiativeSubNav` Tabs | **Entfernen** — Modus-Nav global | 9a |
Redirects mindestens **6 Monate** oder bis PO schließt.
---
## 13. Umsetzungspakete (Roadmap)
| Paket | Ergebnis | Nutzen für PM |
|-------|----------|----------------|
| **AP1.9a** | App-Shell, Modi-Routen, **Objekt-Routen**, Scope-Provider, Springen-zu (minimal), Redirects | Navigation + Direktsprung |
| **AP1.9b** | Cockpit + Ausführen/Heute (AP-Querschnitt) | Täglicher Einstieg |
| **AP1.9c** | Kontrolle (Snapshot, Journey, Plan-Ist) | Status & Zielerreichung |
| **AP1.9d** | Planen (Struktur, Gates, Inbox) | Planung ausgelagert |
| **AP1.9e** | Team + Delegation-Grundlagen | Wer macht was |
| **AP1.5d** | Tasks in Ausführen-Queue | Feingranulare Querschnittsliste |
| **AP1.8** | Portfolio-Priorität im Cockpit | Welches Vorhaben zuerst |
**Kein weiteres AP1.5x-UI-Patch** auf `InitiativeExecutionPage` außer Hotfixes bis AP1.9a live ist.
---
## 14. MVP-Nutzbarkeit (neu formuliert)
Kairos Frontend ist **für Programmmanager nutzbar**, wenn:
1. **Ausführen/Heute** in ≤30s die nächste Arbeit **portfolio-weit** zeigt
2. **Cockpit** in ≤30s zeigt, welches Vorhaben Aufmerksamkeit braucht
3. **Planen** und **Ausführen** ohne gemeinsame Seite erreichbar sind
4. **Kontrolle** Plan vs. Ist und Blocker **ohne CRUD-Listen** aggregiert
5. Scope-Wechsel von Portfolio → Vorhaben **ohne Modus-Wechsel** funktioniert
6. Agent-API kann dieselben aggregierten Read Models ansprechen (Vorbereitung AP1.7)
7. **Direktsprung** auf AP/Projekt per URL oder Suche — Scope korrekt gesetzt
---
## 15. Offene PO-Entscheide (vor AP1.9a Code)
| # | Frage | Empfehlung |
|---|-------|------------|
| 1 | URL-Scope: Query vs. Pfad | Query `?initiative=` + Context |
| 2 | Default nach Vorhaben-Klick | Cockpit scoped |
| 3 | `/workspace` Redirect | Ja → `/cockpit` |
| 4 | Tab-InitiativeSubNav entfernen | Ja, mit Redirects |
| 5 | Planen ohne Scope | Inbox leer + CTA „Vorhaben wählen“ |
| 6 | Kanonische AP-URL | `/actions/:id` (Redirect von nested) |
| 7 | Kanonische Projekt-URL | `/projects/:id` |
---
## 16. Referenzen
- `Kairo_Vision_and_Product_Direction_v0.2.md` §7
- `Kairo_Canonical_Operating_Model_v0.2.md` §8
- `ADP_PO_Product_Layering_and_IA_Reset_v0.1.md`
- `ADP_AP1_9_PM_Work_Modes_Frontend_IA_v0.1.md` (Scope Lock)
- `Kairo_Implementation_Truth_Table_v0.1.md` (wird mit AP1.9 aktualisiert)
---
*Dieses Dokument ist das führende UI-Zielbild ab 2026-07-08 bis PO-Freigabe oder v0.2. Implementierung ohne Alignment hier → Principle Gate.*