claude-flow-novice 2.10.5 → 2.10.6

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

@@ -0,0 +1,407 @@
+# Pair Programming Session Management
+
+Complete guide to managing pair programming sessions.
+
+## Session Lifecycle
+
+### 1. Initialization
+```bash
+claude-flow-novice pair --start
+```
+
+### 2. Active Session
+- Real-time collaboration
+- Continuous verification
+- Quality monitoring
+- Role management
+
+### 3. Completion
+```bash
+claude-flow-novice 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-novice 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-novice 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-novice pair --save [--name <name>]
+```
+
+### Load Session
+```bash
+claude-flow-novice pair --load <session-id>
+```
+
+### Export Session
+```bash
+claude-flow-novice pair --export <session-id> [--format json|md]
+```
+
+## Background Sessions
+
+Run pair programming in background:
+
+### Start Background Session
+```bash
+claude-flow-novice pair --start --background
+```
+
+### Monitor Background Session
+```bash
+claude-flow-novice pair --monitor
+```
+
+### Attach to Background Session
+```bash
+claude-flow-novice 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-novice pair --start \
+  --config custom-config.json
+```
+
+## Session Templates
+
+### Refactoring Template
+```bash
+claude-flow-novice pair --template refactor
+```
+- Focus: Code improvement
+- Verification: High (0.98)
+- Testing: After each change
+- Review: Continuous
+
+### Feature Template
+```bash
+claude-flow-novice pair --template feature
+```
+- Focus: Implementation
+- Verification: Standard (0.95)
+- Testing: On completion
+- Review: Pre-commit
+
+### Debug Template
+```bash
+claude-flow-novice pair --template debug
+```
+- Focus: Problem solving
+- Verification: Moderate (0.90)
+- Testing: Regression tests
+- Review: Root cause
+
+### Learning Template
+```bash
+claude-flow-novice pair --template learn
+```
+- Mode: Mentor
+- Pace: Slow
+- Explanations: Detailed
+- Examples: Many
+
+## Session Reports
+
+Generate session report:
+
+```bash
+claude-flow-novice 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-novice pair --list
+```
+
+### Switch Between Sessions
+```bash
+claude-flow-novice pair --switch <session-id>
+```
+
+### Merge Sessions
+```bash
+claude-flow-novice pair --merge <session-1> <session-2>
+```
+
+## Session Recovery
+
+### Auto-Recovery
+Sessions auto-save every 5 minutes with recovery points.
+
+### Manual Recovery
+```bash
+claude-flow-novice pair --recover [--point <timestamp>]
+```
+
+### Crash Recovery
+```bash
+claude-flow-novice pair --crash-recovery
+```
+
+## Session Sharing
+
+### Share with Team
+```bash
+claude-flow-novice pair --share <session-id> \
+  --team <team-id>
+```
+
+### Export for Review
+```bash
+claude-flow-novice pair --export-review <session-id>
+```
+
+### Create Learning Material
+```bash
+claude-flow-novice pair --create-tutorial <session-id>
+```
+
+## Advanced Features
+
+### Session Recording
+```bash
+claude-flow-novice pair --start --record
+```
+Records all interactions for playback.
+
+### Session Replay
+```bash
+claude-flow-novice pair --replay <session-id>
+```
+Replay recorded session for learning.
+
+### Session Analytics
+```bash
+claude-flow-novice 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

package/claude-assets/commands/pair/start.md

@@ -0,0 +1,209 @@
+# pair --start
+
+Start a new pair programming session with AI assistance.
+
+## Usage
+
+```bash
+claude-flow-novice pair --start [options]
+```
+
+## Options
+
+- `--agent <name>` - AI pair partner (default: auto-select)
+- `--mode <type>` - Programming mode: driver, navigator, switch
+- `--verify` - Enable real-time verification
+- `--threshold <0-1>` - Verification threshold (default: 0.95)
+- `--focus <area>` - Focus area: refactor, test, debug, implement
+- `--language <lang>` - Primary programming language
+- `--review` - Enable continuous code review
+- `--test` - Run tests after each change
+- `--interval <time>` - Switch interval for switch mode (default: 10m)
+
+## Examples
+
+### Basic Start
+```bash
+claude-flow-novice pair --start
+```
+
+### Expert Refactoring Session
+```bash
+claude-flow-novice pair --start \
+  --agent senior-dev \
+  --focus refactor \
+  --verify \
+  --threshold 0.98
+```
+
+### TDD Session
+```bash
+claude-flow-novice pair --start \
+  --mode driver \
+  --focus test \
+  --test \
+  --language javascript
+```
+
+### Debugging Session
+```bash
+claude-flow-novice pair --start \
+  --agent debugger-expert \
+  --focus debug \
+  --review
+```
+
+## Session Initialization
+
+When starting a session, the system:
+
+1. **Selects AI Partner** - Matches expertise to your needs
+2. **Configures Environment** - Sets up verification and testing
+3. **Establishes Roles** - Defines driver/navigator responsibilities
+4. **Loads Context** - Imports project information
+5. **Begins Monitoring** - Tracks quality metrics
+
+## Modes Explained
+
+### Driver Mode
+You write code while AI:
+- Provides real-time suggestions
+- Reviews changes instantly
+- Catches potential issues
+- Suggests improvements
+
+### Navigator Mode
+AI writes code while you:
+- Provide high-level guidance
+- Review generated code
+- Request modifications
+- Control direction
+
+### Switch Mode
+Automatically alternates roles:
+- Default: 10-minute intervals
+- Configurable timing
+- Smooth handoffs
+- Shared context
+
+## Focus Areas
+
+### Refactor
+- Code structure improvements
+- Pattern implementation
+- Performance optimization
+- Readability enhancement
+
+### Test
+- Test-driven development
+- Test coverage improvement
+- Edge case identification
+- Mock creation
+
+### Debug
+- Issue identification
+- Root cause analysis
+- Fix suggestions
+- Prevention strategies
+
+### Implement
+- Feature development
+- API creation
+- UI components
+- Business logic
+
+## Quality Features
+
+### Verification
+- Real-time truth scoring
+- Automatic rollback on failures
+- Quality gates before commits
+- Continuous monitoring
+
+### Code Review
+- Instant feedback
+- Best practice enforcement
+- Security scanning
+- Performance analysis
+
+### Testing
+- Automatic test generation
+- Coverage tracking
+- Integration suggestions
+- Regression prevention
+
+## Session Output
+
+```
+👥 Pair Programming Session Started
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Session ID: pair_1755021234567
+Partner: senior-dev
+Mode: Switch (10m intervals)
+Focus: Implementation
+Language: JavaScript
+
+Verification: ✅ Enabled (0.95 threshold)
+Testing: ✅ Auto-run on save
+Review: ✅ Continuous
+
+Current Role: DRIVER (you)
+Navigator: senior-dev is ready...
+
+📝 Workspace: /workspaces/my-project
+📊 Truth Score: 0.972 ✅
+🧪 Test Coverage: 84%
+
+Type /help for commands or start coding...
+```
+
+## Background Execution
+
+Start sessions in background for long-running collaboration:
+
+```bash
+# Start in background
+claude-flow-novice pair --start --background
+
+# Monitor session
+claude-flow-novice pair status
+
+# View session output
+claude-flow-novice pair output session_id
+
+# End background session
+claude-flow-novice pair --end session_id
+```
+
+## Integration
+
+### With Git
+```bash
+claude-flow-novice pair --start --git --auto-commit
+```
+
+### With CI/CD
+```bash
+claude-flow-novice pair --start --ci --non-interactive
+```
+
+### With IDE
+```bash
+claude-flow-novice pair --start --ide vscode
+```
+
+## Best Practices
+
+1. **Clear Goals** - Define session objectives
+2. **Appropriate Mode** - Choose based on task
+3. **Enable Verification** - For critical code
+4. **Regular Testing** - Maintain quality
+5. **Session Notes** - Document decisions
+
+## Related Commands
+
+- `pair --end` - End current session
+- `pair --status` - Check session status
+- `pair --history` - View past sessions
+- `pair --config` - Configure defaults