Skip to content

docs(prompt): tighten shell tool usage guidance wording#2737

Merged
tusharmath merged 2 commits intomainfrom
shell-tweaks
Mar 30, 2026
Merged

docs(prompt): tighten shell tool usage guidance wording#2737
tusharmath merged 2 commits intomainfrom
shell-tweaks

Conversation

@tusharmath
Copy link
Copy Markdown
Collaborator

@tusharmath tusharmath commented Mar 29, 2026

Summary

Tighten the wording in the shell tool's usage guidance to use clearer, more directive language that better communicates intent to the model.

Context

The shell tool description contained slightly ambiguous phrasing in two guidance notes. "You do NOT need to use" implies it's optional, while the actual intent is a firm prohibition. Similarly, "Avoid using" is weaker than the intended directive. Stronger, unambiguous language reduces the chance the model will fall back to shell-based file operations when dedicated tools should be used instead.

Changes

  • Changed "you do NOT need to use head, tail, or other truncation commands" → "you should NOT use" to make the prohibition explicit
  • Changed "Avoid using shell with find, grep, cat..." → "Do not use" for consistent, directive tone across all guidance notes

Testing

Snapshot tests updated to reflect the new wording in the rendered tool descriptions.

cargo insta test --accept

@tusharmath tusharmath enabled auto-merge (squash) March 29, 2026 13:45
@tusharmath tusharmath changed the title docs(shell): adjust truncation and shell tool guidance refactor(config): remove Decimal/Percentage newtypes and tighten shell doctor diagnostics Mar 29, 2026
@tusharmath tusharmath changed the title refactor(config): remove Decimal/Percentage newtypes and tighten shell doctor diagnostics docs(shell): tighten shell tool usage guidance wording Mar 30, 2026
@tusharmath tusharmath merged commit 298ef2b into main Mar 30, 2026
11 checks passed
@tusharmath tusharmath deleted the shell-tweaks branch March 30, 2026 03:00
@tusharmath tusharmath added the type: fix Iterations on existing features or infrastructure. label Mar 30, 2026
@tusharmath tusharmath changed the title docs(shell): tighten shell tool usage guidance wording docs(prompt): tighten shell tool usage guidance wording Mar 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: fix Iterations on existing features or infrastructure.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant