claude-flow 3.42.3 → 3.42.4

package/.claude/commands/pair/session.md

@@ -1,407 +1,407 @@
-# Pair Programming Session Management
-
-Complete guide to managing pair programming sessions.
-
-## Session Lifecycle
-
-### 1. Initialization
-```bash
-claude-flow pair --start
-```
-
-### 2. Active Session
-- Real-time collaboration
-- Continuous verification
-- Quality monitoring
-- Role management
-
-### 3. Completion
-```bash
-claude-flow pair --end
-```
-
-## Session Commands
-
-During an active session, use these commands:
-
-### Basic Commands
-```
-/help          - Show all available commands
-/status        - Current session status
-/metrics       - View quality metrics
-/pause         - Pause current session
-/resume        - Resume paused session
-/end           - End current session
-```
-
-### Code Commands
-```
-/explain       - Explain current code
-/suggest       - Get improvement suggestions
-/refactor      - Refactor selected code
-/optimize      - Optimize for performance
-/document      - Add documentation
-/comment       - Add inline comments
-```
-
-### Testing Commands
-```
-/test          - Run test suite
-/test-gen      - Generate tests
-/coverage      - Check test coverage
-/test-watch    - Enable test watching
-/mock          - Generate mocks
-```
-
-### Review Commands
-```
-/review        - Full code review
-/security      - Security analysis
-/perf          - Performance review
-/quality       - Quality metrics
-/lint          - Run linters
-```
-
-### Navigation Commands
-```
-/goto <file>   - Navigate to file
-/find <text>   - Search in project
-/recent        - Recent files
-/bookmark      - Bookmark location
-/history       - Command history
-```
-
-### Role Commands
-```
-/switch        - Switch driver/navigator
-/mode <type>   - Change mode
-/role          - Show current role
-/handoff       - Prepare role handoff
-```
-
-### Git Commands
-```
-/diff          - Show changes
-/commit        - Commit with verification
-/branch        - Branch operations
-/stash         - Stash changes
-/log           - View git log
-```
-
-## Session Status
-
-Check current session status:
-
-```bash
-claude-flow pair --status
-```
-
-Output:
-```
-👥 Pair Programming Session
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Session ID: pair_1755021234567
-Duration: 45 minutes
-Status: Active
-
-Partner: senior-dev
-Current Role: DRIVER (you)
-Mode: Switch (10m intervals)
-Next Switch: in 3 minutes
-
-📊 Metrics:
-├── Truth Score: 0.982 ✅
-├── Lines Changed: 234
-├── Files Modified: 5
-├── Tests Added: 12
-├── Coverage: 87% ↑3%
-└── Commits: 3
-
-🎯 Focus: Implementation
-📝 Current File: src/auth/login.js
-```
-
-## Session History
-
-View past sessions:
-
-```bash
-claude-flow pair --history
-```
-
-Output:
-```
-📚 Session History
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-1. 2024-01-15 14:30 - 16:45 (2h 15m)
-   Partner: expert-coder
-   Focus: Refactoring
-   Truth Score: 0.975
-   Changes: +340 -125 lines
-
-2. 2024-01-14 10:00 - 11:30 (1h 30m)
-   Partner: tdd-specialist
-   Focus: Testing
-   Truth Score: 0.991
-   Tests Added: 24
-
-3. 2024-01-13 15:00 - 17:00 (2h)
-   Partner: debugger-expert
-   Focus: Bug Fixing
-   Truth Score: 0.968
-   Issues Fixed: 5
-```
-
-## Session Metrics
-
-Real-time metrics during session:
-
-### Truth Score
-```
-Current: 0.982 ✅
-Average: 0.975
-Minimum: 0.951
-Threshold: 0.950
-```
-
-### Productivity
-```
-Lines Changed: 234
-Files Modified: 5
-Functions Added: 8
-Functions Refactored: 3
-```
-
-### Quality
-```
-Test Coverage: 87% ↑3%
-Lint Issues: 0
-Security Issues: 0
-Performance Issues: 1 ⚠️
-```
-
-### Collaboration
-```
-Suggestions Given: 45
-Suggestions Accepted: 38 (84%)
-Reviews Completed: 12
-Rollbacks: 1
-```
-
-## Session Persistence
-
-### Save Session
-```bash
-claude-flow pair --save [--name <name>]
-```
-
-### Load Session
-```bash
-claude-flow pair --load <session-id>
-```
-
-### Export Session
-```bash
-claude-flow pair --export <session-id> [--format json|md]
-```
-
-## Background Sessions
-
-Run pair programming in background:
-
-### Start Background Session
-```bash
-claude-flow pair --start --background
-```
-
-### Monitor Background Session
-```bash
-claude-flow pair --monitor
-```
-
-### Attach to Background Session
-```bash
-claude-flow pair --attach <session-id>
-```
-
-## Session Configuration
-
-### Default Settings
-```json
-{
-  "pair": {
-    "session": {
-      "autoSave": true,
-      "saveInterval": "5m",
-      "maxDuration": "4h",
-      "idleTimeout": "15m",
-      "metricsInterval": "1m"
-    }
-  }
-}
-```
-
-### Per-Session Config
-```bash
-claude-flow pair --start \
-  --config custom-config.json
-```
-
-## Session Templates
-
-### Refactoring Template
-```bash
-claude-flow pair --template refactor
-```
-- Focus: Code improvement
-- Verification: High (0.98)
-- Testing: After each change
-- Review: Continuous
-
-### Feature Template
-```bash
-claude-flow pair --template feature
-```
-- Focus: Implementation
-- Verification: Standard (0.95)
-- Testing: On completion
-- Review: Pre-commit
-
-### Debug Template
-```bash
-claude-flow pair --template debug
-```
-- Focus: Problem solving
-- Verification: Moderate (0.90)
-- Testing: Regression tests
-- Review: Root cause
-
-### Learning Template
-```bash
-claude-flow pair --template learn
-```
-- Mode: Mentor
-- Pace: Slow
-- Explanations: Detailed
-- Examples: Many
-
-## Session Reports
-
-Generate session report:
-
-```bash
-claude-flow pair --report <session-id>
-```
-
-Report includes:
-- Session summary
-- Metrics overview
-- Code changes
-- Test results
-- Quality scores
-- Learning points
-- Recommendations
-
-## Multi-Session Management
-
-### List Active Sessions
-```bash
-claude-flow pair --list
-```
-
-### Switch Between Sessions
-```bash
-claude-flow pair --switch <session-id>
-```
-
-### Merge Sessions
-```bash
-claude-flow pair --merge <session-1> <session-2>
-```
-
-## Session Recovery
-
-### Auto-Recovery
-Sessions auto-save every 5 minutes with recovery points.
-
-### Manual Recovery
-```bash
-claude-flow pair --recover [--point <timestamp>]
-```
-
-### Crash Recovery
-```bash
-claude-flow pair --crash-recovery
-```
-
-## Session Sharing
-
-### Share with Team
-```bash
-claude-flow pair --share <session-id> \
-  --team <team-id>
-```
-
-### Export for Review
-```bash
-claude-flow pair --export-review <session-id>
-```
-
-### Create Learning Material
-```bash
-claude-flow pair --create-tutorial <session-id>
-```
-
-## Advanced Features
-
-### Session Recording
-```bash
-claude-flow pair --start --record
-```
-Records all interactions for playback.
-
-### Session Replay
-```bash
-claude-flow pair --replay <session-id>
-```
-Replay recorded session for learning.
-
-### Session Analytics
-```bash
-claude-flow pair --analytics <session-id>
-```
-Deep analysis of session patterns.
-
-## Troubleshooting
-
-### Session Won't Start
-- Check agent availability
-- Verify configuration
-- Ensure clean workspace
-
-### Session Disconnected
-- Use `--recover` to restore
-- Check network connection
-- Verify background processes
-
-### Poor Performance
-- Reduce verification threshold
-- Disable continuous testing
-- Check system resources
-
-## Best Practices
-
-1. **Regular Saves** - Auto-save enabled
-2. **Clear Goals** - Define objectives
-3. **Appropriate Duration** - 1-2 hour sessions
-4. **Breaks** - Take regular breaks
-5. **Review** - End with summary
-
-## Related Commands
-
-- `pair --start` - Start new session
-- `pair --config` - Configure settings
-- `pair --templates` - Manage templates
+# Pair Programming Session Management
+
+Complete guide to managing pair programming sessions.
+
+## Session Lifecycle
+
+### 1. Initialization
+```bash
+claude-flow pair --start
+```
+
+### 2. Active Session
+- Real-time collaboration
+- Continuous verification
+- Quality monitoring
+- Role management
+
+### 3. Completion
+```bash
+claude-flow pair --end
+```
+
+## Session Commands
+
+During an active session, use these commands:
+
+### Basic Commands
+```
+/help          - Show all available commands
+/status        - Current session status
+/metrics       - View quality metrics
+/pause         - Pause current session
+/resume        - Resume paused session
+/end           - End current session
+```
+
+### Code Commands
+```
+/explain       - Explain current code
+/suggest       - Get improvement suggestions
+/refactor      - Refactor selected code
+/optimize      - Optimize for performance
+/document      - Add documentation
+/comment       - Add inline comments
+```
+
+### Testing Commands
+```
+/test          - Run test suite
+/test-gen      - Generate tests
+/coverage      - Check test coverage
+/test-watch    - Enable test watching
+/mock          - Generate mocks
+```
+
+### Review Commands
+```
+/review        - Full code review
+/security      - Security analysis
+/perf          - Performance review
+/quality       - Quality metrics
+/lint          - Run linters
+```
+
+### Navigation Commands
+```
+/goto <file>   - Navigate to file
+/find <text>   - Search in project
+/recent        - Recent files
+/bookmark      - Bookmark location
+/history       - Command history
+```
+
+### Role Commands
+```
+/switch        - Switch driver/navigator
+/mode <type>   - Change mode
+/role          - Show current role
+/handoff       - Prepare role handoff
+```
+
+### Git Commands
+```
+/diff          - Show changes
+/commit        - Commit with verification
+/branch        - Branch operations
+/stash         - Stash changes
+/log           - View git log
+```
+
+## Session Status
+
+Check current session status:
+
+```bash
+claude-flow pair --status
+```
+
+Output:
+```
+👥 Pair Programming Session
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Session ID: pair_1755021234567
+Duration: 45 minutes
+Status: Active
+
+Partner: senior-dev
+Current Role: DRIVER (you)
+Mode: Switch (10m intervals)
+Next Switch: in 3 minutes
+
+📊 Metrics:
+├── Truth Score: 0.982 ✅
+├── Lines Changed: 234
+├── Files Modified: 5
+├── Tests Added: 12
+├── Coverage: 87% ↑3%
+└── Commits: 3
+
+🎯 Focus: Implementation
+📝 Current File: src/auth/login.js
+```
+
+## Session History
+
+View past sessions:
+
+```bash
+claude-flow pair --history
+```
+
+Output:
+```
+📚 Session History
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+1. 2024-01-15 14:30 - 16:45 (2h 15m)
+   Partner: expert-coder
+   Focus: Refactoring
+   Truth Score: 0.975
+   Changes: +340 -125 lines
+
+2. 2024-01-14 10:00 - 11:30 (1h 30m)
+   Partner: tdd-specialist
+   Focus: Testing
+   Truth Score: 0.991
+   Tests Added: 24
+
+3. 2024-01-13 15:00 - 17:00 (2h)
+   Partner: debugger-expert
+   Focus: Bug Fixing
+   Truth Score: 0.968
+   Issues Fixed: 5
+```
+
+## Session Metrics
+
+Real-time metrics during session:
+
+### Truth Score
+```
+Current: 0.982 ✅
+Average: 0.975
+Minimum: 0.951
+Threshold: 0.950
+```
+
+### Productivity
+```
+Lines Changed: 234
+Files Modified: 5
+Functions Added: 8
+Functions Refactored: 3
+```
+
+### Quality
+```
+Test Coverage: 87% ↑3%
+Lint Issues: 0
+Security Issues: 0
+Performance Issues: 1 ⚠️
+```
+
+### Collaboration
+```
+Suggestions Given: 45
+Suggestions Accepted: 38 (84%)
+Reviews Completed: 12
+Rollbacks: 1
+```
+
+## Session Persistence
+
+### Save Session
+```bash
+claude-flow pair --save [--name <name>]
+```
+
+### Load Session
+```bash
+claude-flow pair --load <session-id>
+```
+
+### Export Session
+```bash
+claude-flow pair --export <session-id> [--format json|md]
+```
+
+## Background Sessions
+
+Run pair programming in background:
+
+### Start Background Session
+```bash
+claude-flow pair --start --background
+```
+
+### Monitor Background Session
+```bash
+claude-flow pair --monitor
+```
+
+### Attach to Background Session
+```bash
+claude-flow pair --attach <session-id>
+```
+
+## Session Configuration
+
+### Default Settings
+```json
+{
+  "pair": {
+    "session": {
+      "autoSave": true,
+      "saveInterval": "5m",
+      "maxDuration": "4h",
+      "idleTimeout": "15m",
+      "metricsInterval": "1m"
+    }
+  }
+}
+```
+
+### Per-Session Config
+```bash
+claude-flow pair --start \
+  --config custom-config.json
+```
+
+## Session Templates
+
+### Refactoring Template
+```bash
+claude-flow pair --template refactor
+```
+- Focus: Code improvement
+- Verification: High (0.98)
+- Testing: After each change
+- Review: Continuous
+
+### Feature Template
+```bash
+claude-flow pair --template feature
+```
+- Focus: Implementation
+- Verification: Standard (0.95)
+- Testing: On completion
+- Review: Pre-commit
+
+### Debug Template
+```bash
+claude-flow pair --template debug
+```
+- Focus: Problem solving
+- Verification: Moderate (0.90)
+- Testing: Regression tests
+- Review: Root cause
+
+### Learning Template
+```bash
+claude-flow pair --template learn
+```
+- Mode: Mentor
+- Pace: Slow
+- Explanations: Detailed
+- Examples: Many
+
+## Session Reports
+
+Generate session report:
+
+```bash
+claude-flow pair --report <session-id>
+```
+
+Report includes:
+- Session summary
+- Metrics overview
+- Code changes
+- Test results
+- Quality scores
+- Learning points
+- Recommendations
+
+## Multi-Session Management
+
+### List Active Sessions
+```bash
+claude-flow pair --list
+```
+
+### Switch Between Sessions
+```bash
+claude-flow pair --switch <session-id>
+```
+
+### Merge Sessions
+```bash
+claude-flow pair --merge <session-1> <session-2>
+```
+
+## Session Recovery
+
+### Auto-Recovery
+Sessions auto-save every 5 minutes with recovery points.
+
+### Manual Recovery
+```bash
+claude-flow pair --recover [--point <timestamp>]
+```
+
+### Crash Recovery
+```bash
+claude-flow pair --crash-recovery
+```
+
+## Session Sharing
+
+### Share with Team
+```bash
+claude-flow pair --share <session-id> \
+  --team <team-id>
+```
+
+### Export for Review
+```bash
+claude-flow pair --export-review <session-id>
+```
+
+### Create Learning Material
+```bash
+claude-flow pair --create-tutorial <session-id>
+```
+
+## Advanced Features
+
+### Session Recording
+```bash
+claude-flow pair --start --record
+```
+Records all interactions for playback.
+
+### Session Replay
+```bash
+claude-flow pair --replay <session-id>
+```
+Replay recorded session for learning.
+
+### Session Analytics
+```bash
+claude-flow pair --analytics <session-id>
+```
+Deep analysis of session patterns.
+
+## Troubleshooting
+
+### Session Won't Start
+- Check agent availability
+- Verify configuration
+- Ensure clean workspace
+
+### Session Disconnected
+- Use `--recover` to restore
+- Check network connection
+- Verify background processes
+
+### Poor Performance
+- Reduce verification threshold
+- Disable continuous testing
+- Check system resources
+
+## Best Practices
+
+1. **Regular Saves** - Auto-save enabled
+2. **Clear Goals** - Define objectives
+3. **Appropriate Duration** - 1-2 hour sessions
+4. **Breaks** - Take regular breaks
+5. **Review** - End with summary
+
+## Related Commands
+
+- `pair --start` - Start new session
+- `pair --config` - Configure settings
+- `pair --templates` - Manage templates
 - `pair --analytics` - View analytics