initial-prompt.md
c10. Guide Walk
Opened 2026-11-13 from the session that ran the guide walk (Mark as an evaluator new to Qpoint, a Claude Code session as the evaluator's agent, driving the app's guide MCP server). The report is cycles/notes/2026-11-13-guide-agent-walk.md, with its captures beside it. The task as handed to this cycle's session:
Work through the report at
cycles/notes/2026-11-13-guide-agent-walk.md(captures beside it), in its order.
- The agent view (item 1): a view state of its own, not
minimized, where the tour panel is hidden and the focus still draws — ring, dim/blur scrim, the agent'spointcallout and the step's callouts. Todayset-view { minimized: true }turns the focus off andstart()resetsminimized. Make it the default while an agent drives (lastMove.by == "agent"), keep it across step moves, bring the panel back on the person's own move, give free-formpoint(no tour) the same focus, and update the server instructions incrates/app/src/guide/.- Callouts (1a, 1b): a row's callout points at its ringed row and keeps clear of neighbouring rows' key column, of another callout, and of the page's own text; more inner padding (tokens, not px literals).
- The data source (1c):
tour-stateandread-stepcarry the source in effect, the instructions tell agents to check it before saying "yours", a learn tour on synthetic data says so in its panel,explainknows "synthetic".- The guide's words (1d, 1e): region text in the columns' own words and carrying source/harnesses;
explainentries for the inventory columns, "sanctioned", "denied", and what this app does and doesn't judge.- Arguments (2), region text (3: panel leak, empty, truncated, labels, windows, plural) and the Help page's connect line (4). Item 5 is a design call — list it for Mark, don't build it.
Done = each item fixed or answered in the report (add an "Outcome" line under each), a story or headless test per view and callout change, captures of the agent view (panel hidden, focus drawn) and of a row callout placed correctly, and a review stop for Mark with what to look at.
Mark's ruling behind item 1, from the walk: "what feels natural when you're driving is to hide the tour guide panel unless you're writing that content to show something in particular. Otherwise, I just want to see what you're highlighting on the page and what your callout is saying about it." And: "when you hide that, we lose the nice highlighting background blurring."
Create a plan, ask any clarifying questions, suggest patterns I may not be considering.