Skip to content

turn-status-marker

Turn Status Marker — Say How the Turn Ended

Section titled “Turn Status Marker — Say How the Turn Ended”

End the final user-facing reply of every turn with, on its own line:

[t1k:turn-status state=<finished|needs-you|unfinished>]
  • finished — complete and verified (a PR is merged, not just opened).
  • needs-you — ended on a decision, credential, approval or manual step only the user can give (incl. a question in prose); an optional item is no blocker — record it as a task.
  • unfinished — work remains the session itself could continue (stuck CI, failed step, ended budget, watcher not started).

Precedence: needs-you > unfinished > finished. One marker per final reply, never in progress messages, sub-agent reports or SendMessage. Optional summary="<≤80 chars>", reason="<≤60 chars>". Detail: docs/turn-status-marker.md.

Open-work tasks. A turn ending with its OWN work open records each item with TaskCreate BEFORE the final reply (You: = user step), no printed list. Others’ items (peer reports) are never recorded. Background work still live at turn end is unfinished, never finished. remaining-work-stop.cjs blocks once if none, agents running or not; a prose list is a violation too. The hook sweeps every pending task, even with an agent running: fan out one agent per self-continuable one (set it in_progress), babysat to merged and released; tag gated ones Gate:/(blocked: why) and keep them pending (in_progress = being worked now). A background Agent/Workflow you spawn for a unit of work gets its own task in the SAME turn (in_progress, subject naming the lane), completed only once the unit is merged or verified, not when its report arrives; orchestrator only, sub-agents never create your tasks ([t1k:agent-task-gap] nudges, docs/agent-task-visibility.md). [t1k:stale-task] names in_progress tasks untouched for 2 h: completed if the lane merged, else pending + Gate:. Detail: docs/turn-status-marker.md.