session-manager
Manage Claude Code sessions for the current branch. Use this skill when:- User asks "what's next?" or "where was I?"- User starts work on a new branch without a session- Before committing (to update session log)- When resuming work after a break
When & Why to Use This Skill
The Session Manager skill for Claude Code is designed to maintain persistent work context across conversation resets and git branch transitions. By linking sessions directly to git branches and issues, it ensures the AI agent retains a continuous memory of progress, 'next steps', and project state, significantly reducing the need for manual re-briefing and improving developer productivity in complex coding environments.
Use Cases
- Context Recovery: Quickly resume development after a break or a session reset by retrieving the exact state of work and planned next steps.
- Multi-tasking across Branches: Seamlessly switch between different git branches while the AI automatically loads the relevant session context for each specific feature or bug fix.
- Workflow Standardization: Enforce 'session-first' development rules where the agent tracks milestones and updates logs before commits, ensuring high-quality documentation.
- Onboarding and Handoff: Use the session logs to provide a clear audit trail of what has been accomplished and what remains to be done for a specific issue or task.
| name | session-manager |
|---|---|
| description | | |
Session Manager
Manage work sessions that persist context across conversation resets.
When to Use This Skill
Proactively invoke when user:
- Asks about current work context
- Switches branches and needs session context
- Wants to create or update a session
- Is resuming work or asking "what's next?"
Context Files (Auto-Injected)
- rules/sessions.md: Rules for session workflow (BLOCKING requirements)
- context/sessions.md: Detailed examples and patterns
Read these files for complete guidance. This skill provides quick reference only.
Quick Reference
Check Session Status
git branch --show-current
# Sanitize: replace / with -
# Read: .claude/branches/<sanitized>
# Read: .claude/sessions/<session>.md → focus on Next Steps
Create Session
Use /memento:session create command.
Update Session
Edit session file directly. Update triggers:
- Beginning work
- After milestone
- Before pause
- Before commit (atomic with code)
Key Rules (from rules/sessions.md)
- Never guess current branch — always
git branch --show-current - Session = Branch = Issue (1:1:1 mapping)
- Atomic commits — session + code together
- BLOCKING: No source edits without active session
What This Skill Does NOT Do
- Define session file format (see context/sessions.md)
- Define workflow patterns (see rules/sessions.md)
- Handle git operations (see rules/git.md, context/git.md via onus)