The Graph Canvas As A REPL: Un-Blinding The Agent
Why the explorer renders a query and not a graph, and what it is still missing.
team/humans/dinis_cruz/briefs/08/02/vault-as-substrate/v0.33.55__arch-brief__sg-send-graph-canvas-repl-un-blinding-the-agent-mermaid-for-output-never-render-whole-graph.md
Commitb561fa6b14 · carried 23 August 2026
LicenceApache-2.0 (repository) · CC BY 4.0 stated in the file
Bytes21,822 · 3,471 words · SHA-256 071096e05005f64a
Dated2 August 2026
Why it is here
The problem this names is one every agent-assisted session has and few people say out loud: the agent works blind while the person works slowly, on the same object. A canvas fixes half of that. Feeding the rendered result back to the agent fixes the other half. What makes it a REPL rather than a viewer is the three requirements it lists, a fast cycle, inspectable state and non-destructive exploration, and this site's explorer currently has two of the three.
What it says
- The real problem is that the agent works blind while the person works slowly, on the same object.
- A REPL requires a fast cycle, inspectable state and non-destructive exploration.
- The recorded session is already the specification: the brief is the operation sequence plus a sentence of intent.
- Operations should be a closed vocabulary in the established node and edge grammar, and anything it cannot express is a real gap in the model.
- Never render the whole graph: render the result of a query.
- Text diagrams are wrong for the canvas and right for the output, being diffable, committable and readable by both people and agents.
Worth re-reading for. Claim 7 is the one to steal: what your operation vocabulary cannot express is a finding about your model, not a missing feature.
Where this document lands on the site
The document is the peak. Below it hang the concepts measured in its text and the places on this site that rest on it — and the two are different kinds of link, drawn differently: a measured edge is dashed and carries its count, an authored edge is solid. The method is stated in full on the hub.