# 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 -- <pfade>`), 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).
