docs: add teams_and_parallel_execution.md with coordination patterns and strategies

docs/tui/teams_and_parallel_execution.md

@@ -0,0 +1,210 @@
+# Teams and Parallel Execution
+
+> **⚡ CAI-Pro Exclusive Feature**  
+> The Terminal User Interface (TUI) is available exclusively in **CAI-Pro**. To access this feature and unlock advanced multi-agent workflows, visit [Alias Robotics](https://aliasrobotics.com) for more information.
+
+---
+
+Teams in CAI enable efficient parallel execution across multiple terminals, allowing you to coordinate specialized agents for complex security workflows.
+
+---
+
+## Quick Start with Teams
+
+1. **Navigate to Teams tab** in the sidebar
+2. **Click any team button** to configure all four terminals instantly
+3. **Send prompts** to individual terminals or broadcast to all
+4. **Switch teams** anytime to change your workflow strategy
+
+---
+
+## Parallel Execution Patterns
+
+### Pattern 1: Divide and Conquer
+
+Distribute different aspects of a target across terminals:
+
+```
+Terminal 1 (redteam): Web application testing
+Terminal 2 (redteam): API endpoint enumeration
+Terminal 3 (bug_bounter): Authentication bypass attempts
+Terminal 4 (bug_bounter): Input validation testing
+```
+
+**Example with Team 1** (2 Red + 2 Bug):
+
+```
+T1: Scan example.com for OWASP Top 10 vulnerabilities
+T2: Enumerate subdomains and check for takeover
+T3: Test for SQL injection in login forms
+T4: Analyze JWT token security
+```
+
+### Pattern 2: Phased Workflow
+
+Execute sequential phases across terminals:
+
+```
+Phase 1: Reconnaissance (all terminals)
+Phase 2: Vulnerability discovery (terminals 1-2)
+Phase 3: Exploitation (terminals 3-4)
+Phase 4: Validation (switch to retester agents)
+```
+
+**Example with Team 5** (Red + Blue + Retester + Bug):
+
+```
+T1: Initial reconnaissance and enumeration
+T2: Defensive posture analysis
+T3: Retest previously found vulnerabilities
+T4: Hunt for new bug bounty targets
+```
+
+### Pattern 3: Simultaneous Validation
+
+Test and validate in parallel:
+
+```
+Terminal 1-2: Discover vulnerabilities
+Terminal 3-4: Immediately validate findings
+```
+
+**Example with Team 6** (2 Red + 2 Retester):
+
+```
+T1: Find SQL injection points
+T2: Identify XSS vectors
+T3: Validate SQLi exploitability
+T4: Confirm XSS impact
+```
+
+---
+
+## Broadcasting Commands
+
+Send the same command to all terminals simultaneously:
+
+**Method 1: Add "all" flag**
+1. Type your command in the input area
+2. Add `all` at the end of your prompt
+3. Command executes on all four terminals in parallel
+
+**Example use cases**:
+- Broadcast reconnaissance: `Enumerate subdomains of example.com all`
+- Parallel vulnerability scan: `Scan target.com for SQL injection all`
+- Coordinated testing: `Test authentication mechanisms all`
+
+---
+
+## Team Selection Strategies
+
+### For Penetration Testing
+- **Team 1** (2 Red + 2 Bug): Comprehensive offensive testing
+- **Team 8** (4 Red): Maximum offensive coverage
+
+### For Bug Bounty Hunting
+- **Team 10** (4 Bug): Intensive vulnerability research
+- **Team 1** (2 Red + 2 Bug): Red team + bug bounty combination
+
+### For Defense Analysis
+- **Team 9** (4 Blue): Complete defensive posture review
+- **Team 3** (2 Red + 2 Blue): Offense/defense balance
+
+### For Validation Workflows
+- **Team 6** (2 Red + 2 Retester): Offensive + validation
+- **Team 11** (4 Retester): Comprehensive retest coverage
+
+### For Comprehensive Assessments
+- **Team 5** (Red + Blue + Retester + Bug): All-in-one workflow
+
+---
+
+## Coordination Tips
+
+### Context Sharing
+
+Share findings between terminals:
+
+```
+T1: discovered SQL injection in /api/users
+T2: /load T1 context and exploit the SQL injection
+```
+
+### Progressive Refinement
+
+Build on previous results:
+
+```
+T1: enumerate subdomains
+T2: scan the subdomains found by T1
+T3: test authentication on discovered services
+T4: validate exploitability of findings
+```
+
+### Role Specialization
+
+Assign specific roles to terminals:
+- **Scout**: Terminal 1 does reconnaissance
+- **Attacker**: Terminals 2-3 exploit findings
+- **Validator**: Terminal 4 confirms results
+
+---
+
+## Performance Optimization
+
+### Terminal Distribution
+- **Don't overload one terminal**: Distribute prompts evenly
+- **Monitor the queue**: Check Queue tab for bottlenecks
+- **Use available terminals**: Switch to idle terminals instead of queuing
+
+### Model Selection
+- **Fast models for reconnaissance**: Use `gpt-4o-mini` or `alias1` for enumeration
+- **Powerful models for exploitation**: Use `claude-sonnet-4.5` or `gpt-5` for complex tasks
+- **Mix models strategically**: Different models for different terminal roles
+
+### Cost Management
+- **Track stats**: Monitor usage in Stats tab
+- **Optimize prompts**: Be concise to reduce token consumption
+- **Use efficient teams**: Don't use 4 terminals if 2 suffice
+
+---
+
+## Advanced Patterns
+
+### Split Context Analysis
+
+Analyze scenarios from independent perspectives:
+- Each terminal maintains isolated context
+- Compare different approaches to the same problem
+- Identify blind spots through diverse analysis
+
+### Progressive Refinement
+
+Build comprehensive understanding through iterative analysis:
+- Terminal 1 identifies initial findings
+- Terminal 2 validates and expands on findings
+- Terminal 3 explores alternative approaches
+- Terminal 4 consolidates and refines results
+
+### Parallel Hypothesis Testing
+
+Test multiple theories simultaneously:
+- Each terminal investigates a different hypothesis
+- Compare results to identify the most viable approach
+- Accelerate discovery through parallel exploration
+
+---
+
+## Related Documentation
+
+- [Sidebar Features](sidebar_features.md) - Team configuration and management
+- [Terminals Management](terminals_management.md) - Multi-terminal control
+- [Commands Reference](commands_reference.md) - Terminal-specific commands
+- [User Interface](user_interface.md) - TUI layout and components
+
+---
+
+*Last updated: October 2025 | CAI TUI v0.6+*
+
+**Quick Reference**: Press `F1` or type `/help teams` for team-specific help.
+