From 0d2843da423f9aea5d569252b19defc80c4a4ff7 Mon Sep 17 00:00:00 2001
From: Pavlinchen <69079839+Pavlinchen@users.noreply.github.com>
Date: Mon, 15 Jun 2026 14:03:58 +0200
Subject: [PATCH] docs(context_agent): document the 5 missing Deck tools

The context_agent ExApp ships these Deck tools but they are not listed
in the "Currently implemented tools" section. PR nextcloud/context_agent#155
merged the card-comment tools (add/update/delete + list) and a tools.py
audit also surfaced list_board_cards, none of which are documented.

Adds:
  - List the cards on a deck board
  - List the comments on a deck card
  - Add a comment to a deck card
  - Edit a comment on a deck card
  - Delete a comment on a deck card
Signed-off-by: Pavlinchen <69079839+Pavlinchen@users.noreply.github.com>
---
 admin_manual/ai/app_context_agent.rst | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/admin_manual/ai/app_context_agent.rst b/admin_manual/ai/app_context_agent.rst
index b70fe50da27..6ea81d83985 100644
--- a/admin_manual/ai/app_context_agent.rst
+++ b/admin_manual/ai/app_context_agent.rst
@@ -152,13 +152,17 @@ Cookbook tools
 
   * Example prompt: *"Which recipe categories do I have in my cookbook?"*
 
-Deck tools
-~~~~~~~~~~
+Deck tools (require `Deck <https://apps.nextcloud.com/apps/deck>`_)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 * List deck boards
 
   * Example prompt: *"List the deck boards I have access to."*
 
+* List the cards on a deck board
+
+  * Example prompt: *"List the cards on my Personal deck board."*
+
 * Add a new card
 
   * Example prompt: *"Can you add a card with title 'Repair kitchen sink' to my Personal deck board?"*
@@ -175,6 +179,22 @@ Deck tools
 
   * Example prompt: *"Delete the 'Repair kitchen sink' card in my Personal deck board."*
 
+* List the comments on a deck card
+
+  * Example prompt: *"Show the comments on the 'Repair kitchen sink' card in my Personal deck board."*
+
+* Add a comment to a deck card
+
+  * Example prompt: *"Add a comment 'I'll handle this Friday' to 'Repair kitchen sink' in my Personal deck board."*
+
+* Edit a comment on a deck card
+
+  * Example prompt: *"Update my last comment on the 'Repair kitchen sink' card to say 'Moved to Saturday'."*
+
+* Delete a comment on a deck card
+
+  * Example prompt: *"Delete my last comment on the 'Repair kitchen sink' card in my Personal deck board."*
+
 Files tools
 ~~~~~~~~~~~