| name | session-manager |
| description | Manage named Claude Code sessions for CircleTel workflows. Use when starting feature work, resuming previous sessions, organizing multi-day tasks, or switching between different work contexts like admin, dashboard, or payment features. |
Session Manager
Skill for managing named Claude Code sessions in CircleTel development.
When to Use
This skill activates when you:
- Start a new feature or bug fix
- Need to resume previous work
- Switch between different project areas
- Want to organize long-running tasks
Keywords: session, resume, rename, continue, context, switch task, pick up, where I left off
Quick Commands
| Command | Description |
|---|---|
/rename <name> |
Name current session |
/resume <name> |
Resume a named session |
/resume |
Show session picker (P=preview, R=rename) |
claude --resume <name> |
Resume from terminal |
claude --continue |
Continue most recent session |
Session Naming Conventions
By Feature Area
dashboard-billing-history
admin-orders-export
payment-netcash-emandate
coverage-mtn-integration
partner-compliance-upload
By Issue/Ticket
BUG-1234-infinite-loading
FEAT-567-customer-services
HOTFIX-payment-timeout
By Sprint/Week
sprint-23-kyc-flow
week-49-partner-portal
CircleTel Session Templates
| Project Area | Session Name Pattern | Example |
|---|---|---|
| Customer Dashboard | dashboard-{feature} |
dashboard-billing-history |
| Admin Portal | admin-{feature} |
admin-orders-export |
| Payment System | payment-{provider}-{feature} |
payment-netcash-emandate |
| B2B KYC | b2b-kyc-{stage} |
b2b-kyc-didit-integration |
| Coverage API | coverage-{provider} |
coverage-mtn-wms |
| Partner Portal | partner-{feature} |
partner-compliance-upload |
Workflow Patterns
Pattern 1: Feature Branch Workflow
# 1. Create git branch
git checkout -b feature/customer-billing
# 2. Start Claude with named session
claude
# Then type: /rename customer-billing
# 3. Work on feature...
# 4. Next day, resume
claude --resume customer-billing
Pattern 2: Context Switching
# Working on billing, need to fix urgent bug
# First, save current context
/rename billing-paused
# Start new session for bug
claude
/rename HOTFIX-auth-timeout
# Fix bug, commit, then resume billing
claude --resume billing-paused
Pattern 3: Multi-Day Implementation
Day 1: /rename b2b-kyc-sprint
- Complete database schema
- Start API routes
Day 2: claude --resume b2b-kyc-sprint
- Continue API routes
- Add frontend components
Day 3: claude --resume b2b-kyc-sprint
- Testing and validation
- Documentation
Pattern 4: Parallel Feature Development
# Terminal 1: Main feature
claude --resume dashboard-billing
# Terminal 2: Quick hotfix
claude --resume HOTFIX-auth-fix
# Switch between as needed
Session Picker Shortcuts
When you run /resume without a name:
| Key | Action |
|---|---|
P |
Preview session content |
R |
Rename session |
Enter |
Select and resume |
Esc |
Cancel |
j/k |
Navigate up/down |
Integration with Git Branches
Match session names to git branches for easy tracking:
# Create branch
git checkout -b feature/customer-dashboard
# Name session same as branch
/rename feature-customer-dashboard
# Later, find session by branch name
claude --resume feature-customer-dashboard
Integration with Context Manager
When resuming long sessions, check context budget:
# After resuming
claude --resume my-feature
# Run context analysis
powershell -File .claude/skills/context-manager/run-context-analyzer.ps1
Best Practices
- Name sessions immediately - Run
/renameat start of work - Use descriptive names - Future you will thank present you
- Match git branches - Same name for branch and session
- Document context - First message should summarize the goal
- Clean up old sessions - Delete completed work sessions
- Use prefixes for priority:
URGENT-for critical issuesHOTFIX-for production bugsFEAT-for new featuresCHORE-for maintenance
Troubleshooting
Can't find session by name
# List all sessions
/resume
# Use search to filter
Session context seems lost
# Check context usage
/context
# If near limit, may need new session
# Reference old session in new one:
"I was working on feature X in session 'old-session'. Continuing..."
Multiple sessions with similar names
# Use more specific names
# Bad: dashboard, dashboard-2
# Good: dashboard-billing-v1, dashboard-usage-charts
Version: 1.0.0 Last Updated: 2025-12-10 For: Claude Code v2.0.64+