Files
kandev/docs/specs/ui/requirements/plan-editor-task-switch-stability.md
T
2026-09-08 09:54:18 +00:00

1.9 KiB

status, system, created, owners
status system created owners
active ui 2026-09-08
kandev

Plan Editor Task-Switch Stability Requirements

Overview

The Plan panel can remain open while a user selects another task. The UI system owns the editor and search-control lifecycle during that task change. The tasks system continues to own plan data and task selection.

Terminology

  • Available plan editor: The mounted editor for the selected task that can accept plan-search actions.
  • Plan-search action: A query update, query clear, next-match action, or previous-match action from the Plan panel.

Requirements

REQ-UI-PLAN-EDITOR-TASK-SWITCH-001: Stable editor replacement

Intent: Keep task navigation usable while Kandev replaces the plan editor.

User story: As a Kandev user, I want to switch tasks while the Plan panel is open, so that an outgoing editor cannot break the selected task page.

Acceptance criteria

  • AC-UI-PLAN-EDITOR-TASK-SWITCH-001.1: When a user selects another task while the Plan panel is mounted, the selected task page shall remain usable.
  • AC-UI-PLAN-EDITOR-TASK-SWITCH-001.2: During editor replacement, a plan-search action shall run only against the available plan editor.
  • AC-UI-PLAN-EDITOR-TASK-SWITCH-001.3: If no plan editor is available, a plan-search action shall not cause the task page to show its recovery screen.
  • AC-UI-PLAN-EDITOR-TASK-SWITCH-001.4: After the selected task editor is available, plan search shall update queries and navigate matches in that editor.
  • AC-UI-PLAN-EDITOR-TASK-SWITCH-001.5: A plan-comment command shall run only against the available plan editor.

Out of scope

  • Changing task selection, plan persistence, or saved Dockview layouts.
  • Changing Plan panel layout, touch controls, or responsive composition.
  • Changing the route error boundary or its recovery screen.
  • Changing optional voice services or analytics scripts.