Write a decision into the record
write_noteAppends one cell to a run's or a dataset's decision record — why a source was chosen, what a check found, what you changed and why. The record is append-only and is what a reader sees beside the data. Write one for every decision worth explaining. Example: {"run_id": "…", "heading": "Dropped the 2019 station file", "markdown": "The 2019 export repeats each hour twice; the API covers the same range cleanly, so the recipe reads the API for every year.", "phase": "acquire"}. Exactly one of run_id or dataset_id. Reusing a cell_id revises that cell in place. Returns {cell_id, sequence}. Costs nothing and builds nothing.
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": {
"heading": "<heading>",
"markdown": "<markdown>"
},
"name": "write_note"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phase | No | ||
| blocks | No | ||
| run_id | No | ||
| cell_id | No | ||
| heading | Yes | ||
| markdown | Yes | ||
| dataset_id | No | ||
| revision_of | No | ||
| checkpoint_seq | No |