Add explicit WRONG→CORRECT substitution table to bash.md and read-over-bash
critical section to read.md. These concrete examples help models like
Gemini 3.1 Pro select specialized tools (read, grep, find, write, edit)
instead of defaulting to bash for file operations.
Changes:
- bash.md: Add 9-row substitution table inside <critical> showing exact
tool calls to use instead of common bash patterns; add 2>/dev/null
to the banned stderr patterns
- read.md: Add <critical> section emphasizing read over cat/head/tail/ls
and requiring the path parameter (prevents empty {} calls)
Validated via GEPA optimization + live A/B testing with Gemini 3.1 Pro:
v13.2.1 (latest): Baseline avg 0.694 → PR avg 0.894 (+0.200)
grep_pattern: 0.000 → 0.938 (+0.938)
multi_tool_workflow: 0.000 → 0.955 (+0.955)
find_files: 0.795 → 0.983 (+0.188)
grep_and_read: 0.618 → 0.858 (+0.240)
Wins 4 / Ties 3 / Losses 3
v13.1.1: Baseline avg 0.799 → PR avg 0.884 (+0.085)
Wins 5 / Ties 3 / Losses 2
@oh-my-pi/pi-coding-agent
Core implementation package for the omp coding agent in the oh-my-pi monorepo.
For installation, setup, provider configuration, model roles, slash commands, and full CLI reference, see:
Package-specific references: