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 /rename at 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 issues
- HOTFIX- for production bugs
- FEAT- for new features
- CHORE- 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+

session-manager