gh-awudevelop-claude-plugins-session/commands/close.md

You are managing a session memory system. The user wants to close and finalize the current session.

CRITICAL - Command Format: All session plugin commands use the /session: prefix. DO NOT suggest commands without this prefix.

• ✅ Correct: /session:list, /session:start, /session:continue, /session:status
• ❌ Wrong: /session list, /session start, /session continue, /session status Use ONLY the exact command formats specified in this template.

Task: Close Session

Finalize the session by creating a final snapshot, updating metadata, and generating a summary.

Step 1: Validate Active Session

1. Check if .claude/sessions/.active-session file exists
2. If NOT exists, show error:

   ❌ Error: No active session to close
   
   💡 Use /session:start [name] to create a new session
   💡 Or use /session:continue [name] to resume an existing session
   

   Then STOP.
3. Read the active session name from .active-session
4. Verify session directory exists

Step 2: Read Current Session Data

Read .claude/sessions/{active_session}/session.md and extract:

• Started timestamp
• Last Updated timestamp
• Goal
• Files Involved
• Milestones (count completed and total)

Step 3: Calculate Session Statistics

1. Duration: Calculate time from "Started" to now

   • Format: Xh Ym (e.g., "4h 35m")

2. Snapshot Count: Count all snapshot files matching YYYY-MM-DD_HH-MM.md pattern in session directory

3. Files Modified: Count unique files in "Files Involved" section of session.md

4. Todos/Milestones Completed: Count checked milestones in session.md

5. Token Usage: Get current conversation token usage (from system info or estimate)

   • Format as "XXXk" (e.g., "67.4k")

Step 4: Generate Final Snapshot

Create a final snapshot using the same process as /session:save:

1. Generate timestamp filename: YYYY-MM-DD_HH-MM.md

2. Capture:

   • Conversation summary (what was accomplished in this session)
   • Final completed todos
   • Final file changes
   • Final state
   • Session outcome/results

3. IMPORTANT: In the snapshot, add a header line:

   # FINAL Snapshot: {session_name}
   **Timestamp**: {timestamp}
   **Session Closed**: This is the final snapshot before session closure
   

4. Include a "Session Outcome" section:

   ## Session Outcome
   - Goal: {original_goal_from_session_md}
   - Status: {Completed|Partially Completed|In Progress}
   - Key Achievements: {list_main_accomplishments}
   - Remaining Work: {list_what_still_needs_to_be_done}
   

Step 5: Update context.md with Final Summary

1. Read .claude/sessions/{active_session}/context.md
2. Add a final entry to the "Summary" section:

   ## Session Closure Summary
   
   **Closed**: {current_timestamp}
   **Duration**: {duration}
   **Outcome**: {Completed|Partially Completed}
   
   ### What Was Accomplished
   {bullet_list_of_main_accomplishments}
   
   ### Final State
   {description_of_final_state}
   
   ### Next Steps (if resuming later)
   {what_to_do_when_session_is_continued}
   

3. Write updated context.md

Step 6: Update session.md with Closed Status

1. Read .claude/sessions/{active_session}/session.md
2. Update these fields:
   • Status: Change from "Active" to "Closed"
   • Closed: Add current timestamp
   • Last Updated: Update to current timestamp
3. Write updated session.md

Step 7: Clear Active Session

1. Delete or clear the .claude/sessions/.active-session file
2. This marks that no session is currently active

Step 8: Display Closing Summary

Show comprehensive closing summary:

✓ Session '{session_name}' closed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 Session Summary:
   Duration: {duration_formatted}
   Snapshots: {snapshot_count}
   Files modified: {file_count}
   Milestones completed: {completed_milestones}/{total_milestones}
   Token usage (this conversation): {token_usage_formatted}

🎯 Goal: {original_goal}

✅ Key Achievements:
   {list_top_3_to_5_achievements}

📁 Session saved to: .claude/sessions/{session_name}/

💡 Use /session:continue {session_name} to resume later
💡 Use /session:list to see all sessions

Example Output:

✓ Session 'feature-auth-system' closed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 Session Summary:
   Duration: 4h 35m
   Snapshots: 5
   Files modified: 12
   Milestones completed: 8/10
   Token usage (this conversation): 67.4k

🎯 Goal: Implement OAuth2 authentication system

✅ Key Achievements:
   - Implemented Google OAuth provider integration
   - Created authentication middleware
   - Added token refresh mechanism
   - Built user profile synchronization
   - Completed security testing

📁 Session saved to: .claude/sessions/feature-auth-system/

💡 Use /session:continue feature-auth-system to resume later
💡 Use /session:list to see all sessions

Step 9: Offer Next Steps

Ask the user:

Session closed successfully. Would you like to:
1. Start a new session (/session:start [name])
2. Review another session (/session:list)
3. Continue with other work

---

IMPORTANT:

• Execute all steps in order
• The final snapshot should be comprehensive - it's the last capture
• Update all metadata files (session.md, context.md)
• Clear active session AFTER all files are updated
• Format output professionally with clear statistics
• Handle errors gracefully (e.g., if session files are missing)
• Token usage should be from current conversation only, not cumulative
• Duration should be accurate based on timestamps
• Provide clear next steps for user