docs: Update experiment docs to contain todo lists (#2791)

Author: kiran-garre

docs/built-in-tools.md

@@ -110,19 +110,19 @@ Opens the browser to a pre-filled GitHub issue template to report chat issues, b
 
 This tool has no configuration options.
 
-## Knowledge Tool
+## Knowledge Tool (experimental)
 
 Store and retrieve information in a knowledge base across chat sessions. Provides semantic search capabilities for files, directories, and text content.
 
 This tool has no configuration options.
 
-## Thinking Tool
+## Thinking Tool (experimental)
 
 An internal reasoning mechanism that improves the quality of complex tasks by breaking them down into atomic actions.
 
 This tool has no configuration options.
 
-## Todo_list Tool
+## TODO List Tool (experimental)
 
 Create and manage TODO lists for tracking multi-step tasks. Lists are stored locally in `.amazonq/cli-todo-lists/`.
 

docs/experiments.md

@@ -58,6 +58,28 @@ Amazon Q CLI includes experimental features that can be toggled on/off using the
 
 **When enabled:** Use `/tangent` or the keyboard shortcut to create a checkpoint and explore tangential topics. Use the same command to return to your main conversation.
 
+### TODO Lists
+**Tool name**: `todo_list`
+**Command:** `/todos`  
+**Description:** Enables Q to create and modify TODO lists using the `todo_list` tool and the user to view and manage existing TODO lists using `/todos`.
+
+**Features:**
+- Q will automatically make TODO lists when appropriate or when asked
+- View, manage, and delete TODOs using `/todos`
+- Resume existing TODO lists stored in `.amazonq/cli-todo-lists`
+
+**Usage:**
+```
+/todos clear-finished       # Delete completed TODOs in your working directory
+/todos resume               # Select and resume an existing TODO list
+/todos view                 # Select and view and existing TODO list
+/todos delete               # Select and delete an existing TODO list
+```
+
+**Settings:**
+- `chat.enableTodoList` - Enable/disable TODO list functionality (boolean)
+
+
 ## Managing Experiments
 
 Use the `/experiment` command to toggle experimental features:
@@ -84,11 +106,13 @@ These features are provided to gather feedback and test new capabilities. Please
 All experimental commands are available in the fuzzy search (Ctrl+S):
 - `/experiment` - Manage experimental features
 - `/knowledge` - Knowledge base commands (when enabled)
+- `/todos` - User-controlled TODO list commands (when enabled)
 
 ## Settings Integration
 
 Experiments are stored as settings and persist across sessions:
 - `EnabledKnowledge` - Knowledge experiment state
 - `EnabledThinking` - Thinking experiment state
+- `EnabledTodoList` - TODO list experiment state
 
 You can also manage these through the settings system if needed.