note_turn
Record a diagnostic step's observation, conclusion, next action, and owner in the case brief to prevent stale handoffs.
Instructions
Record one diagnostic step: observed = what was seen, in your words or quoted, conclusion = what you concluded, ruled out, or propose next. Both are stored as the note — your account, not evidence. Machine output that grounds it goes in add_evidence verbatim first, then cite it in evidence_ids. kind (required) = change(바꿈: code/screen/config changed) · verified(확인: test/prod/repro confirmed) · finding(발견: measured or found out, a fact) · thought(생각: proposal/hypothesis/judgment — can be overturned); if two apply, split into two notes. next (required) = after this turn, what happens next, and owner (required) = whose turn it is: "user" (the engineer must act), "watch" (nothing to do, only watching), or an agent name such as "codex" / "claude". Say next EVERY turn, even when nothing changed — if it is the same line as before, nothing new is written, so this costs you a sentence and keeps the thread honest. A stale next is the failure this product exists to prevent: the next session reads it and goes off to do work that is already done. Updates the case brief. Call at the end of each step, not every message. Refused once 15 turns have piled up since the thread's focus was last declared: re-declare the focus if it is still the same work, or open_thread for the new subject. evidence_ids (optional) = the evidence numbers this conclusion rests on — cite them here, not in the text; the screen renders them as links. observed_from = "machine" (tool output, tests, diffs, files) or "user" (the engineer's words) — required; when "user", source_refs is required too (the id from the prompt's "casebook source_ref: " line, or on a chat client the id add_utterance returns) A next owned by the user is written TO the engineer ('Decide X'), never about them ('The user decides X'). FIRST LINE = TITLE: at most 120 columns (CJK counts as 2), no ' — ' joiner, and no record numbers (#517, D15635, 확장 122호, turn 80, commit hashes) — a person reads that line on the screen; put the rest after a blank line as the body. The paragraph right under the title is read on the screen too, so no record numbers there either; they go in a later paragraph or evidence_ids (the server refuses otherwise).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"case_id": "<case_id>",
"observed": "<observed>",
"conclusion": "<conclusion>",
"kind": "<kind>",
"next": "<next>",
"owner": "<owner>"
},
"name": "note_turn"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| next | Yes | ||
| owner | Yes | ||
| client | No | ||
| capture | No | ||
| case_id | Yes | ||
| observed | Yes | ||
| conclusion | Yes | ||
| source_refs | No | ||
| evidence_ids | No | ||
| observed_from | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |