Add Q-generated docs for todo lists

Author: kiran-garre

docs/built-in-tools.md

@@ -9,6 +9,7 @@ Amazon Q CLI includes several built-in tools that agents can use. This document
 - [`report_issue`](#report_issue-tool) — Open a GitHub issue template.
 - [`knowledge`](#knowledge-tool) — Store and retrieve information in a knowledge base.
 - [`thinking`](#thinking-tool) — Internal reasoning mechanism.
+- [`todo_list`](#todo_list-tool) — Create and manage TODO lists for tracking multi-step tasks.
 - [`use_aws`](#use_aws-tool) — Make AWS CLI API calls.
 
 ## Execute_bash Tool
@@ -121,6 +122,12 @@ An internal reasoning mechanism that improves the quality of complex tasks by br
 
 This tool has no configuration options.
 
+## Todo_list Tool
+
+Create and manage TODO lists for tracking multi-step tasks. Lists are stored locally in `.amazonq/cli-todo-lists/`.
+
+This tool has no configuration options.
+
 ## Use_aws Tool
 
 Make AWS CLI API calls with the specified service, operation, and parameters.

docs/todo-lists.md

@@ -0,0 +1,93 @@
+# TODO Management
+
+The `/todos` command provides persistent TODO list management for Amazon Q CLI, allowing you to view, resume, and manage TODO lists created during chat sessions.
+
+## Getting Started
+
+TODO lists are automatically created when Q breaks down complex tasks. You can then manage these lists using the todos command:
+
+`/todos view`
+`/todos resume`
+
+## Commands
+
+#### `/todos view`
+
+Display and select a TODO list to view its contents, showing task descriptions and completion status.
+
+Interactive selection shows:
+- ✓ Completed lists (green checkmark)
+- ✗ In-progress lists with completion count (red X with progress)
+
+#### `/todos resume`
+
+Show an interactive menu of available TODO lists with their current progress status. Selecting a todo list will load the list back into your chat session, allowing Q to continue where it left off.
+
+#### `/clear-finished`
+
+Remove all completed TODO lists from storage. This helps clean up your workspace by removing lists where all tasks have been completed.
+
+#### `/todos delete [--all]`
+
+Delete specific TODO lists or all lists at once.
+
+`q chat todos delete` # Interactive selection to delete one list
+`q chat todos delete --all` # Delete all TODO lists
+
+**Options:**
+- `--all` - Delete all TODO lists without interactive selection
+
+## Storage
+
+TODO lists are stored locally in `.amazonq/cli-todo-lists/` directory within your current working directory. Each list is saved as a JSON file with:
+
+- Unique timestamp-based ID
+- Task descriptions and completion status  
+- Context updates from completed tasks
+- Modified file paths
+- Overall list description
+
+#### Interactive Selection
+
+All commands use interactive selection allowing you to:
+- Navigate with arrow keys
+- Press Enter to select
+- Press Esc to cancel
+
+## Best Practices
+
+#### Managing Lists
+
+- Use `clear-finished` regularly to remove completed lists
+- Resume lists to continue complex multi-step tasks
+- View lists to check progress without resuming
+
+#### Workflow Integration
+
+- Let Q create TODO lists for complex tasks automatically
+- Use `resume` to pick up where you left off in previous sessions
+- Check `view` to see what tasks remain before resuming work
+
+#### TODO List Storage
+
+- Lists are stored in current working directory only
+- No automatic cleanup of old lists
+- No cross-directory list sharing
+
+## Troubleshooting
+
+#### No Lists Available
+
+If commands show "No to-do lists available":
+
+1. **Check directory**: Ensure you're in the directory where lists were created
+2. **Verify storage**: Look for `.amazonq/cli-todo-lists/` directory
+3. **Create lists**: Use chat sessions to create new TODO lists
+
+#### Lists Not Loading
+
+If lists exist but won't load:
+
+1. **Check permissions**: Ensure read access to `.amazonq/cli-todo-lists/`
+2. **Verify format**: Lists should be valid JSON files
+3. **Check file integrity**: Corrupted files may prevent loading