session-chapter

What problem does it solve?

This Skill prevents long Claude Code sessions from losing progress by capturing layered “chapter” state (task, next steps, decisions, and blockers) before context compression, then enabling seamless restoration in a new window with clean context.

Core Features & Use Cases

• Chapter checkpointing: Diagnoses context pressure, captures task stage, artifacts, and token usage into structured files under .omc/chapters/.
• Decision event sourcing: Appends an immutable decisions.md log to preserve the full reasoning chain across windows.
• Priority Context restoration: Writes the current chapter summary into Priority Context via /notepad_write_priority so SessionStart can auto-inject it on new windows.
• Compression strategy selection: Chooses between /rewind (targeted summarization), /compact with a custom instruction, or skipping compression when context is already extremely high.
• Recovery pathways: Supports restoring via a clean new window (recommended), a structured /chapter_resume flow from chapter files, or a fallback claude --resume UUID flow.

Quick Start

When you notice the context is getting full or you want to pause and continue in a new window, run the session-chapter workflow and then start a clean new window via cd [project path] && claude to get automatic Priority Context injection.