From e3805856e93199268c56f8611e7147c2843d26dd Mon Sep 17 00:00:00 2001
From: gsxdsm <gsxdsm@users.noreply.github.com>
Date: Sun, 12 Apr 2026 16:08:57 -0700
Subject: [PATCH] feat(FN-1641): update documentation to match current
 dashboard behavior

- Update README.md with current dashboard features
- Revise docs/dashboard-guide.md for accuracy
- Update docs/getting-started.md to reflect new user workflow
- Update docs/task-management.md with current task operations
- Complete preflight audit confirming docs consistency
---
 README.md               |  9 +++++++--
 docs/dashboard-guide.md |  2 +-
 docs/getting-started.md | 13 ++++++++++++-
 docs/task-management.md | 13 ++++++++++++-
 4 files changed, 32 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 8605d890b..bdc727075 100644
--- a/README.md
+++ b/README.md
@@ -104,7 +104,12 @@ fn task import owner/repo --labels bug --limit 10      # Import GitHub issues
 - **Quick Entry** — Type a description, press Enter
 - **Plan** (💡) — AI interviews you to refine requirements before creating the task; summary view supports **Break into Tasks** for multi-task generation with dependencies
 - **Subtask** (🌳) — AI suggests 2–5 subtasks with drag-and-drop reordering and dependency linking
-- **Actions** (⋯) — Access advanced controls: dependencies, model overrides (executor/validator/planning), and manual save
+- **Refine** (✨) — Refine the description with AI: clarify, add details, expand, or simplify
+- **Deps** (🔗) — Link existing tasks as dependencies before creation
+- **Attach** — Attach images to the task
+- **Models** (🧠) — Override executor, validator, or planning models per-task
+- **Agent** — Assign a specific agent to the task
+- **Save** — Manually save the task (alternative to pressing Enter)
 - **AI Title Summarization** — When `autoSummarizeTitles` is enabled, tasks without titles get concise AI-generated names (≤60 characters)
 
 ### AI Execution
@@ -139,7 +144,7 @@ Real-time kanban board at `localhost:4040`:
 - **Mission manager** — Hierarchical mission/milestone/slice/feature planning with progress tracking and autopilot controls
 - **Activity log** — Task lifecycle events, settings changes, filter by type, auto-refresh
 - **Files browser** — Browse project root or task worktrees, edit files with syntax highlighting
-- **Theme system** — Dark/Light/System modes, 17 color themes (Ocean, Forest, Nord, Dracula, and more)
+- **Theme system** — Dark/Light/System modes, 54 color themes (Ocean, Forest, Nord, Dracula, and more)
 - **Usage dialog** — Real-time AI provider subscription usage with progress bars and reset timers
 - **Spec editor** — Edit `PROMPT.md` directly, request AI revision, or rebuild/regenerate specs
 - **Planning Mode (multi-task)** — After AI planning, choose **Create Task** or **Break into Tasks** to generate dependency-linked subtasks
diff --git a/docs/dashboard-guide.md b/docs/dashboard-guide.md
index 37e9f358f..afa5468be 100644
--- a/docs/dashboard-guide.md
+++ b/docs/dashboard-guide.md
@@ -79,7 +79,7 @@ Features:
 Visual customization includes:
 
 - Theme mode: dark/light/system
-- **55 color themes** (including Ocean, Forest, Nord, Dracula, Gruvbox, Tokyo Night, and more)
+- **54 color themes** (including Ocean, Forest, Nord, Dracula, Gruvbox, Tokyo Night, and more)
 
 Theme preferences are stored in global settings.
 
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 651ad2fd9..96c3540f8 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -90,7 +90,18 @@ Use the 🌳 button to:
 - Reorder by drag-and-drop
 - Add dependency links before creating tasks
 
-### Option D: CLI
+### Option D: Expanded Controls (Board)
+
+Expand the quick entry panel (▼) to access additional controls:
+
+- **Refine** (✨) — Improve the description with AI
+- **Deps** (🔗) — Link existing tasks as dependencies
+- **Attach** — Add image attachments
+- **Models** (🧠) — Set per-task model overrides
+- **Agent** — Assign an agent to the task
+- **Save** — Create the task manually
+
+### Option E: CLI
 
 ```bash
 fn task create "Fix flaky login test"
diff --git a/docs/task-management.md b/docs/task-management.md
index 41c0158e7..ec7ffab10 100644
--- a/docs/task-management.md
+++ b/docs/task-management.md
@@ -31,7 +31,18 @@ Use the 🌳 button:
 - Add dependencies only on earlier items
 - Create tasks in one action
 
-### 4) CLI creation
+### 4) Expanded Controls
+
+Expand the creation panel (▼) to access additional controls:
+
+- **Refine** (✨) — Improve the description with AI
+- **Deps** (🔗) — Link existing tasks as dependencies
+- **Attach** — Add image attachments
+- **Models** (🧠) — Set per-task model overrides (executor, validator, planning)
+- **Agent** — Assign an agent to the task
+- **Browser Verify** — Enable browser verification workflow step
+
+### 5) CLI creation
 
 ```bash
 fn task create "Fix API timeout handling"