session-capture-checklist

Capture session context for handoffs by applying a structured checklist at session end to log errors, discoveries, environment details, blockers, and decisions. This produces a concise handoff summary enabling the next agent to quickly resume work with minimal rework.

Structure session notes for OpenBrain using tagged entries that begin with the task ID. This mandatory tagging preserves traceability across tools and sessions, ensuring future agents can search and understand what happened during the session and why.

Beads notes are updated as part of the session capture checklist by tagging every entry with the current beads task ID. This cross-tool integration ensures consistent knowledge retention and maintains a searchable record of session context, errors, and decisions.

You should capture session context at session end or handoff points, not necessarily after every task. The full checklist records errors, discoveries, environment details, blockers, and decisions, ensuring the next agent can rapidly re-enter the work with low rework.

A structured session handoff should include errors, discoveries, environment details, blockers, decisions, and a concise summary for the next agent. Each item must be tagged with the task ID to preserve traceability across tools and sessions.