Update docs for introspect

Author: kiran-garre

crates/chat-cli/src/cli/chat/tools/introspect.rs

@@ -62,6 +62,9 @@ impl Introspect {
         documentation.push_str("\n\n--- docs/agent-file-locations.md ---\n");
         documentation.push_str(include_str!("../../../../../../docs/agent-file-locations.md"));
 
+        documentation.push_str("\n\n--- docs/todo-lists.md ---\n");
+        documentation.push_str(include_str!("../../../../../../docs/todo-lists.md"));
+
         documentation.push_str("\n\n--- CONTRIBUTING.md ---\n");
         documentation.push_str(include_str!("../../../../../../CONTRIBUTING.md"));
 
@@ -93,6 +96,8 @@ impl Introspect {
         documentation
             .push_str("• Experiments: https://github.com/aws/amazon-q-developer-cli/blob/main/docs/experiments.md\n");
         documentation.push_str("• Agent File Locations: https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-file-locations.md\n");
+        documentation
+            .push_str("• Todo Lists: https://github.com/aws/amazon-q-developer-cli/blob/main/docs/todo-lists.md\n");
         documentation
             .push_str("• Contributing: https://github.com/aws/amazon-q-developer-cli/blob/main/CONTRIBUTING.md\n");
 

docs/todo-lists.md

@@ -92,6 +92,13 @@ If lists exist but won't load:
 2. **Verify format**: Lists should be valid JSON files
 3. **Check file integrity**: Corrupted files may prevent loading
 
+## `todo_list` vs. `/todos`
+The `todo_list` tool is specifically for the model to call. The model is allowed to create TODO lists, mark tasks as complete, add/remove
+tasks, load TODO lists with a given ID (which are automatically provided when resuming TODO lists), and search for existing TODO lists.
+
+The `/todos` command is for the user to manage existing TODO lists created by the model. The user can view, resume, and delete TODO lists
+by using the appropriate subcommand and selecting the TODO list to perform the action on.
+
 ## Examples
 #### Asking Q to make a TODO list:
 ```
@@ -109,7 +116,7 @@ If lists exist but won't load:
  ● Completed in 0.4s
 ```
 
-#### Selecting a TODO list to view
+#### Selecting a TODO list to view:
 ```
 > /todos view
 
@@ -118,7 +125,7 @@ If lists exist but won't load:
   ✔ Completed todo list (3/3)
 ```
 
-#### Resuming a TODO list (after selecting)
+#### Resuming a TODO list (after selecting):
 ```
 > /todos resume