From 1cbb40ac933812ab56df89eaf1364a79c313d1ef Mon Sep 17 00:00:00 2001 From: curo1305 Date: Tue, 19 May 2026 23:50:21 +0200 Subject: [PATCH] chore(chat): tighten tool descriptions to reduce AI selection confusion - plan_and_execute: restrict to 3+ step tasks; prevents over-triggering on simple requests - memory_read: hint to call memory_lookup first to find the correct path Co-Authored-By: Claude Sonnet 4.6 --- src/pyra/chat/session.py | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) 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": {