The fastest steering in 1DesignTool isn't written — it's pointed at. Comment mode turns the live preview into a mark-up surface: ⌥-click an element, type a note, and the pin lands on the exact node the agent will edit.
Comment mode
The Comment mode button in the preview rail toggles the surface on. From there:
- ⌥-hover — highlights the element under the cursor, so you can see exactly which node the pin will land on before you commit
- ⌥-click — drops a numbered pin on that element
- Draw — drag across a region to mark an area instead of a single node
- Click a pin — open it to write or edit its comment
Pins land in the Comments panel that slides in beside the preview — each shows its number, its selector, and its note. The counter on the button tracks how many pins are waiting.
Send the notes to the agent
Write a comment on each pin — "tighten this headline, two lines max", "this should feel secondary" — then hit Send N new comments to agent. The notes ride into the next turn folded onto the exact elements, so the agent edits the node you meant, not the thing it guessed you meant.
One pin already resolved? Send only what's new — the panel counts the unsent notes. After the fix lands, resolve or clear the pins so the next turn isn't re-reading stale marks.
What makes a good comment
Same rules as a good brief, smaller: name the change, not the mechanism. "Make this feel secondary" beats "reduce to 14px #999" — the design kit owns the tokens, so a direction applied consistently beats a value that fights the rest of the system. One issue per pin; if two things are wrong, drop two pins.
Tip: When a fix is about spacing or alignment, draw the region instead of picking a node — the marked area tells the agent which elements you mean by where they sit, which survives ambiguous markup better than a selector.
Where pins live
Pins are attached to the project's state, not the transient preview — they survive the run that fixes them, and they show up in the next brief until resolved. Deleting a project clears them with it; restoring an earlier state brings back that state's pins.