docs: comprehensive v3.4.0 documentation for AI and dashboard features

- ai.md: Added recipe, chat, usage, model subcommands with examples
- dash.md: Added Quick Wins section and Urgency Indicators documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Data-Wise

docs/commands/ai.md

@@ -6,12 +6,114 @@
 
 ```bash
 flow ai [options] <query>
+flow ai recipe <name> [input]
+flow ai chat [options]
+flow ai usage [action]
+flow ai model [action]
 ```
 
 ## Description
 
 `flow ai` sends queries to Claude with automatic project context. The AI receives information about your current directory, project type, git status, and active flow session.
 
+## Subcommands
+
+### recipe
+
+Run reusable AI prompts with variable substitution.
+
+```bash
+flow ai recipe list              # List all recipes
+flow ai recipe show <name>       # View recipe content
+flow ai recipe <name> <input>    # Run a recipe
+flow ai recipe create <name>     # Create custom recipe
+flow ai recipe edit <name>       # Edit user recipe
+flow ai recipe delete <name>     # Delete user recipe
+```
+
+**Built-in Recipes:**
+
+| Recipe         | Description                          |
+| -------------- | ------------------------------------ |
+| `review`       | Code review with actionable feedback |
+| `commit`       | Generate conventional commit message |
+| `explain-code` | Step-by-step code explanation        |
+| `debug`        | Help diagnose issues                 |
+| `refactor`     | Suggest code improvements            |
+| `test`         | Generate tests for code              |
+| `document`     | Generate documentation               |
+| `eli5`         | Explain like I'm 5                   |
+| `shell`        | Generate shell commands              |
+| `fix`          | Fix a problem                        |
+
+**Variables Available:**
+
+- `{{input}}` - User-provided input
+- `{{project_type}}` - Detected project type
+- `{{pwd}}` - Current directory
+- `{{date}}` - Today's date
+- `{{branch}}` - Current git branch
+- `{{project}}` - Project name
+
+### chat
+
+Interactive conversation mode with persistent history.
+
+```bash
+flow ai chat                     # Start chat session
+flow ai chat --context           # Enable project context
+flow ai chat --clear             # Clear conversation history
+flow ai chat --history           # Show conversation history
+```
+
+**In-Chat Commands:**
+
+| Command    | Description                |
+| ---------- | -------------------------- |
+| `/clear`   | Clear conversation history |
+| `/history` | Show conversation history  |
+| `/context` | Toggle project context     |
+| `/help`    | Show help                  |
+| `/exit`    | Exit chat (or Ctrl+D)      |
+
+### usage
+
+Track AI command usage and get personalized suggestions.
+
+```bash
+flow ai usage                    # Show statistics (default)
+flow ai usage stats              # Show usage statistics
+flow ai usage suggest            # Get personalized suggestions
+flow ai usage recent [n]         # Show last n commands
+flow ai usage clear              # Clear usage history
+```
+
+**Statistics Tracked:**
+
+- Total calls and success rate
+- Usage by command and mode
+- Recipe usage frequency
+- Current streak (daily usage)
+- Project-type patterns
+
+### model
+
+Manage AI model selection.
+
+```bash
+flow ai model                    # Show current model
+flow ai model list               # List available models
+flow ai model set <name>         # Set default model
+```
+
+**Available Models:**
+
+| Model    | Description                             |
+| -------- | --------------------------------------- |
+| `opus`   | Most capable, deep reasoning            |
+| `sonnet` | Balanced speed and capability (default) |
+| `haiku`  | Fast, lightweight responses             |
+
 ## Options
 
 | Option          | Description                                         |
@@ -20,6 +122,7 @@ flow ai [options] <query>
 | `-f, --fix`     | Fix mode - get suggestions to fix problems          |
 | `-s, --suggest` | Suggest mode - get improvement suggestions          |
 | `--create`      | Create mode - generate code from descriptions       |
+| `-m, --model`   | Select model for this query (opus, sonnet, haiku)   |
 | `-c, --context` | Force include project context                       |
 | `-v, --verbose` | Show context being sent to AI                       |
 | `-h, --help`    | Show help message                                   |
@@ -97,14 +200,22 @@ flow ai "should I use associative arrays here?"
 # Explain existing code
 flow ai --explain "the _flow_detect_type function"
 
-# Get fix suggestions
-flow ai --fix "zsh: command not found: r"
+# Get fix suggestions with specific model
+flow ai --model opus --fix "complex architectural issue"
+
+# Use recipes
+flow ai recipe review "function parse_status() { ... }"
+flow ai recipe commit "$(git diff --staged)"
+
+# Interactive chat
+flow ai chat --context
 
-# Request improvements
-flow ai --suggest "better progress bar implementation"
+# Check usage patterns
+flow ai usage suggest
 
-# Generate new code
-flow ai --create "a health check for brew packages"
+# Switch to faster model for quick queries
+flow ai model set haiku
+flow ai "quick question"
 ```
 
 ## Requirements
@@ -119,4 +230,4 @@ flow ai --create "a health check for brew packages"
 
 ---
 
-_Added in v3.2.0_
+_Added in v3.2.0, enhanced in v3.4.0 (recipes, chat, usage, model)_

docs/commands/dash.md

@@ -323,6 +323,59 @@ When displaying projects, priorities are color-coded:
 
 ---
 
+## ⚡ Quick Wins Section (v3.4.0+)
+
+The dashboard now includes a **Quick Wins** section showing tasks that can be completed in under 30 minutes. This is designed for ADHD-friendly productivity - easy wins to build momentum.
+
+### Triggering Quick Wins
+
+Projects appear in Quick Wins when their `.STATUS` file contains:
+
+```yaml
+# Option 1: Mark as quick win directly
+quick_win: yes
+
+# Option 2: Set estimate under 30 minutes
+estimate: 15m
+estimate: 20min
+```
+
+### Display
+
+```
+  ⚡ QUICK WINS (< 30 min)
+  ├─ ⚡ flow-cli      Fix typo in docs          ~15m
+  ├─ 🔥 medfit       Update version number     ~10m
+  └─ ⏰ stat-440     Post grades               ~20m
+```
+
+---
+
+## 🔥 Urgency Indicators (v3.4.0+)
+
+Projects can show urgency indicators in the Quick Access and Quick Wins sections:
+
+| Icon | Urgency | Trigger                                        |
+| ---- | ------- | ---------------------------------------------- |
+| 🔥   | High    | `urgency: high`, `deadline: today`, or overdue |
+| ⏰   | Medium  | `urgency: medium` or deadline within 3 days    |
+| ⚡   | Low     | Quick win or `priority: low`                   |
+
+### Setting Urgency in .STATUS
+
+```yaml
+# Direct urgency setting
+urgency: high
+
+# Or via deadline (YYYY-MM-DD format)
+deadline: 2025-12-27
+
+# Or via priority
+priority: 1 # Maps to high urgency
+```
+
+---
+
 ## 📂 File Dependencies
 
 ### Required Files