diff --git a/src/pyra/chat/session.py b/src/pyra/chat/session.py index 2ea7f5d..d7e98c1 100644 --- a/src/pyra/chat/session.py +++ b/src/pyra/chat/session.py @@ -81,8 +81,9 @@ def start_chat() -> None: name="plan_and_execute", description=( "Decompose a multi-step task into sequential steps and execute each with " - "a focused sub-agent. Use when the request has multiple distinct phases. " - "Specify 'agent' per step to route to a specialized agent." + "a focused sub-agent. Use only for long tasks with 3 or more sequential " + "steps that need verification between them — for simple 2-step tasks, do " + "them directly. Specify 'agent' per step to route to a specialized agent." ), parameters={ "type": "object", @@ -125,7 +126,7 @@ def start_chat() -> None: )) registry.register_builtin(Tool( name="memory_read", - description="Read the full content of a memory file by its relative path (e.g. 'user/profile.md').", + description="Read the full content of a memory file by its relative path (e.g. 'user/profile.md'). Use memory_lookup first to find the correct path.", parameters={ "type": "object", "properties": {