Better Prompt (#45)

* Enhance report generation and team leader prompts with conditional output rules for empty sections.

* Update .gitignore and configuration for model adjustments; refine query classification prompt

* Enforce max response length in prompts

* Documentazione tool essenziale per il loro utilizzo da parte degli LLM.

* istruzioni chiare sui tool disponibili nei promt degli agenti

* corretto incongruenze nel report generation prompt

* convertito i promt in file markdown

src/app/agents/plan_memory_tool.py

@@ -13,7 +13,9 @@ class PlanMemoryTool(Toolkit):
     def __init__(self):
         self.tasks: list[Task] = []
         Toolkit.__init__(self, # type: ignore[call-arg]
-            instructions="This tool manages an execution plan. Add tasks, get the next pending task, update a task's status (completed, failed) and result, or list all tasks.",
+            instructions="Provides stateful, persistent memory for the Team Leader. " \
+                 "This is your primary to-do list and state tracker. " \
+                 "Use it to create, execute step-by-step, and record the results of your execution plan.",
             tools=[
                 self.add_tasks,
                 self.get_next_pending_task,
@@ -23,7 +25,16 @@ class PlanMemoryTool(Toolkit):
         )
 
     def add_tasks(self, task_names: list[str]) -> str:
-        """Adds multiple new tasks to the plan with 'pending' status."""
+        """
+        Adds one or more new tasks to the execution plan with a 'pending' status.
+        If a task with the same name already exists, it will not be added again.
+
+        Args:
+            task_names (list[str]): A list of descriptive names for the tasks to be added.
+
+        Returns:
+            str: A confirmation message, e.g., "Added 3 new tasks."
+        """
         count = 0
         for name in task_names:
             if not any(t['name'] == name for t in self.tasks):
@@ -32,14 +43,34 @@ class PlanMemoryTool(Toolkit):
         return f"Added {count} new tasks."
 
     def get_next_pending_task(self) -> Task | None:
-        """Retrieves the first task that is still 'pending'."""
+        """
+        Retrieves the *first* task from the plan that is currently in 'pending' status.
+        This is used to fetch the next step in the execution plan.
+
+        Returns:
+            Task | None: A Task object (dict) with 'name', 'status', and 'result' keys,
+                          or None if no tasks are pending.
+        """
         for task in self.tasks:
             if task["status"] == "pending":
                 return task
         return None
 
     def update_task_status(self, task_name: str, status: Literal["completed", "failed"], result: str | None = None) -> str:
-        """Updates the status and result of a specific task by its name."""
+        """
+        Updates the status and result of a specific task, identified by its unique name.
+        This is crucial for tracking the plan's progress after a step is executed.
+
+        Args:
+            task_name (str): The exact name of the task to update (must match one from add_tasks).
+            status (Literal["completed", "failed"]): The new status for the task.
+            result (str | None, optional): An optional string describing the outcome or result
+                                             of the task (e.g., a summary, an error message).
+
+        Returns:
+            str: A confirmation message (e.g., "Task 'Task Name' updated to completed.")
+                 or an error message if the task is not found.
+        """
         for task in self.tasks:
             if task["name"] == task_name:
                 task["status"] = status
@@ -49,7 +80,14 @@ class PlanMemoryTool(Toolkit):
         return f"Error: Task '{task_name}' not found."
 
     def list_all_tasks(self) -> list[str]:
-        """Lists all tasks in the plan with their status and result."""
+        """
+        Lists all tasks currently in the execution plan, along with their status and result.
+        Useful for reviewing the overall plan and progress.
+
+        Returns:
+            list[str]: A list of formatted strings, where each string describes a task
+                       (e.g., "- TaskName: completed (Result: Done.)").
+        """
         if not self.tasks:
             return ["No tasks in the plan."]
         return [f"- {t['name']}: {t['status']} (Result: {t.get('result', 'N/A')})" for t in self.tasks]