Maintains a running decision log and context state across agent sessions, preventing context loss between clears and session boundaries. Use when: 'starting a new session on an ongoing project', 'context is getting heavy', 'preserve state before clearing', 'create a handoff document', 'pick up where I left off'.
Purpose: Create structured YAML handoff documents that preserve session state -- decisions made, files modified, findings discovered, approaches tried, and concrete next steps -- so that a fresh session can resume work without context loss. Each clear/restart gets a clean context with full signal instead of degraded compacted context.
/clear when context usage is approaching 70%+Each compaction is lossy compression. After several compactions, you are working with degraded context -- key decisions and file paths silently disappear. Clearing and loading the ledger gives a fresh context with full signal from the structured handoff document.
Check for existing handoff folders to maintain session continuity:
ls -td thoughts/shared/handoffs/*/ 2>/dev/null | head -1 | xargs basename
general as the folder namethoughts/shared/handoffs/{session-name}/YYYY-MM-DD_HH-MM_description.yamlGather the following from the current session:
go test ./..., npm test, etc.)Write the ledger using this exact format (field names are parsed by the statusline -- do not rename them):
---