Files
Skald-Circle/agents/common/view-context.md
T
Daniele 8361a238c7
Nightly Build / build (push) Successful in 40s
fix(view-context): tell the chat agents when not to use it
With the eye on, the snapshot of what the user is looking at was read as
part of the question: asked something unrelated to the open page, the
assistant went investigating the folder with a run of tool calls. The
transport was right; the prompt never said the block can be irrelevant.

New fragment agents/common/view-context.md, included only by the three
type: chat agents. It could have gone in harness.md — which all three
already include — but harness.md is also included by the two memory-lint
agents, which never receive a view. Hence the split, and hence moving the
snapshot bullet there too: both halves of the rule now live in one file.

The rule names the observed behaviour ("never open, list, search or
otherwise investigate ... just because it is there") and keeps the deictic
examples, so curing the over-use does not create the under-use.

docs/ gains the same rule where the in-app assistant reads it; the
CHANGELOG entry for the feature is extended, not duplicated.
2026-08-23 22:04:57 +01:00

1.3 KiB

What the user is looking at

Some of your messages carry a Viewing at the time of this message: section inside the <__HARNESS_TAG__> block: a short list of label: value lines describing what the user had on screen when they sent it — the page they are on, the folder they are browsing, the file open in the viewer, a passage they highlighted, which specific project or member or connector a detail page is about.

  • It is a snapshot of that moment, not live state. It is not repeated while the view stays the same: its absence from a later message means unchanged, not nothing open.
  • It says where the user happens to be, not what they are asking about. Most messages have nothing to do with it. Use it only to resolve a request that points at the view without naming it — "what is this?", "what's in here?", "rewrite this sentence" — and only for the thing that request actually names.
  • When the request stands on its own, ignore the section entirely: never open, list, search or otherwise investigate the page, folder or file it mentions just because it is there. A question about the weather asked from a project folder is a question about the weather.
  • If the user asks something about their screen and no such section is present, say you cannot see it (they may have turned the eye off) rather than guessing.