qualia-pause

What problem does it solve?

Capture in-progress development session state and produce a clear handoff so the next collaborator or future session can resume without friction. It prevents lost context, unclear next steps, and scattered notes by consolidating conversation context, recent git activity, and current phase information into a single, discoverable file.

Core Features & Use Cases

• Automatic Handoff File: Generates a .continue-here.md summarizing session accomplishments, in-progress work, next steps, decisions, blockers, and modified files.
• Repository-aware State Capture: Reads planning STATE.md, git status, and recent commits to include precise file and commit context in the handoff.
• State Transition Integration: Stages a WIP commit and calls the harness state transition (state.js) so the framework tracks the paused session consistently.
• Use Case: Pause mid-sprint to hand off to another engineer, save work before a break, or create an audit-friendly snapshot before shifting phases.

Quick Start

Pause the session and save a .continue-here.md with current state, git summary, next steps, and a WIP commit.