atlas-session-lifecycle

Maintains continuous session state across Claude Code invocations by serializing and deserializing session metadata (context, conversation history, project state) to a persistent storage backend. Implements a state machine pattern that tracks session lifecycle phases (initialization, active, reconciliation, archival) and enables resumption of interrupted workflows without context loss. Uses file-based or database-backed storage to decouple session data from ephemeral Claude Code runtime.

Establishes and maintains a semantic 'soul purpose' — a structured representation of the project's intent, goals, and guiding principles — that persists across session boundaries. Captures initial project context (user intent, success criteria, constraints) during session initialization and uses this as a reference frame for all subsequent Claude Code decisions. Implements a purpose-tracking mechanism that validates ongoing work against the original intent, enabling drift detection and course correction.

Implements a reconciliation phase that runs between session boundaries to detect, surface, and resolve conflicts between accumulated session state, user intent, and external project changes. Uses a three-way merge pattern (original soul purpose, accumulated session state, current project state) to identify divergences and generate reconciliation reports. Provides structured conflict metadata (type, severity, resolution options) to guide user decision-making without forcing automatic resolution.

Extracts structured knowledge artifacts from completed or paused sessions, including decision logs, learned patterns, code patterns, and lessons learned. Implements an automated harvest phase that analyzes session conversation history and code changes to identify reusable insights, anti-patterns, and decision rationale. Stores harvested knowledge in a queryable format (embeddings, structured metadata) for retrieval in future sessions or projects.

Implements a structured archival phase that compresses, indexes, and stores completed sessions for long-term retention and historical analysis. Uses a hierarchical storage strategy (hot/warm/cold tiers) to optimize retrieval latency and storage costs based on access patterns. Provides full-text and semantic search over archived sessions, enabling historical analysis, pattern discovery across multiple sessions, and audit trails.

Provides a plugin interface for Claude Code that hooks into the session lifecycle at key phases (initialization, reconciliation, harvest, archival). Implements a callback-based architecture where lifecycle events trigger registered handlers, enabling extensibility without modifying core session logic. Handles Claude Code API integration, context injection, and response interception to transparently manage session state within the Claude Code runtime.

Automatically injects session context (soul purpose, prior decisions, harvested knowledge) into Claude Code prompts to provide semantic grounding for responses. Implements a context-aware prompt augmentation system that selects relevant context based on the current task, avoiding context bloat while ensuring critical information is available. Uses embeddings or semantic similarity to rank context relevance and truncate to token budgets.

Maintains a version history of session state snapshots, enabling rollback to prior states if decisions prove problematic or if the user wants to explore alternative paths. Implements a branching model where sessions can fork into alternative timelines, each with independent state evolution. Provides diff/comparison tools to understand what changed between versions and decision logs explaining why changes were made.

Enables seamless continuation of projects across multiple Claude Code sessions by automatically loading and restoring prior session state, soul purpose, and learned patterns. Implements a session chain mechanism where each new session inherits context from prior sessions, with explicit handoff points where the user can review and approve context carryover. Detects when a new session is related to a prior project and automatically loads relevant context.

Automatically captures Claude Code's decision-making process, including the reasoning behind code changes, architectural choices, and trade-offs considered. Implements a structured logging system that records not just what Claude Code did, but why it made those decisions, enabling future sessions to understand and learn from prior choices. Stores decision logs in a queryable format (JSON/embeddings) for retrieval and analysis.