kandev/docs/specs/ui/README.md

---
status: draft
system: ui
specification_version: 1
migration: in_progress
owners:
  - kandev
---

# UI

## Scope

UI owns responsive behavior; other systems own behavior/state.

## Map

### Requirements

- [ACP model summary](requirements/acp-model-configuration-summary.md)
- [ACP Shell Command Output](requirements/acp-shell-command-output.md)
- [Adaptive Kanban](requirements/adaptive-kanban.md)
- [Task Add-Panel PR Submenu](requirements/add-panel-pr-submenu.md)
- [Agent Launch Prompt Composer](requirements/agent-launch-prompt-composer.md)
- [Dialog containment](requirements/dialog-content-containment.md)
- [Descriptive select options](requirements/descriptive-select-options.md)
- [Surface text](requirements/surface-text-hierarchy.md)
- [Message comments](requirements/agent-message-comments.md)
- [Agent Todo List Panel](requirements/agent-todo-list-panel.md)
- [App Status Bar](requirements/app-status-bar.md)
- [Column visibility](requirements/board-step-visibility-filter.md)
- [Inspect annotation submission](requirements/browser-inspect-annotations-save.md)
- [Cancel-turn progress](requirements/cancel-turn-progress.md)
- [Action feedback](requirements/changes-file-action-feedback.md)
- [File-row containment](requirements/changes-file-row-containment.md)
- [Changes walkthrough](requirements/changes-walkthrough-toolbar-width.md)
- [Task PR Automation Controls](requirements/ci-pr-automation.md)
- [Merge Queue Recovery Controls](requirements/ci-pr-merge-queue-recovery-controls.md)
- [Clarification context](requirements/clarification-context.md)
- [Clarification submit feedback](requirements/clarification-submit-feedback.md)
- [Command-panel task reveal](requirements/command-panel-sidebar-task-reveal.md)
- [Task activity icons](requirements/command-panel-task-activity-icons.md)
- [Workflow step navigation](requirements/compact-workflow-step-navigation.md)
- [Preview panel step navigation](requirements/kanban-preview-workflow-step-navigation.md)
- [Comment Markdown Rendering](requirements/comment-markdown.md)
- [Mention recency](requirements/composer-mention-recency.md)
- [Composer Suggestion Overlays](requirements/composer-suggestion-overlays.md)
- [Context Compaction Count](requirements/context-compaction-count.md)
- [Context Window Reset Freshness](requirements/context-window-reset-freshness.md)
- [Context Window Unmeasured State](requirements/context-window-unmeasured-state.md)
- [Embedded VS Code Executor Availability](requirements/embedded-vscode-executor-availability.md)
- [VS Code windows](requirements/embedded-vscode-windows-availability.md)
- [Empty-Turn Notice and Slash-Command Hint](requirements/empty-turn-notice.md)
- [Entity Reference Composer](requirements/entity-reference-composer.md)
- [Executor settings card spacing](requirements/executor-settings-card-spacing.md)
- [VCS File Links](requirements/external-vcs-file-links.md)
- [File Tree Chat Context](requirements/file-tree-chat-context.md)
- [File Tree Keyboard Scope](requirements/file-tree-keyboard-scope.md)
- [Reload Kandev after frozen-tab restore](requirements/fix-duplicated-tab-stale-data.md)
- [GitHub PR Review Actions](requirements/github-pr-review-actions.md)
- [GitHub Saved-Query Default Views](requirements/github-saved-query-defaults.md)
- [Kandev MCP Tool Results](requirements/kandev-mcp-tool-results.md)
- [Native HTML File Preview](requirements/native-html-preview.md)
- [Auto-hide empty workflow steps](requirements/kanban-auto-hide-empty-columns.md)
- [Repair last-prompt transcript pinning](requirements/last-prompt-pinning-regressions.md)
- [Repair merge commit details](requirements/merge-commit-details.md)
- [Mermaid Rendering](requirements/mermaid-rendering.md)
- [Message favorite star mobile sizing](requirements/message-favorite-star-mobile-size.md)
- [Metadata dialog](requirements/message-metadata-overflow.md)
- [Queue auto-merge (deprecated)](requirements/message-queue-auto-merge.md)
- [Queue auto-merge session overrides (active)](requirements/message-queue-auto-merge-session-overrides.md)
- [Message queue automation controls (active)](requirements/message-queue-automation-controls.md)
- [Message queue management](requirements/message-queue-management.md)
- [Merge queued](requirements/message-queue-merge.md)
- [Pin the Message Queue Panel](requirements/message-queue-pin.md)
- [Reorder Queued Messages](requirements/message-queue-reorder.md)
- [Pending auto-run (deprecated)](requirements/message-queue-run.md)
- [Send Queued Messages Now](requirements/message-queue-send-now.md)
- [Mobile topbar actions](requirements/mobile-quick-chat-topbar.md)
- [Mobile Task Chrome](requirements/mobile-task-chrome.md)
- [Mobile Task Navigation](requirements/mobile-task-navigation.md)
- [Plan comments](requirements/plan-comment-drafts.md)
- [Plan Editor Task-Switch Stability](requirements/plan-editor-task-switch-stability.md)
- [Port-forwarding discovery](requirements/port-forwarding-discovery.md)
- [Open proxy URLs in the browser panel](requirements/port-proxy-browser-panel.md)
- [Responsive PR Detail Header](requirements/pr-detail-header-width.md)
- [Repair PR-only commit details](requirements/pr-only-commit-details.md)
- [PR Task Status Summary](requirements/pr-task-status-summary.md)
- [PR walkthrough](requirements/pr-walkthrough.md)
- [Preview Sprites Transient Retry](requirements/preview-sprites-transient-retry.md)
- [Persistent status motion](requirements/persistent-status-motion.md)
- [Prompt History Panel](requirements/prompt-history-panel.md)
- [Prompt paste: Nerd Font glyphs](requirements/prompt-paste-nerd-font-glyphs.md)
- [Prompt turn duration](requirements/prompt-turn-duration.md)
- [Docs preview](requirements/published-docs-preview-reliability.md)
- [Quick Chat elevation](requirements/quick-chat-elevation.md)
- [Quick Chat viewport layout](requirements/quick-chat-viewport-layout.md)
- [Quick Chat Idle Dot](requirements/quick-chat-idle-dot.md)
- [Quick Chat and Terminal Tabs](requirements/quick-terminal.md)
- [Relative last seen](requirements/relative-last-seen.md)
- [Responsive Plan Formatting](requirements/responsive-plan-formatting.md)
- [Resizable Markdown Table Columns](requirements/resizable-markdown-tables.md)
- [Review File Status Cues](requirements/review-file-status.md)
- [Review Markdown Preview](requirements/review-markdown-preview.md)
- [Search/filter dropdown scroll reset](requirements/search-filter-scroll-reset.md)
- [Saved Task View Deletion Confirmation](requirements/saved-task-view-deletion-confirmation.md)
- [Selected option prominence](requirements/selected-option-picker-prominence.md)
- [Session](requirements/session-start-composer-readiness.md)
- [Session tab delete feedback](requirements/session-tab-delete-feedback.md)
- [Settings Discovery](requirements/settings-discovery.md)
- [Settings Menu Default](requirements/settings-menu-default.md)
- [Settings Manual Save](requirements/settings-manual-save.md)
- [Settings Prompt Editor](requirements/settings-prompt-editor.md)
- [Consistent settings typography](requirements/settings-typography.md)
- [Sidebar Automatic Task Colors](requirements/sidebar-automatic-task-colors.md)
- [Sidebar Archived Task Views](requirements/sidebar-archived-filter.md)
- [Sidebar Diff Stat Priority](requirements/sidebar-diff-stat-priority.md)
- [Sidebar empty task alignment](requirements/sidebar-empty-task-alignment.md)
- [Sidebar Effective Task Tree State](requirements/sidebar-effective-task-tree-state.md)
- [Sidebar Last Activity Sort](requirements/sidebar-last-activity-sort.md)
- [Sidebar Queued Prompt Count Badge](requirements/sidebar-queued-prompt-count.md)
- [Repository Groups](requirements/sidebar-repository-grouping.md)
- [Sidebar Task Focus](requirements/sidebar-task-focus.md)
- [Sidebar Task Completion Icons](requirements/sidebar-task-completion-icons.md)
- [Sidebar Task Row Presentation](requirements/sidebar-task-row-presentation.md)
- [Direct Sidebar View Creation](requirements/sidebar-view-creation.md)
- [Slash Command Composer Selection](requirements/slash-command-composer.md)
- [Subagent Observability](requirements/subagent-observability.md)
- [Nested Submodule Review](requirements/submodule-review.md)
- [Confirmations](requirements/confirmation-warning-hierarchy.md)
- [Task Layout Profiles](requirements/task-layout-profiles.md)
- [Task Agent Tab Reconciliation](requirements/task-agent-tab-reconciliation.md)
- [Threads Deck](requirements/threads-conversation-deck.md)
- [Task listing](requirements/task-listing-display-preferences.md)
- [Task transcript history visibility](requirements/task-prompt-transcript-visibility.md)
- [Task Review Shortcut Switcher](requirements/task-review-shortcut.md)
- [Task Surface Refresh](requirements/task-surface-refresh.md)
- [Workspace Search](requirements/task-workspace-content-search.md)
- [Terminal close feedback](requirements/terminal-close-feedback.md)
- [Terminal Rendering](requirements/terminal-rendering.md)
- [Terminal Touch Scrolling](requirements/terminal-touch-scrolling.md)
- [Toast theme](requirements/toast-theme.md)
- [Thinking Message Preview](requirements/thinking-message-preview.md)
- [Transcript Auto-scroll Stability](requirements/transcript-auto-scroll.md)
- [Transcript Navigation Settings](requirements/transcript-navigation-settings.md)
- [Voice Mode In Task Behavior](requirements/voice-mode-task-behavior.md)
- [Walkthrough Feedback Controls](requirements/walkthrough-feedback-controls.md)
- [Walkthrough nav](requirements/walkthrough-navigation-layout.md)
- [WebKit Task Dialog Rendering](requirements/webkit-task-dialog-rendering.md)
- [Active workspace first in settings](requirements/workspace-active-first-order.md)
- [WebSocket Connectivity Warning](requirements/ws-connectivity-warning.md)

### Design
- [Adaptive Kanban](system-design/adaptive-kanban.md)
- [Clarification submit feedback](system-design/clarification-submit-feedback.md)
- [Dialog containment](system-design/dialog-content-containment.md)
- [Descriptive select options](system-design/descriptive-select-options.md)
- [Surface text](system-design/surface-text-hierarchy.md)
- [Agent Todo List Panel](system-design/agent-todo-list-panel.md)
- [App Status Bar](system-design/app-status-bar.md)
- [Action feedback](system-design/changes-file-action-feedback.md)
- [File-row containment](system-design/changes-file-row-containment.md)
- [Mention recency](system-design/composer-mention-recency.md)
- [Composer Suggestion Overlays](system-design/composer-suggestion-overlays.md)
- [Compact step navigation](system-design/compact-workflow-step-navigation.md)
- [Kanban preview navigation](system-design/kanban-preview-workflow-step-navigation.md)
- [Comment Markdown Rendering](system-design/comment-markdown.md)
- [Workflow column visibility (Part 1)](system-design/board-step-visibility-filter-01.md)
- [Workflow column visibility (Part 2)](system-design/board-step-visibility-filter-02.md)
- [Task PR auto 1](system-design/ci-pr-automation-01.md)
- [Task PR auto 2](system-design/ci-pr-automation-02.md)
- [Task PR auto 3](system-design/ci-pr-automation-03.md)
- [Merge Queue Recovery Controls](system-design/ci-pr-merge-queue-recovery-controls.md)
- [Entity Reference Composer](system-design/entity-reference-composer.md)
- [File Tree Keyboard Scope](system-design/file-tree-keyboard-scope.md)
- [File Tree Chat](system-design/file-tree-chat-context.md)
- [MCP results](system-design/kandev-mcp-tool-results.md)
- [Message queue row controls](system-design/message-queue-row-controls.md)
- [Message Queue Automation Controls (current)](system-design/message-queue-automation-controls.md)
- [Native HTML File Preview](system-design/native-html-preview.md)
- [Mobile Task Chrome](system-design/mobile-task-chrome.md)
- [Persistent status motion](system-design/persistent-status-motion.md)
- [Repository Groups](system-design/sidebar-repository-grouping.md)
- [Sidebar Automatic Task Colors](system-design/sidebar-automatic-task-colors.md)
- [Sidebar Effective Task Tree State](system-design/sidebar-effective-task-tree-state.md)
- [Sidebar Task Focus](system-design/sidebar-task-focus.md)
- [Sidebar task row](system-design/sidebar-task-row-presentation.md)
- [PR walkthrough](system-design/pr-walkthrough.md)
- [PR Task Status Summary](system-design/pr-task-status-summary.md)
- [Prompt History Panel](system-design/prompt-history-panel.md)
- [Quick Chat and terminal elevation](system-design/quick-chat-elevation.md)
- [Quick Chat viewport layout](system-design/quick-chat-viewport-layout.md)
- [Quick Chat and Terminal Tabs](system-design/quick-terminal.md)
- [Plan comments](system-design/plan-comment-drafts.md)
- [Plan Editor Task-Switch Stability](system-design/plan-editor-task-switch-stability.md)
- [Responsive Plan Formatting](system-design/responsive-plan-formatting.md)
- [Confirmations](system-design/confirmation-warning-hierarchy.md)
- [Resizable Markdown Table Columns](system-design/resizable-markdown-tables.md)
- [Saved Task View Deletion Confirmation](system-design/saved-task-view-deletion-confirmation.md)
- [Session](system-design/session-start-composer-readiness.md)
- [Task Layout Profiles](system-design/task-layout-profiles.md)
- [Task surface](system-design/task-surface-render-isolation.md)
- [Task Agent Tab Reconciliation](system-design/task-agent-tab-reconciliation.md)
- [Threads Deck](system-design/threads-conversation-deck.md)
- [Command-panel Sidebar Task Reveal](system-design/command-panel-sidebar-task-reveal.md)
- [Command-panel activity icons](system-design/command-panel-task-activity-icons.md)
- [Terminal Rendering](system-design/terminal-rendering.md)
- [Terminal Touch Scrolling](system-design/terminal-touch-scrolling.md)
- [Toast theme](system-design/toast-theme.md)
- [Thinking Message Preview](system-design/thinking-message-preview.md)
- [Settings Menu Default](system-design/settings-menu-default.md)
- [Transcript history visibility](system-design/task-prompt-transcript-visibility.md)
- [Transcript Auto-scroll Stability](system-design/transcript-auto-scroll.md)

## Related

- [Platform](../platform/README.md)