Writing

AI Notes

An AI note is an instruction you leave in the document for your AI agent to address the next time it works on the file. Notes are for agents; comments for people are covered in Comments.

Adding a note

Press the ✦ Note to AI button in the floating toolbar, or use Review > Insert AI Note. A "Note to AI" dialog opens with quick-select presets and an instruction field. Confirm, and the note appears in your document.

What it looks like

The noted section gets a highlight and a small label carrying your instruction. The label has three controls: Send it to your agent now, edit the instruction in place, or remove the note.

How notes are stored

Under the hood, a note is a pair of HTML comment markers around the text it applies to:

<!-- ai-note: tighten this paragraph -->
The text the note applies to.
<!-- /ai-note -->

Agents can read these markers in the plain markdown file. Other markdown tools ignore them, so your document stays portable.

How notes get resolved

When your agent addresses a note, it applies the edit and removes the markers. Stet captures that as a single reviewable change, shown as a ✦ resolution pill: your instruction and the agent's edit together, one accept or reject.

Sending notes automatically

The Send button runs your configured hook command for the file. With the per-folder Hooks setting turned on, confirming a note fires the command automatically. See Working with AI for setup.