claude-flow-novice 2.8.1 → 2.9.0

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

@@ -1,407 +0,0 @@
-# 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/commands/pair/start.md

@@ -1,209 +0,0 @@
-# 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