Marc Rejohn Castillano 5cb6561924 added ruflo

2026-04-09 19:01:53 +08:00

5.6 KiB

Raw Blame History

👥 Pair Programming Command

Collaborative development with real-time verification and AI assistance.

Overview

The pair command enables collaborative pair programming between you and AI agents, with real-time verification, code review, and quality enforcement.

Usage

claude-flow pair [--start] [options]

Quick Start

# Start pair programming session
claude-flow pair --start

# Start with specific agent
claude-flow pair --start --agent senior-dev

# Start with verification
claude-flow pair --start --verify --threshold 0.98

Options

--start - Start new pair programming session
--agent <name> - Specify AI pair partner (default: auto-select)
--verify - Enable real-time verification
--threshold <0-1> - Verification threshold (default: 0.95)
--mode <type> - Programming mode: driver, navigator, switch
--focus <area> - Focus area: refactor, test, debug, implement
--language <lang> - Primary language for session
--review - Enable continuous code review
--test - Run tests after each change

Modes

Driver Mode

You write code, AI provides suggestions and reviews.

claude-flow pair --start --mode driver

Navigator Mode

AI writes code, you provide guidance and review.

claude-flow pair --start --mode navigator

Switch Mode (Default)

Alternate between driver and navigator roles.

claude-flow pair --start --mode switch --interval 10m

Features

Real-Time Verification

Continuous truth checking (0.95 threshold)
Automatic rollback on verification failure
Quality gates before commits

Code Review

Instant feedback on code changes
Best practice suggestions
Security vulnerability detection
Performance optimization tips

Test Integration

Automatic test generation
Test-driven development support
Coverage monitoring
Integration test suggestions

Collaboration Tools

Shared context between you and AI
Session history and replay
Code explanation on demand
Learning from your preferences

Session Management

Start Session

# Basic start
claude-flow pair --start

# With configuration
claude-flow pair --start \
  --agent expert-coder \
  --verify \
  --test \
  --focus refactor

During Session

/help          - Show available commands
/explain       - Explain current code
/suggest       - Get improvement suggestions
/test          - Run tests
/verify        - Check verification score
/switch        - Switch driver/navigator roles
/focus <area>  - Change focus area
/commit        - Commit with verification
/pause         - Pause session
/resume        - Resume session
/end           - End session

End Session

# End and save session
claude-flow pair --end --save

# End and generate report
claude-flow pair --end --report

Examples

Refactoring Session

claude-flow pair --start \
  --focus refactor \
  --verify \
  --threshold 0.98

Test-Driven Development

claude-flow pair --start \
  --focus test \
  --mode tdd \
  --language javascript

Bug Fixing

claude-flow pair --start \
  --focus debug \
  --agent debugger-expert \
  --test

Code Review Session

claude-flow pair --start \
  --review \
  --verify \
  --agent senior-reviewer

Integration

With Git

# Auto-commit with verification
claude-flow pair --start --git --auto-commit

# Review before commit
claude-flow pair --start --git --review-commit

With Testing Frameworks

# Jest integration
claude-flow pair --start --test-framework jest

# Pytest integration
claude-flow pair --start --test-framework pytest

With CI/CD

# CI-friendly mode
claude-flow pair --start --ci --non-interactive

Session Output

👥 Pair Programming Session Started
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Partner: expert-coder
Mode: Switch (10m intervals)
Focus: Implementation
Verification: ✅ Enabled (0.95)
Testing: ✅ Auto-run

Current Role: DRIVER (you)
Navigator: expert-coder is reviewing...

📝 Working on: src/auth/login.js
Truth Score: 0.972 ✅
Test Coverage: 84% 📈

💡 Suggestion: Consider adding input validation for email field
🔍 Review: Line 23 - Potential SQL injection vulnerability

Type /help for commands or start coding...

Quality Metrics

Session Duration: Total pair programming time
Code Quality: Average truth score during session
Productivity: Lines changed, features completed
Learning: Patterns learned from collaboration
Test Coverage: Coverage improvement during session

Configuration

Configure pair programming in .claude-flow/config.json:

{
  "pair": {
    "defaultAgent": "expert-coder",
    "defaultMode": "switch",
    "switchInterval": "10m",
    "verification": {
      "enabled": true,
      "threshold": 0.95,
      "autoRollback": true
    },
    "testing": {
      "autoRun": true,
      "framework": "jest",
      "coverage": {
        "minimum": 80,
        "enforce": true
      }
    },
    "review": {
      "continuous": true,
      "preCommit": true
    }
  }
}

Best Practices

Start with Clear Goals: Define what you want to accomplish
Use Verification: Enable verification for critical code
Test Frequently: Run tests after significant changes
Review Together: Use review features for learning
Document Decisions: AI will help document why choices were made

verify - Standalone verification
truth - View quality metrics
test - Run test suites
review - Code review tools

5.6 KiB Raw Blame History