👥 Pair Programming

The Pair Programming skill provides human-AI collaborative coding with role switching, TDD support, and real-time verification.

Modes

Mode	Human Role	AI Role	Best For
Driver	Writing code	Reviewing, suggesting	Learning, exploration
Navigator	Directing, reviewing	Writing code	High productivity
Switch	Alternating	Alternating	Balanced collaboration
TDD	Writing tests	Implementing	Test-first development

Starting a Session

bash
# Start pair programming
/pair-programming

# Or with specific mode
/pair-programming --mode tdd

# Via CLI
npx ruflo@latest pair start --mode navigator

TDD Mode Workflow

┌─────────────────────────────────────────────────────────────────────┐
│                     TDD PAIR PROGRAMMING                            │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  1. Human writes failing test                                       │
│           ↓                                                         │
│  2. AI implements minimal code to pass                              │
│           ↓                                                         │
│  3. Tests run automatically                                         │
│           ↓                                                         │
│  4. AI suggests refactoring                                         │
│           ↓                                                         │
│  5. Human approves/modifies                                         │
│           ↓                                                         │
│  6. Repeat                                                          │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

Features

Feature	Description
Real-time Verification	Code is continuously verified as you write
Quality Monitoring	Track code quality metrics during session
Automatic Role Switch	Switches roles based on context
Security Scanning	Built-in security checks
Performance Hints	Suggestions for optimization
Learning Mode	AI explains decisions and teaches patterns

Session Commands

bash
# Switch roles mid-session
npx ruflo@latest pair switch

# Get AI explanation
npx ruflo@latest pair explain

# Run tests
npx ruflo@latest pair test

# End session with summary
npx ruflo@latest pair end