Skip to content

Finish a session

A session is complete only when its durable result is understandable without the original conversation.

Code work

  1. Run the relevant tests.
  2. Commit reproducible code changes in Git.
  3. Update the task with the current expected_version.
  4. Include the repository, branch, base commit, result commit, tests, completed work, next step, and blockers in the work receipt.
  5. Confirm the task with task_get.

Non-code work

Record the durable decision, fact, proposal, or open topic in the correct memory form. Keep proposed recommendations separate from accepted decisions.

Safe retry

If a write response is lost, do not blindly repeat it:

  • re-read the task before retrying task_update;
  • reuse an idempotency key for a retried memory_add or task_create;
  • do not append the same work receipt twice.

Never put credentials, tokens, full transcripts, or repository contents into HeyAira.