--- name: "Session Compaction" description: "Compresses long conversation context, extracting decisions, changes, remaining tasks, and known issues into session-summary.md." --- # Skill: Session Compaction ## 1. Purpose Keep the conversation context window clean and token-efficient across multi-turn sessions by generating and consulting a compressed local state. ## 2. When to Use Mandatory step at the end of any significant coding session or task implementation. ## 3. Preconditions * Writing access to `docs/12-ai/` is available. ## 4. Step-by-Step Checklist 1. Review the conversation transcript or recent actions. 2. Extract the following sections: - **Current Feature**: The name of the feature worked on. - **Decisions Made**: Architectural choices, package additions, or database schema designs. - **Changes Applied**: Files modified, added, or deleted. - **Remaining Work**: What is left to do in subsequent turns. - **Known Issues**: Broken tests, layout problems, or unhandled errors. 3. Write/append this compact summary to `docs/12-ai/session-summary.md`. 4. In the next agent session, read `session-summary.md` first to quickly load context instead of reading the entire historical chat logs.