majiayu000 Close Session
Save progress, update memory, regenerate navigation, and ensure system integrity.
Purpose
The close-session skill is the most critical system skill. It ensures nothing is ever lost by:
- Reading and updating project progress from steps.md checkboxes
- Validating workspace-map.md accuracy (auto-detect mismatches)
- Updating memory with decisions and patterns
- Cleaning temporary files from root folder
- Creating historical session reports
- Displaying comprehensive summary
CRITICAL: This skill is AUTO-TRIGGERED by all other skills and projects (not user-dependent!).
Execution Sequence
- Initialize TodoWrite with all 10 steps (MANDATORY - prevents skipped steps)
- Load workflow.md
- Execute steps 1-10 sequentially
- Mark each step complete in TodoWrite as you finish it
Critical Rules
- TodoWrite is MANDATORY: Initialize at start with all 10 steps - prevents forgetting critical steps
- PLANNING phase projects: Skip task completion (Step 2/2.5)
- IN_PROGRESS phase projects: Auto-complete if execution signals detected
- Session reports: Create in 01-memory/session-reports/
- Summary display: ≤5 lines per orchestrator.md rule
Key Features
Automatic & Interactive Task Completion
Smart task completion with automatic detection:
- Automatic Bulk Complete: If project work completed this session, auto-marks all tasks
- Manual Bulk Option: If auto-detect missed it, offers bulk-complete during review
- Interactive Review: Shows first 10 unchecked tasks for manual selection
- User selects by number ("1, 3, 5"), "all", "bulk complete", or "none"
- Updates tasks.md automatically (via Edit tool or bulk-complete script)
- Recalculates progress after any changes
Temp File Cleanup
Interactive cleanup with user choices:
- Scans root folder for temp files
- Asks what to do with each: keep, delete, or skip
- Moves preserved files to project outputs/
- Reports cleanup summary
Session Reporting
Creates historical record:
- Generates session report in 01-memory/session-reports/
- Includes work completed, progress, decisions, patterns
- Provides context for next session
Progress Tracking
Auto-calculates from checkboxes:
- Counts total tasks (all
- [ ]and- [x]) - Counts completed tasks (only
- [x]) - Determines status (PLANNING/IN_PROGRESS/COMPLETE)
- Identifies next task
Auto-Trigger Support
Called automatically by other skills:
- create-project
- validate-system
- Any skill completion
Memory Preservation
THE critical persistence mechanism:
- Creates session reports
- Cleans temp files
Without this skill, context does NOT persist across sessions!
Workflow Overview
Complete workflow with all 9 steps: See workflow.md
Steps (from workflow.md):
- Read project state (skip if no IN_PROGRESS projects)
- Review task completion (skip if PLANNING phase)
- Update maps
- Get timestamp
- Update memory
- Clean temp files (delete .md files not in system folders)
- Create session report
- Display summary (≤5 lines)
- Mark complete
- Instruct fresh session
Integration
Auto-Trigger Format
When called by other skills:
Auto-triggering close-session skill...
[Full workflow executes]
Session saved! ✅
[Summary displays]
User-Trigger Format
When user says "done for now":
Closing your session...
[Full workflow executes]
Session saved! ✅
[Summary displays]
All Skills Must End With
Every skill and project workflow should conclude with:
### Final Step: Close Session
Auto-trigger close-session skill to save progress
This ensures:
- Progress is saved
- Maps are updated
- Session is recorded
- Nothing is lost
Error Handling
For complete error scenarios and solutions, see error-handling.md
Common Scenarios:
No active project → Skip project steps, continue with maps and cleanup
Missing tasks.md → Report in summary, suggest validate-system
Corrupted memory → Rebuild from scan, report issue
Map generation fails → Keep old maps, report error, suggest retry
User doesn't respond → Default to "skip" for temp files
Critical Notes
Memory Preservation
This skill is the ONLY way to:
- Create historical session reports
- Clean temporary files from workspace
Context Persistence
Without this skill running at session end:
- Progress updates are lost
- Navigation maps become stale
- No historical record is created
- Temp files accumulate
Never skip this skill - it's the foundation of context preservation!
Workflow Philosophy
This skill embodies the Nexus philosophy:
- Memory preservation: Nothing is ever lost
- Context awareness: Full system state captured
- Progressive disclosure: Load what you need, when you need it
- User collaboration: Interactive choices for important decisions
Resources
references/
- workflow.md: Complete 9-step workflow (with TOC)
- error-handling.md: All error scenarios and solutions
Integration with bulk-complete Skill
This skill uses the bulk-complete system skill for efficient task completion:
Step 2 & 2.5: Auto-runs bulk-complete when project work is done
python 00-system/skills/bulk-complete/scripts/bulk-complete.py --project [ID] --all --no-confirm
See bulk-complete/SKILL.md for standalone usage, all options, and test coverage details.
Remember: This is THE most important system skill. Every session MUST end with close-session to preserve context!