juanandresgs/claude-ctrl/context-preservation

Context Preservation Skill

Generate structured context summaries when compaction is imminent or requested, ensuring session continuity without information loss.

Output Format (STRICT - NO DEVIATIONS)

### 1. Current Objective & Status
-**Goal**: [Robust, multi-sentence description of what we are building. Include critical details, context, and the "Definition of Done". Do not summarize into a single vague line.]
-**Status**: [Completed | In Progress | Blocked]
-**Immediate Next Step**: [The very next command or code edit required. Be specific.]
 
### 2. Active Context
-**Active Files**:
  -`[Absolute Path]`
  -`[Absolute Path]`
-**Recent Changes**: [Specific descriptions of what *just* changed in the code, referencing specific functions or logic.]
-**Variables/State**: [Key variable names, data structures, or temporary states currently in focus.]
 
### 3. Constraints & Decisions (CRITICAL)
-**Preferences**: [User preferences stated in this session, e.g., "no external deps", "use snake_case"]
-**Discarded Approaches**: [What did we try that failed? Do not repeat these mistakes.]
-**Architectural Rules**: [Patterns we agreed on, e.g., "Service Layer pattern", "DTOs required"]
 
### 4. Continuity Handoff
-"When resuming, the first thing to do is..."

Content Extraction

Section 1: Current Objective & Status

• Extract goal from user's initial request, explicit goal statements, Definition of Done indicators
• Status: Completed (all objectives achieved), In Progress (work ongoing), Blocked (explicit blocker)
• Next step: last in-progress item, last "next I will..." statement, or first pending objective

Section 2: Active Context

• Files touched via Read/Write/Edit operations, prioritized by recency
• ALWAYS use absolute paths (e.g., /Users/turla/Code/project/src/auth.ts)
• Summarize function additions, modifications, deletions with specific names and line refs
• Key variables, data structures, environment variables in focus

Section 3: Constraints & Decisions

• Preferences: "don't use...", "prefer...", "always...", "never..."
• Discarded approaches: failed attempts with reasons
• Architectural rules: pattern agreements, structure decisions, dependency choices

Section 4: Continuity Handoff

• Always begin with "When resuming, the first thing to do is..."
• Must be specific enough for a fresh Claude instance to immediately continue

Anti-Patterns (NEVER DO)

Goal Description

WRONG:

• "Building a feature"
• "Working on authentication"

RIGHT:

• "Building a user authentication system with OAuth2 PKCE flow for the mobile app. The system must support Google and Apple SSO, store refresh tokens securely in the device keychain. Definition of Done: user can complete full login flow, tokens persist across app restarts, logout clears all tokens."

Active Files

WRONG:

• file.ts
• ./src/auth.ts

RIGHT:

• /Users/turla/Code/myproject/src/auth/oauth-handler.ts

Recent Changes

WRONG:

• "Updated the file"
• "Fixed some issues"

RIGHT:

• "Added validateTokenExpiry() function to /Users/turla/Code/myproject/src/auth/token-storage.ts (lines 42-67) that checks JWT expiration. Modified refreshToken() to call this before attempting refresh."

Immediate Next Step

WRONG:

• "Continue working"
• "Finish the implementation"

RIGHT:

• "Run npm test -- --testPathPattern=oauth-handler to verify the new validateTokenExpiry() function works with expired tokens"

Validation Checklist

Section 1

• [ ] Goal is 2+ sentences with Definition of Done
• [ ] Status is exactly: Completed, In Progress, or Blocked
• [ ] Next step is a specific command or edit

Section 2

• [ ] All file paths are absolute (start with /)
• [ ] Recent changes reference specific function/method names

Section 3

• [ ] Discarded approaches explain WHY they were discarded
• [ ] No empty sections (use "None stated this session" if applicable)

Section 4

• [ ] Starts with "When resuming, the first thing to do is..."
• [ ] Contains a specific, actionable instruction