228 lines
13 KiB
Markdown
228 lines
13 KiB
Markdown
# UX-Struktur: Kontextmenü, Settings, Task-Zeile, Erststart — Design
|
||
|
||
**Stand:** 2026-08-20 · Codestand `f9a8ed7` · Freigegeben von Mika im Brainstorming
|
||
|
||
Die vier strukturellen Themen aus dem UX-Audit vom 2026-08-20. Die *mechanischen* Befunde
|
||
desselben Audits laufen bereits als Tasks **#189** (Silent No-Ops → Footer-Fehler), **#190**
|
||
(Precondition-Hinweise), **#191** (Aktions-/Bestätigungs-Konsistenz), **#192** (Empty States).
|
||
Dieses Design setzt auf deren Ergebnis auf und wiederholt es nicht.
|
||
|
||
**Was hier nicht drinsteht:** die Audit-Befunde selbst (Memory `ux_audit_2026_08_20.md`) und die
|
||
Mechanik von Review/Merge (`docs/explore-notes/review-merge.md`).
|
||
|
||
---
|
||
|
||
## Gemeinsame Randbedingungen
|
||
|
||
- Alle drei Umsetzungs-Tasks laufen **nach #192**. Sie fassen dieselben Views an, und #189–#192
|
||
ändern Locale-Dateien, `TaskRowView.axaml.cs`, `DetailsIslandViewModel` und die Empty-State-Keys.
|
||
- **Keine Funktion verschwindet still.** Wo etwas aus einer Oberfläche verschwindet, muss dieses
|
||
Design sagen, wo es stattdessen erreichbar ist — und der Task muss das belegen.
|
||
- Neue Texte immer als Keys in `locales/en.json` **und** `locales/de.json` (Localization.Tests
|
||
erzwingt Parity).
|
||
- Visuelle Verifikation macht Mika. Jeder Task markiert sie im Abschlussbericht als offen.
|
||
|
||
---
|
||
|
||
## 1. Task-Kontextmenü restrukturieren
|
||
|
||
**Problem.** `TaskRowView.axaml.cs` baut ~18 flache MenuItems mit vier Separatoren. Kernaktionen
|
||
(Queue rein/raus, Abbrechen) stehen visuell gleichwertig neben Planning-Session-Lifecycle und
|
||
My-Day-Verwaltung. Zusätzlich werden Einträge bei nicht erfüllter Bedingung komplett ausgeblendet
|
||
— das Menü hat je Zustand ein anderes Layout, und der User erfährt nie, dass eine Aktion
|
||
existiert.
|
||
|
||
**Entscheidung: gruppieren und verschachteln.** Das Menü bleibt die vollständige Action-Surface
|
||
für einen Task (keine Verlagerung ins Detail-Pane — das ist selbst schon dicht).
|
||
|
||
```
|
||
Send to queue [disabled + Grund]
|
||
Remove from queue [disabled + Grund]
|
||
Cancel execution [disabled + Grund]
|
||
Open quick session [disabled + Grund]
|
||
Refine task [disabled + Grund] ← neu (siehe Thema 3)
|
||
─────────────────────────────
|
||
Mark as ▸ Done · Cancelled · ─ · Mark manual / Mark as Claude task
|
||
Planning ▸ Open · Resume · Finalize · Discard
|
||
Schedule ▸ Schedule for… · Clear schedule · ─ · Add to My Day / Remove from My Day
|
||
─────────────────────────────
|
||
Delete task… (aus #191, bleibt unten abgesetzt)
|
||
```
|
||
|
||
**Sichtbarkeitsregeln.**
|
||
|
||
| Ebene | Regel |
|
||
|---|---|
|
||
| Gruppe 1 (5 Einträge) | **Immer sichtbar**, Position fix. Bedingung nicht erfüllt → `IsEnabled=false` + Grund. |
|
||
| Untermenü-Einträge | Heutige Ausblende-Logik bleibt — die Auswahl ist dort exklusiv (Manual ⇄ Claude-Task, Add ⇄ Remove My Day). |
|
||
| Untermenü-Kopf | `IsEnabled=false`, wenn er leer wäre (z.B. „Planning" auf einem Manual-Task). |
|
||
| Delete | Wie #191 es baut, nur eigene Gruppe unten. |
|
||
|
||
**Grund-Anzeige.** Primär `ToolTip.Tip` am disabled MenuItem. **Verifikationspflicht:** Der Task
|
||
muss headless prüfen, ob Avalonia 12 Tooltips auf `IsEnabled=false` MenuItems überhaupt anzeigt.
|
||
Wenn nicht → Grund als Suffix im Header (`"Send to queue — kein Repo verknüpft"`). Kein
|
||
stillschweigendes Weglassen; wenn beides nicht geht, muss der Task es als Befund melden.
|
||
|
||
**Wo die Gründe herkommen.** Neue berechnete Properties auf `TaskRowViewModel` neben den
|
||
bestehenden `CanX`, z.B. `SendToQueueDisabledReason`, `CancelDisabledReason`,
|
||
`QuickSessionDisabledReason`, `RefineDisabledReason`, `PlanningDisabledReason` (jeweils `string?`,
|
||
`null` = kein Grund nötig). Keine Bedingungslogik in der View.
|
||
|
||
**Struktur im Code.** Das Menü wird weiterhin erst beim Öffnen gebaut (kein Rendering-Overhead
|
||
pro Zeile). `MakeItem` bekommt einen optionalen `reason`-Parameter und schaltet auf `IsEnabled`
|
||
statt `IsVisible` um, wenn der Aufrufer das verlangt.
|
||
|
||
**Ergebnis:** 18 flache Einträge → 9 Top-Level-Zeilen, davon 5 mit fixer Position.
|
||
|
||
---
|
||
|
||
## 2. Settings-Modal entzerren
|
||
|
||
**Problem.** Der General-Tab mischt 10+ Konzeptgruppen (Sprache, Accent, Default-Instructions,
|
||
Model, Permission, Model-Presets-Tabelle, MaxTurns-Ceiling, Parallelität, Usage-Gate-Prozente,
|
||
Report-Excluded-Paths, Standup-Wochentag, Session-Skills-Checkboxen). Session Skills stehen
|
||
**doppelt** (Auswahl in General, Verwaltung im Skills-Tab). Und die sechs Tabs füllen den
|
||
580 px breiten TabStrip bereits aus — ein siebter passt nicht.
|
||
|
||
**Entscheidung: Sidebar-Navigation mit zwei Gruppen.**
|
||
|
||
```
|
||
┌ Einstellungen ─────────────────────────────────────────┐
|
||
│ BASIS │ [Panel der gewählten Kategorie] │
|
||
│ Allgemein │ │
|
||
│ Ausführung │ │
|
||
│ Prime Claude │ │
|
||
│ │ │
|
||
│ ERWEITERT │ │
|
||
│ Worktrees │ │
|
||
│ Dateien & Prompts │ │
|
||
│ Session Skills │ │
|
||
│ Berichte │ │
|
||
│ Online Inbox │ (nur wenn ShowOnlineInbox) │
|
||
└────────────────────┴───────────────────────────────────┘
|
||
[Abbrechen] [Speichern]
|
||
```
|
||
|
||
**Kategorien-Inhalt.**
|
||
|
||
| Kategorie | Inhalt | Herkunft |
|
||
|---|---|---|
|
||
| Allgemein | Sprache, Accent-Preset, Default-Claude-Instructions | General |
|
||
| Ausführung | Default-Model, Permission-Mode, Model-Presets-Tabelle, MaxTurns-Ceiling, Max parallele Ausführungen, Usage-Gate (5h/7d %) | General |
|
||
| Prime Claude | Schedules + Daily-Prep-Max-Tasks | unverändert |
|
||
| Worktrees | Strategie, Root, Auto-Cleanup, Cleanup-/Reset-Aktionen | unverändert |
|
||
| Dateien & Prompts | Agents-Restore, Prompt-Pfade, Customized-Prompts | unverändert (Files) |
|
||
| Session Skills | **zusammengelegt**: je installierter Skill eine Zeile mit Checkbox (global aktiv) + Update/Remove; darunter Install-URL | Skills-Tab + Checkbox-Liste aus General |
|
||
| Berichte | Standup-Wochentag, Report-Excluded-Paths | General (neu herausgelöst) |
|
||
| Online Inbox | unverändert, weiter an `ShowOnlineInbox` gekoppelt | unverändert |
|
||
|
||
**Session-Skills-Zusammenlegung.** Die Checkbox-Liste im General-Tab entfällt. Beide VMs
|
||
(`GeneralSettingsTabViewModel.SessionSkills`, `SessionSkillsSettingsTabViewModel`) speisen künftig
|
||
**eine** Liste; die Auswahl (global aktive Skills) wird weiterhin über denselben Pfad gespeichert
|
||
wie heute. Der Task muss belegen, dass Speichern/Laden der Auswahl unverändert funktioniert —
|
||
das ist die einzige Stelle mit echtem Regressionsrisiko.
|
||
|
||
**Repo-Hinweis statt Verstecken.** Nichts wird ausgeblendet (verschwindende Einstellungen
|
||
irritieren in einem Power-Tool mehr als Dichte). Stattdessen zeigen **Worktrees, Prime Claude,
|
||
Session Skills und Berichte** oben einen Hinweisstreifen, solange keine Liste ein `WorkingDir`
|
||
hat: *„Wirkt erst mit verknüpftem Repo"* + Link, der den Repo-Import öffnet. Dafür eine neue
|
||
Property `HasLinkedRepo` am `SettingsModalViewModel`.
|
||
|
||
**Umsetzung risikoarm.** Das `TabControl` **bleibt** als Content-Host: nur der TabStrip wird
|
||
ausgeblendet, und eine Sidebar-`ListBox` bindet `SelectedIndex`. Die vorhandenen Panel-Inhalte
|
||
wandern damit nahezu unverändert mit (General wird gesplittet, Skills gemerged, Berichte neu).
|
||
Keine Neuschrift der 556 AXAML-Zeilen, compiled bindings bleiben intakt. Sidebar-Modell:
|
||
`SettingsCategory(Key, Label, Group, IsVisible, RequiresRepo)` in `SettingsModalViewModel.Categories`.
|
||
Fensterbreite 580 → 700.
|
||
|
||
---
|
||
|
||
## 3. TaskRow-Dichte
|
||
|
||
**Problem.** Eine Zeile kann 16 Elemente zeigen. Die Maximaldichte trifft real fast nur einen
|
||
`WaitingForReview`-Task in einer Smart-List (Status-, List-, Branch-, Diff-Chip plus Icons und
|
||
Buttons) — aber genau dort ist die Zeile am schwersten zu lesen.
|
||
|
||
**Entscheidung: Zustand bleibt, Aktionen auf Hover-oder-Selektion, reine Metadaten raus.**
|
||
|
||
| Klasse | Elemente |
|
||
|---|---|
|
||
| **Immer sichtbar (Zustand)** | Chevron (Planning-Parent), Done-Toggle, `#Nummer`, Titel, die vier Badges (DRAFT/PLANNED/Planning/MANUAL), Roadblock-Icon, Agent-Suggested-Icon, Status-Chip (bleibt tappbar → Mission Control), Diff-Chip, List-Chip (nur Smart-Lists, wie heute), Chain-Chip/Chain-Step-Badge, **gesetzter** Star |
|
||
| **Hover ODER Selektion (Aktion)** | Refine-Button, **ungesetzter** Star, Dequeue-X |
|
||
| **Aus der Zeile raus** | Branch-Chip |
|
||
|
||
**Kein Funktionsverlust.** Refine, Star und Dequeue bleiben über das Kontextmenü erreichbar —
|
||
„Remove from queue" existiert dort, „Refine task" wird in Thema 1 neu ergänzt. Selektion als
|
||
zweiter Trigger deckt Tastaturbedienung ab.
|
||
|
||
**Ausnahme.** Der Refine-**Spinner** (`IsRefining`) bleibt immer sichtbar. Ein laufender Refine
|
||
darf nicht verschwinden, wenn die Maus die Zeile verlässt.
|
||
|
||
**Branch-Chip: Verlagerung, nicht Löschung.** Der Branch-Name steht heute **nirgends** im
|
||
Detail-Pane (geprüft gegen `DetailsIslandView.axaml` und `Views/Islands/Detail/*.axaml` —
|
||
kein Treffer außer der Merge-Target-ComboBox). Er muss deshalb im selben Task in die
|
||
`TaskHeaderBar` als Meta-Zeile aufgenommen werden. `WorkConsole.axaml` fasst dieser Task
|
||
**nicht** an (Datei-Eigentum, siehe Plan).
|
||
|
||
**Umsetzung.** `TaskRowViewModel` bekommt `IsHovered` (gesetzt über `PointerEntered`/
|
||
`PointerExited` in `TaskRowView.axaml.cs`) und ein berechnetes
|
||
`ShowRowActions => IsHovered || IsSelected`. Die neuen Sichtbarkeiten sind **AND**-Verknüpfungen
|
||
mit den bestehenden `CanRefine` / `CanRemoveFromQueue` / `IsStarred` — keine bestehende Bedingung
|
||
wird ersetzt. Layout-Sprünge vermeiden: die Buttons behalten ihre Grid-Spalten
|
||
(`Auto,Auto,32`), es wechselt nur die Sichtbarkeit innerhalb fester Breite.
|
||
|
||
**Ergebnis:** Worst case ohne Hover 16 → 9 Elemente.
|
||
|
||
---
|
||
|
||
## 4. Erststart
|
||
|
||
**Problem.** Nach dem Seeding existieren nur My Day / Important / Planned und kein Repo. Es gibt
|
||
kein Onboarding; die Empty States aus #192 beschreiben den Ist-Zustand, aber nicht die Reihenfolge
|
||
Repo → Liste → Task → Queue → Review.
|
||
|
||
**Entscheidung: kein Onboarding-Konstrukt.** Ein zustandsgetriebenes Banner plus eine abgestimmte
|
||
Textkette. Explizit **kein** Wizard, **kein** Willkommens-Modal, **kein** Onboarding-Zustand in
|
||
DB oder Config.
|
||
|
||
**Banner** im Lists-Island direkt unter dem Header, optisch wie das bestehende Update-Banner des
|
||
Shells (kein neues Stil-Vokabular):
|
||
|
||
```
|
||
┌──────────────────────────────────────────────┐
|
||
│ Noch kein Repo verknüpft. ClaudeDo führt │
|
||
│ Tasks in einem Git-Repo aus. │
|
||
│ [ Repo importieren ] │
|
||
└──────────────────────────────────────────────┘
|
||
```
|
||
|
||
- Sichtbar, solange **keine User-Liste ein `WorkingDir` hat**. Neue Property `HasNoLinkedRepo`
|
||
am `ListsIslandViewModel`, neu berechnet beim Listen-Load und nach List-CRUD /
|
||
List-Settings-Save.
|
||
- **Kein Dismiss, kein persistierter Zustand.** Wer sein einziges Repo entfernt, bekommt den Weg
|
||
zurück wieder gezeigt.
|
||
- Der Button ruft das vorhandene `OpenRepoImportCommand` (dritter Einstieg neben dem Header-Button
|
||
und `Menü → Add repos`).
|
||
|
||
**Textkette.** Die Stellen müssen als ein Weg lesbar sein. Die Keys aus #192 existieren zu diesem
|
||
Zeitpunkt schon und werden nur nachgeschärft:
|
||
|
||
1. Banner → *Repo importieren*
|
||
2. Task-Liste leer, Liste **ohne** Repo (#192) → *Diese Liste hat kein Repo; in den List-Settings
|
||
verknüpfen*
|
||
3. Task-Liste leer, Liste **mit** Repo (#192) → *Task anlegen, dann Rechtsklick → „Send to queue" —
|
||
Claude arbeitet ihn in einem eigenen Worktree ab*
|
||
4. Review-Stufe: am Approve-Gate-Hinweis (den #190 in `WorkConsole.axaml` baut) **eine** Zeile
|
||
ergänzen, die sagt, dass Approve gleichzeitig das Mergen ist.
|
||
|
||
Punkt 3 erklärt die Queue genau dort, wo der erste Task entsteht. Punkt 4 schließt die Lücke,
|
||
dass der erste fertige Run in einem Zustand landet, den nichts ankündigt.
|
||
|
||
---
|
||
|
||
## Nicht Teil dieses Designs
|
||
|
||
- Der WorkConsole-Git-Tab (laut Audit das dichteste Panel der App) — eigenes Thema.
|
||
- Mission Control und der Diff-Viewer.
|
||
- Alles, was #189–#192 schon abdecken.
|