Merge pull request #7303 from deepseek-harness/fix/read-guidance-line-ranges

fix(prompt): name line ranges and shell readers in the read guidance
2026-11-09 20:07:43 +08:00 · 2026-11-02 16:57:54 +08:00
parent 36a0cab333 ec587a015d
commit fdff707b82
104 changed files with 211 additions and 119 deletions
@@ -12,8 +12,8 @@
  en: 47b44ed9313c2ccf
  zh: 7ad254f8ef88351d
 /agent-note-subagent-end-turn-guidance-stays-in-the-delegation-paragraph/alternatives-considered:
-  en: d52fa1af379dea5b
-  zh: 4e404994f7a607dc
+  en: 3153c1e7563a3357
+  zh: 9841db2b0156075b
 /agent-note-subagent-end-turn-guidance-stays-in-the-delegation-paragraph/verification:
  en: be076216381ea64d
  zh: 2da8d9819c20e2fe
@@ -29,7 +29,7 @@ The sentence stays one literal line. Rewording `the next result starts a new tur

 **Move the guidance into the tool description.** The paragraph is assembled from the set of visible delegation tools and lists their names; the tool description describes one tool. Moving the sentence changes ownership without changing the behavior it prevents.

-**Restore every prompt phrase reverted together with this sentence.** The read guidance and the `run_code` argument order are separate decisions with their own evidence; this note records only the delegation paragraph.
+**Restore every prompt phrase reverted together with this sentence.** The read guidance ([2026-10-26 note](2026-10-26-read-guidance-line-ranges.md)) and the `run_code` argument order are separate decisions with their own evidence; this note records only the delegation paragraph.

 ## Verification

@@ -29,7 +29,7 @@ Status: implemented

 **把说明移进工具描述。** 这段指导按可见委派工具集合组装并列出工具名，工具描述只描述单个工具。移动这句会改变归属，但不改变它阻止的行为。

-**把与这句一起被回退的所有提示词都恢复。** read 指导与 `run_code` 参数顺序是各自有证据的独立决定；本记录只覆盖委派段。
+**把与这句一起被回退的所有提示词都恢复。** read 指导（[2026-10-26 note](2026-10-26-read-guidance-line-ranges.zh.md)）与 `run_code` 参数顺序是各自有证据的独立决定；本记录只覆盖委派段。

 ## 验证

@@ -0,0 +1,22 @@
+# Bilingual-pair consistency record for 2026-10-26-read-guidance-line-ranges.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write .agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md
+/agent-note-read-guidance-names-shell-readers-and-line-ranges:
+  en: 1926710614598539
+  zh: b0106d4a6a2d648d
+/agent-note-read-guidance-names-shell-readers-and-line-ranges/problem:
+  en: 4189d516419d8d12
+  zh: 30d8496064dd44e3
+/agent-note-read-guidance-names-shell-readers-and-line-ranges/decision:
+  en: 34f18307f7ad87af
+  zh: 21c466c6ce6c598d
+/agent-note-read-guidance-names-shell-readers-and-line-ranges/alternatives-considered:
+  en: aea7ffb1159ab81a
+  zh: 4842ca79dc30654d
+/agent-note-read-guidance-names-shell-readers-and-line-ranges/verification:
+  en: cbc16bfba4abe862
+  zh: 9a71e6c020c01f69
+/agent-note-read-guidance-names-shell-readers-and-line-ranges/consequences:
+  en: cf55161ea197a7a9
+  zh: fa10ca413f8fd726
@@ -0,0 +1,35 @@
+# Agent Note: Read guidance names shell readers and line ranges
+
+Status: implemented
+
+English | [中文](2026-10-26-read-guidance-line-ranges.zh.md)
+
+## Problem
+
+The read guidance named only `cat` as the shell command the read tool replaces, and described `offset`/`limit` as continuing a large file rather than reading a line range. #6057 recorded a long Session reading ranges with `sed -n X,Yp` 60 times. #6054 added `sed`, `head`, `tail`, and the line-range wording; a later prompt revert removed them together with unrelated changes.
+
+The 2026-10-23 evaluation of the SDK profile (native tools, six benchmarks) measured this sentence as the only change: Pass@1 mean −0.03pp and Pass@3 mean +0.70pp over the five benchmarks that report Pass@3 (ProgramBench-New has none) versus the base commit, with mixed step and token deltas (ProgramBench-New −15.5 steps, Terminal-Bench-v4 +13.5 steps). The PTC mode runs did not include this variant; the section renders in every request where `read` is visible.
+
+## Decision
+
+Restore the #6054 wording, byte-identical: `Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.` The read tool and its guidance are owned by `@deepseek-ai/dsh-tool-fs`; write and edit guidance are unchanged.
+
+## Alternatives considered
+
+**Rely on the read tool schema.** The schema already documents `offset` and `limit`, but #6057 shows the model chose `sed` while that schema existed; the guidance is the only model-visible place that names `sed`, `head`, and `tail`.
+
+**Restore every prompt phrase reverted together with this sentence.** The subagent end-turn sentence, the `run_code` argument order, the PTC syntax ownership, and the SDK persona are separate decisions; the first is already restored ([subagent end-turn note](2026-10-21-subagent-end-turn-guidance.md)), and the others carry their own evidence.
+
+**Say "line range" without naming shell commands.** The observed failure was choosing shell commands, so the sentence names them.
+
+## Verification
+
+- `packages/fs/tool-fs/tests/tools.spec.ts` asserts the rendered guidance text.
+- Every recorded `system-prompt*.expected.md` sidecar that renders the read guidance carries the restored sentence: `test:snapshot` replays the session and SDK set, and `pnpm run test:web:ci` replays the `snapshots/web` set (the `node 24 / snapshots and artifacts` lane runs both). Two pinned historical sidecars (`web/cordis-tool-round`, `web/schedule-catalog`) retain their recorded text.
+- The evaluation above measured this single change on the native SDK profile.
+
+## Consequences
+
+- Every request with the read tool carries three more command names and a line-range clause, about 10 tokens.
+- The model is directed to the read tool for line ranges instead of `cat`, `sed`, `head`, or `tail`.
+- The benchmark measured this sentence as neutral; keeping it rests on the #6057 production observation, not on a measured quality gain.
@@ -0,0 +1,35 @@
+# Agent Note: read 指导点名 shell 读取命令与行区间
+
+Status: implemented
+
+[English](2026-10-26-read-guidance-line-ranges.md) | 中文
+
+## 问题
+
+read 指导只把 `cat` 点名为 read 工具替代的 shell 命令，并把 `offset`/`limit` 描述成继续读大文件，而不是读行区间。#6057 记录了一个长 Session 用 `sed -n X,Yp` 读行区间 60 次。#6054 增加了 `sed`、`head`、`tail` 和行区间措辞；后来的一次提示词回退把它们和不相关的改动一起删掉了。
+
+2026-10-23 对 SDK profile（native 工具、六个 benchmark）的评测里，这句是唯一改动：相对 base commit，Pass@1 均值 −0.03pp、Pass@3 均值 +0.70pp（该均值取报告 Pass@3 的五个 benchmark；ProgramBench-New 没有 Pass@3），步数与 token 变化方向不一（ProgramBench-New −15.5 步、Terminal-Bench-v4 +13.5 步）。PTC 模式的运行没有包含这个变体；只要 `read` 可见，这段就会进入每个请求。
+
+## 决策
+
+逐字恢复 #6054 的措辞：`Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.` read 工具及其指导归 `@deepseek-ai/dsh-tool-fs` 所有；write 与 edit 的指导不变。
+
+## 考虑过的替代方案
+
+**只依赖 read 工具 schema。** schema 已经写明 `offset` 与 `limit`，但 #6057 显示在那个 schema 存在时模型仍选择 `sed`；指导是唯一点名 `sed`、`head`、`tail` 的模型可见位置。
+
+**把与这句一起被回退的所有提示词都恢复。** subagent 结束本轮句、`run_code` 参数顺序、PTC 语法归属、SDK persona 是各自独立的决定；第一项已经恢复（[subagent 结束本轮 note](2026-10-21-subagent-end-turn-guidance.zh.md)），其余各有自己的证据。
+
+**只说“行区间”，不点名 shell 命令。** 观测到的失败就是模型选择 shell 命令，所以这句点名它们。
+
+## 验证
+
+- `packages/fs/tool-fs/tests/tools.spec.ts` 断言渲染出的指导文本。
+- 所有渲染 read 指导的 `system-prompt*.expected.md` sidecar 都带有恢复后的句子：`test:snapshot` 回放 session 与 SDK 集合，`pnpm run test:web:ci` 回放 `snapshots/web` 集合（`node 24 / snapshots and artifacts` lane 两条都跑）。两个显式 pin 的历史 sidecar（`web/cordis-tool-round`、`web/schedule-catalog`）保留录制文本。
+- 上面的评测在 native SDK profile 上只改了这一句进行测量。
+
+## 影响
+
+- 只要 read 工具存在，每个请求多三个命令名和一句行区间说明，约 10 token。
+- 模型读行区间时被引导到 read 工具，而不是 `cat`、`sed`、`head`、`tail`。
+- benchmark 上这句测得为中性；保留它依据的是 #6057 的生产观测，而不是测到的质量收益。
@@ -163,7 +163,7 @@ At assembly time, each guidance section checks `ctx.tools.get(name, scope)` and
 ##### Read guidance

 ```markdown
-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.
 ```

 ##### Write guidance
@@ -163,7 +163,7 @@ kind: "package-reference"
 ##### Read 指导

 ```markdown
-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.
 ```

 ##### Write 指导
@@ -71,7 +71,7 @@ export function applyReadTool(ctx: Context, caps: ReadToolCaps): void {
    order: ctx.systemPrompt.getSectionOrder('TOOL_READ'),
    text: ({ scope }) => ctx.tools.get('read', scope) === undefined
      ? ''
-      : 'Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.',
+      : 'Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.',
  })

  ctx.tools.register(defineTool({
@@ -1154,7 +1154,7 @@ async function guidanceScope(ctx: Context) {
 }

 const originalGuidance = {
-  read: 'Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.',
+  read: 'Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.',
  write: 'Read an existing file before overwriting it with write and prefer edit for targeted changes.',
  edit: 'Read a file before editing it unless you just created or edited it in this session.',
 }
@@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -4,7 +4,7 @@ You are a coding agent powered by the deepseek-v4-flash model.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -19,7 +19,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -8,7 +8,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -59,7 +59,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -99,7 +99,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -152,7 +152,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -192,7 +192,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -44,7 +44,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -4,7 +4,7 @@ You are a coding agent powered by the deepseek-v4-flash model.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -4,7 +4,7 @@ Echo where you run.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -4,7 +4,7 @@ You are a coding agent powered by the mock-delegate model.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -4,7 +4,7 @@ You are a coding agent powered by the deepseek-v4-flash model.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -46,7 +46,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -46,7 +46,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -643,7 +643,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -4,7 +4,7 @@ You are a concise snapshot agent.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -46,7 +46,7 @@ Snapshot guidance added after the first read: reply with the single word DONE.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -46,7 +46,7 @@ Snapshot guidance added after the first read: reply with the single word DONE.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -46,7 +46,7 @@ Dynamic tool guidance: call snapshot_ping once, then reply with the single word

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -4,7 +4,7 @@ You are a concise snapshot agent.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -46,7 +46,7 @@ Snapshot guidance added after the first read: call snapshot_ping once, then repl

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -42,7 +42,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -44,7 +44,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too
 Verify your work by running the code or tests. Keep answers brief and factual.


-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too
 Verify your work by running the code or tests. Keep answers brief and factual.


-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 `run_code` is the only tool you can call directly — a tool call naming any other tool fails. Reach every tool the SDK declares below from inside the program.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too
 Verify your work by running the code or tests. Keep answers brief and factual.


-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too
 Verify your work by running the code or tests. Keep answers brief and factual.


-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -2,7 +2,7 @@ You are an AI agent powered by DeepSeek Harness.

 You are a concise snapshot agent.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -46,7 +46,7 @@ Dynamic tool guidance: call snapshot_ping once, then reply with the single word

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -44,7 +44,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -4,7 +4,7 @@ You are a concise snapshot agent.

 Non-zero exits are reported as `[exit code: N]` markers; investigate failures before moving on. On Windows a killed process settles as `[exit code: 1]` without a signal marker; treat a bare exit 1 after an interruption as a termination, not a command failure.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -4,7 +4,7 @@ You are a file reviewer. Inspect the requested files and report your findings.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -46,7 +46,7 @@ Snapshot guidance added after the first read: reply with the single word DONE.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -13,7 +13,7 @@ Task changes do not end wait_agent calls, add inbox messages, or start idle agen

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too
 Verify your work by running the code or tests. Keep answers brief and factual.


-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual.

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

@@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths

 Check the [exit code: N] marker on every bash result; investigate failures before moving on.

-Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.
+Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.

 Read an existing file before overwriting it with write and prefer edit for targeted changes.

--- a/Show More
+++ b/Show More