Files
SuperClaude/.claude/commands/shared/session-recovery.yml
NomenAK ff61676f74 refactor: Remove all hard claims, metrics, and numeric targets
Comprehensive update to remove specific performance claims and replace with qualitative descriptions:

- Replace percentage claims (65%, 70%, 99.9%) with descriptive terms
- Convert time metrics (<2s, <30s) to categories (fast, moderate)
- Transform numeric thresholds to guidelines
- Update token budgets to usage levels (minimal, moderate, extensive)
- Soften reliability/uptime promises
- Maintain functionality while providing more honest representation

Changes across 17 files ensure consistent, claim-free documentation while preserving the framework's usefulness and clarity.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-24 22:02:29 +02:00

145 lines
3.3 KiB
YAML

# session-recovery.yml - Session Recovery & Context Preservation
## Startup Detection
```yaml
scan_on_startup:
locations:
- ./claudedocs/tasks/in-progress/*.md
- ./claudedocs/tasks/pending/*.md (overdue)
parse_tasks:
- extract metadata
- check git branch status
- identify next steps
- restore context variables
recovery_prompt:
found_tasks: "Found {count} active tasks. Resume work?"
no_tasks: "No active tasks found. Ready for new work."
overdue: "Task {id} overdue. Continue or reschedule?"
```
## Context Preservation
```yaml
session_state:
file_paths: currently modified files
variables: important data & settings
decisions: architectural choices made
blockers: issues & solutions attempted
auto_save_triggers:
- major code changes
- before risky operations
- session timeout warnings
- manual /task:pause
context_format:
```yaml
session_state:
current_files: [path1, path2]
key_variables:
api_endpoint: "https://api.example.com"
database_name: "myapp_prod"
decisions:
- "Used React over Vue for better team familiarity"
- "Chose PostgreSQL for ACID compliance"
blockers:
- issue: "CORS error on API calls"
attempted: ["added headers", "proxy setup"]
solution: "needed server-side CORS config"
```
```
## Hybrid Recovery Process
```yaml
step_1_identify:
- scan ./claudedocs/tasks/in-progress/
- parse task metadata
- check git branch status
- validate file existence
- restore previous TodoWrite state
step_2_restore_both_systems:
task_context:
- load session context
- summarize previous work
- identify blocking issues
todo_context:
- regenerate TodoWrite from task breakdown
- identify last completed todo
- set current focus todo
- preserve todo progress
step_3_seamless_resume:
no_prompts: true
auto_continue: true
template: |
Resuming {task_title} - working on: {current_todo}
Progress: {completed_todos}/{total_todos} todos, {task_progress}% complete
hybrid_state_restoration:
both_systems_sync:
- task provides persistence
- todos provide immediate focus
- progress tracked in both
- no duplication of effort
```
## Git Integration
```yaml
branch_tracking:
- verify branch exists
- check for uncommitted changes
- identify merge conflicts
- track remote status
checkpoint_restoration:
- list available checkpoints
- show diff since last checkpoint
- offer rollback options
- suggest merge strategies
```
## Session Break Handling
```yaml
graceful_pause:
auto_triggers:
- context very high usage
- long inactivity
- error thresholds
pause_actions:
- save current context
- create git checkpoint
- update progress status
- log session summary
resume_preparation:
- validate environment
- check dependencies
- restore file states
- prepare tools
```
## Multi-Task Management
```yaml
concurrent_tasks:
max_active: 3
priority_rules:
- high priority blocks others
- related tasks can be parallel
- different areas can overlap
task_switching:
- auto-save current context
- create checkpoint
- switch git branch
- restore new context
conflict_resolution:
- file modification conflicts
- git merge requirements
- dependency overlaps
- resource constraints
```