Carlos Florêncio
53 lines
1.9 KiB
Markdown
53 lines
1.9 KiB
Markdown
---
|
|
status: active
|
|
system: ui
|
|
created: 2026-09-08
|
|
owners:
|
|
- 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.
|