From c188b36d95951f543bc091e3c60801bc4e24a6ff Mon Sep 17 00:00:00 2001 From: Alan Silva Date: Wed, 4 Nov 2026 13:12:21 +0000 Subject: [PATCH] Skill practices: quiet test wrappers, targeted diffs and file ranges, grep logs, batch tool calls --- internal/author/skill/references/practices.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/internal/author/skill/references/practices.md b/internal/author/skill/references/practices.md index dd111dc1..e9df5915 100644 --- a/internal/author/skill/references/practices.md +++ b/internal/author/skill/references/practices.md @@ -62,8 +62,19 @@ below (errors block publishing; warnings print and do not). ## Commands and scope -- **Quiet commands**: summary flags, `git diff --stat` before a full diff, - `grep`/`glob` before `read`, read file ranges rather than whole files, tail or - filter long logs, never print generated or vendored files. +Every earlier tool result is re-sent on each later model call, so output a stage +reads once is paid for on every call after it. + +- **Quiet commands**: use the project's quiet/summary test or analyze wrapper + (failures only plus a log path) and summary flags; never print generated or + vendored files. +- **Diffs**: `git diff --stat` or `--name-only` first, then `git diff -- ` + only for the files you need. Never a full diff or `git log -p`. +- **Files**: `grep`/`glob` first, then read only the relevant line range. Read a + whole file only when it is short or mostly being edited, and do not re-read a + file that has not changed. +- **Logs**: when a test log is needed, grep the log path for the failing test + instead of reading the log whole. +- **Batch independent tool calls** into one step instead of one call per step. - **Small task scope**: one independently testable change per run (roughly a 10–15 minute change). Split larger work into several runs in parallel.