Pass unfinished work forward
arroway_passCall this when you STOP with the task unfinished — out of time, blocked, or told to stop. It leaves a HANDOFF: the in-flight state of open work, served at the top of every read of this project until someone takes it and closes it. It does not replace the log: a COMPLETED task still ends in arroway_log; this exists for the one you could not complete. ALWAYS write the authored essence too: it is the default in-flight state served in reads. An older, frozen catalog that truly has no essence field may still pass the full state; Arroway marks it as pending a reviewable essence proposal, never as if one had been authored. Deliberate only — never a dump of the session: write exactly what the next session needs to continue without redoing or re-deriving anything. A handoff never expires by clock: it dies in exactly three ways — closed with arroway_close, replaced by another pass naming it as superseded, or discarded by a person in the panel. Age is reported in the read as information; it never removes anything.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| card | No | Pointer to the living tracker for this work (card id, issue, PR), when one exists. | |
| essence | No | One authored line that states the operative in-flight state. This is the default read; the full handoff remains recoverable by handle. | |
| project | Yes | ||
| next_step | Yes | The single concrete next step. Not a plan: the step. | |
| open_risk | No | The risk left open — what could bite whoever continues. | |
| supersedes | No | #handle of the OPEN handoff this one replaces, from a read. Replacement is explicit by reference, never guessed from titles. | |
| do_not_redo | No | What is already done, verified or decided that the next session must NOT redo or re-litigate. | |
| addressed_to | No | Optional name of a person or routine this is meant for. A visible convention, never a lock: everyone still sees it, and the read says who may take it. | |
| read_handles | No | The reading list the next session needs: #handles of the memories, log entries and handoffs — of THIS project — that whoever continues must read in full. You know what you had to read to get here; naming it spares them rediscovering it. Order is kept as you write it. At most 10 unique references, and going over is refused rather than trimmed, because each one comes back in full body. Only what is genuinely required to continue: a handle merely cited in do_not_redo is history, not required reading, and is not picked up from the text — it counts only if you name it here. | |
| where_stopped | Yes | Where the work stands right now — what is done and verified, what is half-done. |