# UX-Struktur — Vorgaben für die Umsetzung **Design:** `docs/superpowers/specs/2026-08-20-ux-struktur-design.md`. Dort stehen die Entscheidungen und Belege; dieses Dokument wiederholt sie nicht, es schneidet die Arbeit. **Ausführungsmodell: eine strikte Kette.** Alle drei Pakete ändern `locales/en.json` und `locales/de.json` — die überlappen immer. Deshalb läuft nichts parallel. ``` #189 → #190 → #191 → #192 (mechanische Audit-Fixes, bereits delegiert) │ └── A Task-Zeile + Kontextmenü │ └── B Settings-Sidebar │ └── C Erststart-Banner + Textkette ``` Jedes Paket hängt per `dependsOn` am Vorgänger. Der Picker holt es erst, wenn der Vorgänger **Done** (also gemergt) ist. ## Datei-Eigentum (bindend) | Paket | Besitzt | Darf **nicht** anfassen | |---|---|---| | **A** | `Ui/Views/Islands/TaskRowView.axaml(.cs)`, `Ui/ViewModels/Islands/TaskRowViewModel.cs`, `Ui/Views/Islands/Detail/TaskHeaderBar.axaml`, `locales/*` | `WorkConsole.axaml`, Settings-Dateien, `ListsIsland*` | | **B** | `Ui/Views/Modals/SettingsModalView.axaml(.cs)`, `Ui/ViewModels/Modals/SettingsModalViewModel.cs`, `Ui/ViewModels/Modals/Settings/*`, `locales/*` | alles im Islands-Ordner | | **C** | `Ui/Views/Islands/ListsIslandView.axaml(.cs)`, `Ui/ViewModels/Islands/ListsIslandViewModel.cs`, `Ui/Views/Islands/Detail/WorkConsole.axaml` (nur die eine Approve-Gate-Zeile), `Ui/Views/Islands/TasksIslandView.axaml` (nur Empty-State-Texte aus #192 nachschärfen), `locales/*` | `TaskRowView*`, Settings-Dateien | Alle drei dürfen `tests/ClaudeDo.Ui.Tests` erweitern — aber nur eigene neue Testdateien bzw. eigene neue Testmethoden anlegen, keine fremden umschreiben. ## Vorgaben für alle drei Pakete - **Modell:** `sonnet`. **`maxTurns` explizit 200** — `model_presets` ist NULL, sonst gibt es 30 Turns und „exited with code 1 and no result". - **Bauen** (`.slnx` scheitert auf .NET 8, laufender Worker sperrt `Debug`): ``` dotnet build src/ClaudeDo.App/ClaudeDo.App.csproj -c Release dotnet test tests/ClaudeDo.Ui.Tests/ClaudeDo.Ui.Tests.csproj -c Release dotnet test tests/ClaudeDo.Localization.Tests/ClaudeDo.Localization.Tests.csproj -c Release ``` - **Nur eigene Dateien stagen** (`git commit -- `), nie `git add -A` — der `main`-Checkout ist mit parallelen Sessions geteilt. - **Keine Funktion still entfernen.** Wo etwas aus einer Oberfläche verschwindet, im Abschlussbericht benennen, wo es jetzt liegt. - **Locale-Parity** ist Testsache (Localization.Tests) — beide Dateien im gleichen Commit. - **Visuelle Verifikation im Abschlussbericht als offen markieren.** Mika macht den visuellen Pass; kein Task darf behaupten, die UI sei geprüft. --- ## Paket A — Task-Zeile + Kontextmenü Themen 1 und 3 des Designs zusammen, weil sie dieselben drei Dateien anfassen. - [ ] **A1 Kontextmenü umbauen.** Gruppe 1 (Send to queue, Remove from queue, Cancel execution, Open quick session, Refine task) immer sichtbar, bei nicht erfüllter Bedingung `IsEnabled=false` + Grund. Untermenüs „Mark as", „Planning", „Schedule" nach der Tabelle im Design; Untermenü-Kopf disabled wenn leer. Der „Delete task…"-Eintrag aus #191 bleibt als abgesetzte Gruppe unten. `MakeItem` bekommt einen `reason`-Parameter. - [ ] **A2 Disabled-Gründe am VM.** `SendToQueueDisabledReason`, `CancelDisabledReason`, `QuickSessionDisabledReason`, `RefineDisabledReason`, `PlanningDisabledReason` (`string?`) auf `TaskRowViewModel`, mit Change-Notification an den passenden Stellen. Unit-Tests pro Zustand. - [ ] **A3 Tooltip-Fähigkeit verifizieren.** Headless prüfen, ob Avalonia 12 einen `ToolTip` auf einem `IsEnabled=false` MenuItem anzeigt. Ja → Tooltip. Nein → Grund als Suffix im Header. Das Ergebnis gehört in den Abschlussbericht (es ist eine Projekt-Erkenntnis, kein Detail). - [ ] **A4 Hover-/Selektions-Aktionen.** `IsHovered` + `ShowRowActions => IsHovered || IsSelected` am `TaskRowViewModel`; `PointerEntered`/`PointerExited` in `TaskRowView.axaml.cs`. Refine-Button, ungesetzter Star und Dequeue-X werden damit AND-verknüpft; `IsRefining`-Spinner bleibt ausgenommen. Grid-Spalten unverändert lassen, damit die Zeile nicht springt. - [ ] **A5 Branch verlagern.** Branch-Chip aus `TaskRowView.axaml` entfernen und den Branch-Namen in `TaskHeaderBar.axaml` als Meta-Zeile aufnehmen (er steht bisher nirgends im Detail-Pane). Ohne A5 darf der Chip nicht entfernt werden. **Fertig, wenn:** Build grün, Ui.Tests + Localization.Tests grün, und der Bericht sagt für jedes verschwundene Zeilen-Element, wo es jetzt erreichbar ist. --- ## Paket B — Settings-Sidebar - [ ] **B1 Host umbauen.** TabStrip des bestehenden `TabControl` ausblenden, links eine Sidebar-`ListBox` mit Gruppen-Labels BASIS/ERWEITERT, die `SelectedIndex` bindet. Panel-Inhalte bleiben, wo sie sind. Fensterbreite 580 → 700. `SettingsCategory(Key, Label, Group, IsVisible, RequiresRepo)` + `Categories` + `SelectedCategory` am `SettingsModalViewModel`. - [ ] **B2 General aufteilen.** „Allgemein" (Sprache, Accent, Default-Instructions) und „Ausführung" (Model, Permission, Model-Presets, MaxTurns-Ceiling, Parallelität, Usage-Gate). Kategorie „Berichte" neu mit Standup-Wochentag + Report-Excluded-Paths. Reihenfolge der Kategorien: Allgemein, Ausführung, Prime Claude | Worktrees, Dateien & Prompts, Session Skills, Berichte, Online Inbox. - [ ] **B3 Session Skills zusammenlegen.** Checkbox-Liste aus General entfernen; in der Kategorie „Session Skills" pro installiertem Skill eine Zeile mit Checkbox (global aktiv) + Update/Remove, darunter das Install-Feld. **Speichern/Laden der Auswahl muss nachweislich unverändert funktionieren** — Test dafür ist Pflicht, das ist die einzige echte Regressionsstelle des Pakets. - [ ] **B4 Repo-Hinweis.** `HasLinkedRepo` am `SettingsModalViewModel` (keine Liste mit `WorkingDir` → false). Hinweisstreifen oben in Worktrees, Prime Claude, Session Skills und Berichte: „Wirkt erst mit verknüpftem Repo" + Link, der den Repo-Import öffnet. **Fertig, wenn:** Build grün, Tests grün, jede der acht Kategorien einmal aufrufbar, und Save → Reopen zeigt alle Werte unverändert (inkl. Skill-Auswahl). --- ## Paket C — Erststart-Banner + Textkette - [ ] **C1 Banner.** `HasNoLinkedRepo` am `ListsIslandViewModel` (true, solange keine User-Liste ein `WorkingDir` hat; neu berechnet beim Listen-Load und nach List-CRUD/List-Settings-Save). Banner unter dem Lists-Island-Header, optisch wie das Update-Banner des Shells, Button ruft `OpenRepoImportCommand`. Kein Dismiss. - [ ] **C2 Textkette abstimmen.** Die Empty-State-Texte aus #192 so nachschärfen, dass Banner → „Liste ohne Repo" → „Liste mit Repo, aber leer" als ein Weg lesbar sind; der letzte nennt „Send to queue" und den Worktree. - [ ] **C3 Review-Zeile.** Am Approve-Gate-Hinweis in `WorkConsole.axaml` (den #190 baut) eine Zeile ergänzen, die sagt, dass Approve gleichzeitig das Mergen der ganzen Einheit ist. Nur diese eine Stelle in der Datei anfassen. **Fertig, wenn:** Build grün, Tests grün, und die vier Texte im Bericht als zusammenhängende Kette zitiert sind (damit Mika sie ohne App lesen kann).