/session-management

name: session-management
description: Manage agent sessions including initialization, handoffs, revival (seance), and persistent identity for Polecats and Crew agents.
allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch, Agent, AskUserQuestion
graph:
  domains: [domain:software-engineering]
  skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop]
  workflows: [workflow:feature-development]
  topics: [topic:developer-experience]
  roles: [role:tech-lead, role:backend-engineer]

• Handing off work between agents
• Reviving a dead or stuck agent session
• Managing Polecat identity persistence across sessions

Session Operations

1. **Init**: Start new session with role and hook setup 2. **Attach**: Connect agent to Mayor for coordination 3. **Handoff**: Transfer work between agents with context 4. **Seance**: Revive a dead agent's session state 5. **Resume**: Continue from last checkpoint

Agent Session Types

• **Crew**: Long-lived sessions, full state persistence
• **Polecat**: Ephemeral sessions, persistent identity, state via hooks
• **Dog**: Infrastructure sessions, minimal state

Key Commands

• `gt mayor attach` - Attach to Mayor coordination
• `gt handoff` - Hand off work to another agent
• `gt seance` - Revive dead session
• `gt prime` - Prime agent with context

Tool Use

Used within agent coordination and patrol monitoring processes.