@claude-flow/cli 3.0.2 → 3.1.0-alpha.2

package/.claude/commands/pair/examples.md

@@ -0,0 +1,512 @@
+# Pair Programming Examples
+
+Real-world examples and scenarios for pair programming sessions.
+
+## Example 1: Feature Implementation
+
+### Scenario
+Implementing a user authentication feature with JWT tokens.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode switch \
+  --agent senior-dev \
+  --focus implement \
+  --verify \
+  --test
+```
+
+### Session Flow
+```
+👥 Starting pair programming for authentication feature...
+
+[DRIVER: You - 10 minutes]
+/explain JWT authentication flow
+> AI explains JWT concepts and best practices
+
+/suggest implementation approach
+> AI suggests using middleware pattern with refresh tokens
+
+# You write the basic auth middleware structure
+
+[SWITCH TO NAVIGATOR]
+
+[NAVIGATOR: AI - 10 minutes]
+/implement JWT token generation with refresh tokens
+> AI generates secure token implementation
+
+/test-gen
+> AI creates comprehensive test suite
+
+[SWITCH TO DRIVER]
+
+[DRIVER: You - 10 minutes]
+# You refine the implementation
+/review --security
+> AI performs security review, suggests improvements
+
+/commit --message "feat: JWT authentication with refresh tokens"
+✅ Truth Score: 0.98 - Committed successfully
+```
+
+## Example 2: Bug Fixing Session
+
+### Scenario
+Debugging a memory leak in a Node.js application.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode navigator \
+  --agent debugger-expert \
+  --focus debug \
+  --trace
+```
+
+### Session Flow
+```
+👥 Starting debugging session...
+
+/status
+> Analyzing application for memory issues...
+
+/perf --profile
+> Memory usage growing: 150MB → 450MB over 10 minutes
+
+/find "new EventEmitter" --regex
+> Found 3 instances of EventEmitter creation
+
+/inspect eventEmitters --deep
+> Discovering listeners not being removed
+
+/suggest fix for memory leak
+> AI suggests: "Add removeListener in cleanup functions"
+
+/implement cleanup functions for all event emitters
+> AI generates proper cleanup code
+
+/test
+> Memory stable at 150MB ✅
+
+/commit --message "fix: memory leak in event emitters"
+```
+
+## Example 3: Test-Driven Development
+
+### Scenario
+Building a shopping cart feature using TDD.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode tdd \
+  --agent tdd-specialist \
+  --test-first
+```
+
+### Session Flow
+```
+👥 TDD Session: Shopping Cart Feature
+
+[RED PHASE]
+/test-gen "add item to cart"
+> AI writes failing test:
+  ✗ should add item to cart
+  ✗ should update quantity for existing item
+  ✗ should calculate total price
+
+[GREEN PHASE]
+/implement minimal cart functionality
+> You write just enough code to pass tests
+
+/test
+> Tests passing: 3/3 ✅
+
+[REFACTOR PHASE]
+/refactor --pattern repository
+> AI refactors to repository pattern
+
+/test
+> Tests still passing: 3/3 ✅
+
+[NEXT CYCLE]
+/test-gen "remove item from cart"
+> AI writes new failing tests...
+```
+
+## Example 4: Code Refactoring
+
+### Scenario
+Refactoring legacy code to modern patterns.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode driver \
+  --focus refactor \
+  --verify \
+  --threshold 0.98
+```
+
+### Session Flow
+```
+👥 Refactoring Session: Modernizing UserService
+
+/analyze UserService.js
+> AI identifies:
+  - Callback hell (5 levels deep)
+  - No error handling
+  - Tight coupling
+  - No tests
+
+/suggest refactoring plan
+> AI suggests:
+  1. Convert callbacks to async/await
+  2. Add error boundaries
+  3. Extract dependencies
+  4. Add unit tests
+
+/test-gen --before-refactor
+> AI generates tests for current behavior
+
+/refactor callbacks to async/await
+# You refactor with AI guidance
+
+/test
+> All tests passing ✅
+
+/review --compare
+> AI shows before/after comparison
+> Code complexity: 35 → 12
+> Truth score: 0.99 ✅
+
+/commit --message "refactor: modernize UserService with async/await"
+```
+
+## Example 5: Learning Session
+
+### Scenario
+Learning React hooks with AI mentorship.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode mentor \
+  --agent react-expert \
+  --pace slow \
+  --examples
+```
+
+### Session Flow
+```
+👥 Learning Session: React Hooks
+
+/learn useState hook
+> AI explains with interactive examples
+
+/example custom hook for API calls
+> AI shows best practice implementation:
+```javascript
+function useApi(url) {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  
+  useEffect(() => {
+    // Implementation explained step by step
+  }, [url]);
+  
+  return { data, loading, error };
+}
+```
+
+/implement my own custom hook
+# You write with AI guidance
+
+/review --educational
+> AI provides detailed feedback with learning points
+
+/quiz react hooks
+> AI tests your understanding
+> Score: 8/10 - Good progress!
+```
+
+## Example 6: Performance Optimization
+
+### Scenario
+Optimizing a slow React application.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode switch \
+  --agent performance-expert \
+  --focus optimize \
+  --profile
+```
+
+### Session Flow
+```
+👥 Performance Optimization Session
+
+/perf --profile
+> React DevTools Profiler Results:
+  - ProductList: 450ms render
+  - CartSummary: 200ms render
+  - Unnecessary re-renders: 15
+
+/suggest optimizations for ProductList
+> AI suggests:
+  1. Add React.memo
+  2. Use useMemo for expensive calculations
+  3. Implement virtualization for long lists
+
+/implement React.memo and useMemo
+# You implement with AI guidance
+
+/perf --profile
+> ProductList: 45ms render (90% improvement!) ✅
+
+/implement virtualization with react-window
+> AI implements virtual scrolling
+
+/perf --profile
+> ProductList: 12ms render (97% improvement!) ✅
+> FPS: 60 stable ✅
+
+/commit --message "perf: optimize ProductList with memoization and virtualization"
+```
+
+## Example 7: API Development
+
+### Scenario
+Building a RESTful API with Express.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode navigator \
+  --agent backend-expert \
+  --focus implement \
+  --test
+```
+
+### Session Flow
+```
+👥 API Development Session
+
+/design REST API for blog platform
+> AI designs endpoints:
+  POST   /api/posts
+  GET    /api/posts
+  GET    /api/posts/:id
+  PUT    /api/posts/:id
+  DELETE /api/posts/:id
+
+/implement CRUD endpoints with validation
+> AI implements with Express + Joi validation
+
+/test-gen --integration
+> AI generates integration tests
+
+/security --api
+> AI adds:
+  - Rate limiting
+  - Input sanitization
+  - JWT authentication
+  - CORS configuration
+
+/document --openapi
+> AI generates OpenAPI documentation
+
+/test --integration
+> All endpoints tested: 15/15 ✅
+
+/deploy --staging
+> API deployed to staging environment
+```
+
+## Example 8: Database Migration
+
+### Scenario
+Migrating from MongoDB to PostgreSQL.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode switch \
+  --agent database-expert \
+  --verify \
+  --test
+```
+
+### Session Flow
+```
+👥 Database Migration Session
+
+/analyze MongoDB schema
+> AI maps current structure:
+  - users collection → users table
+  - posts collection → posts table
+  - Embedded comments → comments table with FK
+
+/design PostgreSQL schema
+> AI creates normalized schema with relations
+
+/implement migration script
+# You write migration with AI assistance
+
+/test --migration --sample-data
+> Migration successful for 10,000 records ✅
+
+/implement data access layer
+> AI creates repository pattern implementation
+
+/test --integration
+> All queries working correctly ✅
+
+/verify data integrity
+> Truth score: 0.995 ✅
+> No data loss detected
+```
+
+## Example 9: CI/CD Pipeline
+
+### Scenario
+Setting up GitHub Actions CI/CD pipeline.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode navigator \
+  --agent devops-expert \
+  --focus implement
+```
+
+### Session Flow
+```
+👥 CI/CD Pipeline Setup
+
+/implement GitHub Actions workflow
+> AI creates .github/workflows/ci.yml:
+  - Build on push/PR
+  - Run tests
+  - Check coverage
+  - Deploy to staging
+
+/test --ci --dry-run
+> Pipeline simulation successful ✅
+
+/implement deployment to production
+> AI adds:
+  - Manual approval step
+  - Rollback capability
+  - Health checks
+  - Notifications
+
+/security --scan-pipeline
+> AI adds security scanning:
+  - Dependency scanning
+  - Container scanning
+  - Secret scanning
+
+/commit --message "ci: complete CI/CD pipeline with security scanning"
+```
+
+## Example 10: Mobile App Development
+
+### Scenario
+Building a React Native mobile feature.
+
+### Session Setup
+```bash
+claude-flow pair --start \
+  --mode switch \
+  --agent mobile-expert \
+  --language react-native \
+  --test
+```
+
+### Session Flow
+```
+👥 Mobile Development Session
+
+/implement offline-first data sync
+> AI implements:
+  - Local SQLite storage
+  - Queue for pending changes
+  - Sync on connection restore
+  - Conflict resolution
+
+/test --device ios simulator
+> Feature working on iOS ✅
+
+/test --device android emulator
+> Feature working on Android ✅
+
+/optimize --mobile
+> AI optimizes:
+  - Reduces bundle size by 30%
+  - Implements lazy loading
+  - Adds image caching
+
+/review --accessibility
+> AI ensures:
+  - Screen reader support
+  - Proper contrast ratios
+  - Touch target sizes
+
+/commit --message "feat: offline-first sync with optimizations"
+```
+
+## Common Patterns
+
+### Starting Patterns
+```bash
+# Quick start for common scenarios
+claude-flow pair --template <template>
+```
+
+Available templates:
+- `feature` - New feature development
+- `bugfix` - Bug fixing session
+- `refactor` - Code refactoring
+- `optimize` - Performance optimization
+- `test` - Test writing
+- `review` - Code review
+- `learn` - Learning session
+
+### Session Commands Flow
+
+#### Typical Feature Development
+```
+/start → /explain → /design → /implement → /test → /review → /commit → /end
+```
+
+#### Typical Bug Fix
+```
+/start → /reproduce → /debug → /trace → /fix → /test → /verify → /commit → /end
+```
+
+#### Typical Refactoring
+```
+/start → /analyze → /plan → /test-gen → /refactor → /test → /review → /commit → /end
+```
+
+## Best Practices from Examples
+
+1. **Always Start with Context** - Use `/explain` or `/analyze`
+2. **Test Early and Often** - Run tests after each change
+3. **Verify Before Commit** - Check truth scores
+4. **Document Decisions** - Use `/note` for important choices
+5. **Review Security** - Always run `/security` for sensitive code
+6. **Profile Performance** - Use `/perf` for optimization
+7. **Save Sessions** - Use `/save` for complex work
+
+## Related Documentation
+
+- [Getting Started](./README.md)
+- [Session Management](./session.md)
+- [Commands Reference](./commands.md)
+- [Configuration](./config.md)