# Pair Programming Configuration Complete configuration guide for pair programming sessions. ## Configuration File Main configuration file: `.claude-flow/pair-config.json` ## Basic Configuration ```json { "pair": { "enabled": true, "defaultMode": "switch", "defaultAgent": "auto", "autoStart": false, "theme": "professional" } } ``` ## Complete Configuration ```json { "pair": { "general": { "enabled": true, "defaultMode": "switch", "defaultAgent": "senior-dev", "autoStart": false, "theme": "professional", "language": "javascript", "timezone": "UTC" }, "modes": { "driver": { "enabled": true, "suggestions": true, "realTimeReview": true, "autoComplete": false }, "navigator": { "enabled": true, "codeGeneration": true, "explanations": true, "alternatives": true }, "switch": { "enabled": true, "interval": "10m", "warning": "30s", "autoSwitch": true, "pauseOnIdle": true } }, "verification": { "enabled": true, "threshold": 0.95, "autoRollback": true, "preCommitCheck": true, "continuousMonitoring": true, "blockOnFailure": true }, "testing": { "enabled": true, "autoRun": true, "framework": "jest", "onSave": true, "coverage": { "enabled": true, "minimum": 80, "enforce": true, "reportFormat": "html" }, "watch": true, "parallel": true }, "review": { "enabled": true, "continuous": true, "preCommit": true, "security": true, "performance": true, "style": true, "complexity": { "maxComplexity": 10, "maxDepth": 4, "maxLines": 100 } }, "git": { "enabled": true, "autoCommit": false, "commitTemplate": "feat: {message}", "signCommits": false, "pushOnEnd": false, "branchProtection": true }, "session": { "autoSave": true, "saveInterval": "5m", "maxDuration": "4h", "idleTimeout": "15m", "breakReminder": "45m", "metricsInterval": "1m", "recordSession": false, "shareByDefault": false }, "ai": { "model": "advanced", "temperature": 0.7, "maxTokens": 4000, "contextWindow": 8000, "personality": "professional", "expertise": ["backend", "testing", "security"], "learningEnabled": true }, "interface": { "theme": "dark", "fontSize": 14, "showMetrics": true, "notifications": true, "sounds": false, "shortcuts": { "switch": "ctrl+shift+s", "suggest": "ctrl+space", "review": "ctrl+r", "test": "ctrl+t" } }, "quality": { "linting": { "enabled": true, "autoFix": true, "rules": "standard" }, "formatting": { "enabled": true, "autoFormat": true, "style": "prettier" }, "documentation": { "required": true, "format": "jsdoc", "checkCompleteness": true } }, "advanced": { "parallelSessions": false, "multiAgent": false, "customAgents": [], "plugins": [], "webhooks": { "onStart": "", "onEnd": "", "onCommit": "", "onError": "" } } } } ``` ## Agent Configuration ### Built-in Agents ```json { "agents": { "senior-dev": { "expertise": ["architecture", "patterns", "optimization"], "style": "thorough", "reviewLevel": "strict" }, "tdd-specialist": { "expertise": ["testing", "mocks", "coverage"], "style": "test-first", "reviewLevel": "comprehensive" }, "debugger-expert": { "expertise": ["debugging", "profiling", "tracing"], "style": "analytical", "reviewLevel": "focused" }, "junior-dev": { "expertise": ["learning", "basics", "documentation"], "style": "questioning", "reviewLevel": "educational" } } } ``` ### Custom Agents ```json { "customAgents": [ { "id": "security-expert", "name": "Security Specialist", "expertise": ["security", "cryptography", "vulnerabilities"], "personality": "cautious", "prompts": { "review": "Focus on security vulnerabilities", "suggest": "Prioritize secure coding practices" } } ] } ``` ## Mode-Specific Configuration ### Driver Mode ```json { "driver": { "autocomplete": { "enabled": false, "delay": 500, "minChars": 3 }, "suggestions": { "enabled": true, "frequency": "onChange", "inline": true }, "review": { "realTime": true, "highlighting": true, "annotations": true } } } ``` ### Navigator Mode ```json { "navigator": { "generation": { "style": "verbose", "comments": true, "tests": true }, "explanation": { "level": "detailed", "examples": true, "alternatives": 3 } } } ``` ### Switch Mode ```json { "switch": { "intervals": { "default": "10m", "minimum": "5m", "maximum": "30m" }, "handoff": { "summary": true, "context": true, "nextSteps": true } } } ``` ## Quality Thresholds ```json { "thresholds": { "verification": { "error": 0.90, "warning": 0.95, "success": 0.98 }, "coverage": { "error": 70, "warning": 80, "success": 90 }, "complexity": { "error": 15, "warning": 10, "success": 5 } } } ``` ## Language-Specific Settings ### JavaScript/TypeScript ```json { "languages": { "javascript": { "framework": "react", "linter": "eslint", "formatter": "prettier", "testRunner": "jest", "transpiler": "babel" } } } ``` ### Python ```json { "languages": { "python": { "version": "3.11", "linter": "pylint", "formatter": "black", "testRunner": "pytest", "typeChecker": "mypy" } } } ``` ## Environment Variables ```bash # Override configuration via environment export CLAUDE_PAIR_MODE=driver export CLAUDE_PAIR_VERIFY=true export CLAUDE_PAIR_THRESHOLD=0.98 export CLAUDE_PAIR_AGENT=senior-dev export CLAUDE_PAIR_AUTO_TEST=true ``` ## CLI Configuration ### Set Configuration ```bash # Set single value claude-flow pair config set defaultMode switch # Set nested value claude-flow pair config set verification.threshold 0.98 # Set from file claude-flow pair config import config.json ``` ### Get Configuration ```bash # Get all configuration claude-flow pair config get # Get specific value claude-flow pair config get defaultMode # Export configuration claude-flow pair config export > config.json ``` ### Reset Configuration ```bash # Reset to defaults claude-flow pair config reset # Reset specific section claude-flow pair config reset verification ``` ## Profile Management ### Create Profile ```bash claude-flow pair profile create refactoring \ --mode driver \ --verify true \ --threshold 0.98 \ --focus refactor ``` ### Use Profile ```bash claude-flow pair --start --profile refactoring ``` ### List Profiles ```bash claude-flow pair profile list ``` ### Profiles Configuration ```json { "profiles": { "refactoring": { "mode": "driver", "verification": { "enabled": true, "threshold": 0.98 }, "focus": "refactor" }, "debugging": { "mode": "navigator", "agent": "debugger-expert", "trace": true, "verbose": true }, "learning": { "mode": "mentor", "pace": "slow", "explanations": "detailed", "examples": true } } } ``` ## Workspace Configuration ### Project-Specific `.claude-flow/pair-config.json` in project root ### User-Specific `~/.claude-flow/pair-config.json` ### Global `/etc/claude-flow/pair-config.json` ### Priority Order 1. Command-line arguments 2. Environment variables 3. Project configuration 4. User configuration 5. Global configuration 6. Built-in defaults ## Configuration Validation ```bash # Validate configuration claude-flow pair config validate # Test configuration claude-flow pair config test ``` ## Migration ### From Version 1.x ```bash claude-flow pair config migrate --from 1.x ``` ### Export/Import ```bash # Export current config claude-flow pair config export > my-config.json # Import config claude-flow pair config import my-config.json ``` ## Best Practices 1. **Start Simple** - Use defaults, customize as needed 2. **Version Control** - Commit project config 3. **Team Standards** - Share configurations 4. **Regular Review** - Update thresholds based on metrics 5. **Profile Usage** - Create profiles for common scenarios ## Troubleshooting ### Configuration Not Loading - Check file syntax (JSON) - Verify file permissions - Check priority order - Validate configuration ### Settings Not Applied - Restart session - Clear cache - Check overrides - Review logs ## Related Documentation - [Getting Started](./README.md) - [Session Management](./session.md) - [Modes](./modes.md) - [Templates](./templates.md)