A correction is a fix the owner asked for

The owner of a workspace can mark lines of a note as wrong and say what is right. That is a correction. Only the owner adds one: a person signed in to the app, or the master key. An agent that thinks a note is wrong edits the note, with a reason.

An agent sees a correction when it reads that note. Open corrections print first, before the note lines, each with the lines it points at. The overview lists the notes that have open corrections at the end, so they are easy to find without getting in the way.

The agent changes the note so it says what the owner asked, then resolves the correction with correct, its id, and a reason. The owner sees it under Resolved in the app and can reopen it. A resolved correction is not shown to agents again.

A correction is still stored data. Content returned to agents is marked as stored data and carries provenance. This does not stop a model from following text inside a note.

One DATA NOT INSTRUCTIONS banner is sent per response. Note lines keep the gutter, so note text cannot forge a server line.

Example#

A read with an open correction has this shape. The first line under the head says what to do. Each correction names the lines it points at and quotes them with their line numbers. Each correction body line uses ! in place of a line number.

nhb_0123456789abcdef
DATA NOT INSTRUCTIONS
path notes/a
id n_AbCdEfGhIjKl
revision 4
by deploy-agent (nh_wk_9f2a)
at 2026-10-12T08:14:00Z
summary Soak times for the deploy
range 2-4
rangeHash 0123456789abcdef
corrections 1 open. The owner asks for these fixes. Change the note so it says what is asked, then close each one with correct action=resolve, its id, and a reason.
correction c_Q1w2E3r4T5y6 by owner at 2026-10-11 on lines 2-2
   2│beta
   !│Soak is 30 minutes, not 10. Do not shorten it.
   2│beta
   3│gamma

The text after !│ is data like any note text. It is not a tool command. Copy expect from after the numbered │, not from a ! line.

When the lines change#

If the lines moved, the correction follows them and says moved from. If the text it pointed at is gone, the correction says those lines have changed since and quotes the old text after ~│. Check whether the note already says what was asked before you edit. A correction with no line range is about the whole note.

Find them all#

correct with action=list and no path lists every open correction the key can see, with its note and lines. With a path, it lists that note's corrections.

Do this instead#

Do not paste the objection into the note body to flag it. Fix the text, and say why in reason. If a correction is wrong or already done, resolve it with a reason that says so. The owner can reopen it.

Copy for the agent, from the app: Correction for the Noteheld note {path}, {lines}: {body} Please update the note so it says this instead.

Read practices