context-preservation

Enforce checkpoint-based context preservation across multi-wave Shannon projects.

2|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon-framework --skill context-preservation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-preservation
Source: https://github.com/krzemienski/shannon-framework/tree/main/skills/context-preservation
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill context-preservation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires serena, and includes references (resource) components.

What problem does it solve?

Protocol for preserving context across sessions using Serena MCP, with automatic checkpoints and restoration.

Core Features & Use Cases

  • Automatic and manual checkpointing
  • Rich metadata collection for restorable state
  • Serena MCP persistence for cross-session recovery
  • Wave coordination with checkpoints

Quick Start

Enable mandatory checkpoints at wave boundaries and via PreCompact hooks to ensure zero context loss.

Frequently Asked Questions about context-preservation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preserve context across sessions in multi-wave projects?

Context preservation uses checkpoint-based session resilience to save your project state at wave boundaries, during emergency saves, and on explicit checkpoints. Serena MCP persists this metadata across sessions, enabling full restoration of goals, tests, files, and progress without loss.

When should I create checkpoints in a Shannon project workflow?

Create checkpoints at wave transitions, during PreCompact emergency saves, via explicit /shannon:checkpoint commands, and at session end. Automatic triggers ensure zero context loss at critical points, while manual checkpoints let you mark custom restore points.

What metadata does checkpoint-based context preservation collect?

Context preservation collects structured metadata including project goals, completed and pending waves, test results, file state, and session markers. This rich dataset enables accurate restoration and prevents rationalization drift across session boundaries.

Can I restore a previous checkpoint after closing a session?

Yes. Serena MCP persists all checkpoints with unique IDs, enabling restoration workflows that recover your exact project state—goals, waves, tests, and files—from any saved checkpoint after session end or interruption.

What is the difference between automatic and manual checkpoints?

Automatic checkpoints trigger at wave boundaries and PreCompact events without user action, ensuring baseline protection. Manual checkpoints via /shannon:checkpoint let you mark custom restore points. Both integrate with Serena MCP for persistent cross-session recovery.