claude-flow 3.6.30 → 3.7.0-alpha.10

package/.claude/commands/github/multi-repo-swarm.md

@@ -1,519 +1,519 @@
-# Multi-Repo Swarm - Cross-Repository Swarm Orchestration
-
-## Overview
-Coordinate AI swarms across multiple repositories, enabling organization-wide automation and intelligent cross-project collaboration.
-
-## Core Features
-
-### 1. Cross-Repo Initialization
-```bash
-# Initialize multi-repo swarm with gh CLI
-# List organization repositories
-REPOS=$(gh repo list org --limit 100 --json name,description,languages \
-  --jq '.[] | select(.name | test("frontend|backend|shared"))')
-
-# Get repository details
-REPO_DETAILS=$(echo "$REPOS" | jq -r '.name' | while read -r repo; do
-  gh api repos/org/$repo --jq '{name, default_branch, languages, topics}'
-done | jq -s '.')
-
-# Initialize swarm with repository context
-npx ruv-swarm github multi-repo-init \
-  --repo-details "$REPO_DETAILS" \
-  --repos "org/frontend,org/backend,org/shared" \
-  --topology hierarchical \
-  --shared-memory \
-  --sync-strategy eventual
-```
-
-### 2. Repository Discovery
-```bash
-# Auto-discover related repositories with gh CLI
-# Search organization repositories
-REPOS=$(gh repo list my-organization --limit 100 \
-  --json name,description,languages,topics \
-  --jq '.[] | select(.languages | keys | contains(["TypeScript"]))')
-
-# Analyze repository dependencies
-DEPS=$(echo "$REPOS" | jq -r '.name' | while read -r repo; do
-  # Get package.json if it exists
-  if gh api repos/my-organization/$repo/contents/package.json --jq '.content' 2>/dev/null; then
-    gh api repos/my-organization/$repo/contents/package.json \
-      --jq '.content' | base64 -d | jq '{name, dependencies, devDependencies}'
-  fi
-done | jq -s '.')
-
-# Discover and analyze
-npx ruv-swarm github discover-repos \
-  --repos "$REPOS" \
-  --dependencies "$DEPS" \
-  --analyze-dependencies \
-  --suggest-swarm-topology
-```
-
-### 3. Synchronized Operations
-```bash
-# Execute synchronized changes across repos with gh CLI
-# Get matching repositories
-MATCHING_REPOS=$(gh repo list org --limit 100 --json name \
-  --jq '.[] | select(.name | test("-service$")) | .name')
-
-# Execute task and create PRs
-echo "$MATCHING_REPOS" | while read -r repo; do
-  # Clone repo
-  gh repo clone org/$repo /tmp/$repo -- --depth=1
-  
-  # Execute task
-  cd /tmp/$repo
-  npx ruv-swarm github task-execute \
-    --task "update-dependencies" \
-    --repo "org/$repo"
-  
-  # Create PR if changes exist
-  if [[ -n $(git status --porcelain) ]]; then
-    git checkout -b update-dependencies-$(date +%Y%m%d)
-    git add -A
-    git commit -m "chore: Update dependencies"
-    
-    # Push and create PR
-    git push origin HEAD
-    PR_URL=$(gh pr create \
-      --title "Update dependencies" \
-      --body "Automated dependency update across services" \
-      --label "dependencies,automated")
-    
-    echo "$PR_URL" >> /tmp/created-prs.txt
-  fi
-  cd -
-done
-
-# Link related PRs
-PR_URLS=$(cat /tmp/created-prs.txt)
-npx ruv-swarm github link-prs --urls "$PR_URLS"
-```
-
-## Configuration
-
-### Multi-Repo Config File
-```yaml
-# .swarm/multi-repo.yml
-version: 1
-organization: my-org
-repositories:
-  - name: frontend
-    url: github.com/my-org/frontend
-    role: ui
-    agents: [coder, designer, tester]
-    
-  - name: backend
-    url: github.com/my-org/backend
-    role: api
-    agents: [architect, coder, tester]
-    
-  - name: shared
-    url: github.com/my-org/shared
-    role: library
-    agents: [analyst, coder]
-
-coordination:
-  topology: hierarchical
-  communication: webhook
-  memory: redis://shared-memory
-  
-dependencies:
-  - from: frontend
-    to: [backend, shared]
-  - from: backend
-    to: [shared]
-```
-
-### Repository Roles
-```javascript
-// Define repository roles and responsibilities
-{
-  "roles": {
-    "ui": {
-      "responsibilities": ["user-interface", "ux", "accessibility"],
-      "default-agents": ["designer", "coder", "tester"]
-    },
-    "api": {
-      "responsibilities": ["endpoints", "business-logic", "data"],
-      "default-agents": ["architect", "coder", "security"]
-    },
-    "library": {
-      "responsibilities": ["shared-code", "utilities", "types"],
-      "default-agents": ["analyst", "coder", "documenter"]
-    }
-  }
-}
-```
-
-## Orchestration Commands
-
-### Dependency Management
-```bash
-# Update dependencies across all repos with gh CLI
-# Create tracking issue first
-TRACKING_ISSUE=$(gh issue create \
-  --title "Dependency Update: typescript@5.0.0" \
-  --body "Tracking issue for updating TypeScript across all repositories" \
-  --label "dependencies,tracking" \
-  --json number -q .number)
-
-# Get all repos with TypeScript
-TS_REPOS=$(gh repo list org --limit 100 --json name | jq -r '.[].name' | \
-  while read -r repo; do
-    if gh api repos/org/$repo/contents/package.json 2>/dev/null | \
-       jq -r '.content' | base64 -d | grep -q '"typescript"'; then
-      echo "$repo"
-    fi
-  done)
-
-# Update each repository
-echo "$TS_REPOS" | while read -r repo; do
-  # Clone and update
-  gh repo clone org/$repo /tmp/$repo -- --depth=1
-  cd /tmp/$repo
-  
-  # Update dependency
-  npm install --save-dev typescript@5.0.0
-  
-  # Test changes
-  if npm test; then
-    # Create PR
-    git checkout -b update-typescript-5
-    git add package.json package-lock.json
-    git commit -m "chore: Update TypeScript to 5.0.0
-
-Part of #$TRACKING_ISSUE"
-    
-    git push origin HEAD
-    gh pr create \
-      --title "Update TypeScript to 5.0.0" \
-      --body "Updates TypeScript to version 5.0.0\n\nTracking: #$TRACKING_ISSUE" \
-      --label "dependencies"
-  else
-    # Report failure
-    gh issue comment $TRACKING_ISSUE \
-      --body "❌ Failed to update $repo - tests failing"
-  fi
-  cd -
-done
-```
-
-### Refactoring Operations
-```bash
-# Coordinate large-scale refactoring
-npx ruv-swarm github multi-repo-refactor \
-  --pattern "rename:OldAPI->NewAPI" \
-  --analyze-impact \
-  --create-migration-guide \
-  --staged-rollout
-```
-
-### Security Updates
-```bash
-# Coordinate security patches
-npx ruv-swarm github multi-repo-security \
-  --scan-all \
-  --patch-vulnerabilities \
-  --verify-fixes \
-  --compliance-report
-```
-
-## Communication Strategies
-
-### 1. Webhook-Based Coordination
-```javascript
-// webhook-coordinator.js
-const { MultiRepoSwarm } = require('ruv-swarm');
-
-const swarm = new MultiRepoSwarm({
-  webhook: {
-    url: 'https://swarm-coordinator.example.com',
-    secret: process.env.WEBHOOK_SECRET
-  }
-});
-
-// Handle cross-repo events
-swarm.on('repo:update', async (event) => {
-  await swarm.propagate(event, {
-    to: event.dependencies,
-    strategy: 'eventual-consistency'
-  });
-});
-```
-
-### 2. GraphQL Federation
-```graphql
-# Federated schema for multi-repo queries
-type Repository @key(fields: "id") {
-  id: ID!
-  name: String!
-  swarmStatus: SwarmStatus!
-  dependencies: [Repository!]!
-  agents: [Agent!]!
-}
-
-type SwarmStatus {
-  active: Boolean!
-  topology: Topology!
-  tasks: [Task!]!
-  memory: JSON!
-}
-```
-
-### 3. Event Streaming
-```yaml
-# Kafka configuration for real-time coordination
-kafka:
-  brokers: ['kafka1:9092', 'kafka2:9092']
-  topics:
-    swarm-events: 
-      partitions: 10
-      replication: 3
-    swarm-memory:
-      partitions: 5
-      replication: 3
-```
-
-## Advanced Features
-
-### 1. Distributed Task Queue
-```bash
-# Create distributed task queue
-npx ruv-swarm github multi-repo-queue \
-  --backend redis \
-  --workers 10 \
-  --priority-routing \
-  --dead-letter-queue
-```
-
-### 2. Cross-Repo Testing
-```bash
-# Run integration tests across repos
-npx ruv-swarm github multi-repo-test \
-  --setup-test-env \
-  --link-services \
-  --run-e2e \
-  --tear-down
-```
-
-### 3. Monorepo Migration
-```bash
-# Assist in monorepo migration
-npx ruv-swarm github to-monorepo \
-  --analyze-repos \
-  --suggest-structure \
-  --preserve-history \
-  --create-migration-prs
-```
-
-## Monitoring & Visualization
-
-### Multi-Repo Dashboard
-```bash
-# Launch monitoring dashboard
-npx ruv-swarm github multi-repo-dashboard \
-  --port 3000 \
-  --metrics "agent-activity,task-progress,memory-usage" \
-  --real-time
-```
-
-### Dependency Graph
-```bash
-# Visualize repo dependencies
-npx ruv-swarm github dep-graph \
-  --format mermaid \
-  --include-agents \
-  --show-data-flow
-```
-
-### Health Monitoring
-```bash
-# Monitor swarm health across repos
-npx ruv-swarm github health-check \
-  --repos "org/*" \
-  --check "connectivity,memory,agents" \
-  --alert-on-issues
-```
-
-## Synchronization Patterns
-
-### 1. Eventually Consistent
-```javascript
-// Eventual consistency for non-critical updates
-{
-  "sync": {
-    "strategy": "eventual",
-    "max-lag": "5m",
-    "retry": {
-      "attempts": 3,
-      "backoff": "exponential"
-    }
-  }
-}
-```
-
-### 2. Strong Consistency
-```javascript
-// Strong consistency for critical operations
-{
-  "sync": {
-    "strategy": "strong",
-    "consensus": "raft",
-    "quorum": 0.51,
-    "timeout": "30s"
-  }
-}
-```
-
-### 3. Hybrid Approach
-```javascript
-// Mix of consistency levels
-{
-  "sync": {
-    "default": "eventual",
-    "overrides": {
-      "security-updates": "strong",
-      "dependency-updates": "strong",
-      "documentation": "eventual"
-    }
-  }
-}
-```
-
-## Use Cases
-
-### 1. Microservices Coordination
-```bash
-# Coordinate microservices development
-npx ruv-swarm github microservices \
-  --services "auth,users,orders,payments" \
-  --ensure-compatibility \
-  --sync-contracts \
-  --integration-tests
-```
-
-### 2. Library Updates
-```bash
-# Update shared library across consumers
-npx ruv-swarm github lib-update \
-  --library "org/shared-lib" \
-  --version "2.0.0" \
-  --find-consumers \
-  --update-imports \
-  --run-tests
-```
-
-### 3. Organization-Wide Changes
-```bash
-# Apply org-wide policy changes
-npx ruv-swarm github org-policy \
-  --policy "add-security-headers" \
-  --repos "org/*" \
-  --validate-compliance \
-  --create-reports
-```
-
-## Best Practices
-
-### 1. Repository Organization
-- Clear repository roles and boundaries
-- Consistent naming conventions
-- Documented dependencies
-- Shared configuration standards
-
-### 2. Communication
-- Use appropriate sync strategies
-- Implement circuit breakers
-- Monitor latency and failures
-- Clear error propagation
-
-### 3. Security
-- Secure cross-repo authentication
-- Encrypted communication channels
-- Audit trail for all operations
-- Principle of least privilege
-
-## Performance Optimization
-
-### Caching Strategy
-```bash
-# Implement cross-repo caching
-npx ruv-swarm github cache-strategy \
-  --analyze-patterns \
-  --suggest-cache-layers \
-  --implement-invalidation
-```
-
-### Parallel Execution
-```bash
-# Optimize parallel operations
-npx ruv-swarm github parallel-optimize \
-  --analyze-dependencies \
-  --identify-parallelizable \
-  --execute-optimal
-```
-
-### Resource Pooling
-```bash
-# Pool resources across repos
-npx ruv-swarm github resource-pool \
-  --share-agents \
-  --distribute-load \
-  --monitor-usage
-```
-
-## Troubleshooting
-
-### Connectivity Issues
-```bash
-# Diagnose connectivity problems
-npx ruv-swarm github diagnose-connectivity \
-  --test-all-repos \
-  --check-permissions \
-  --verify-webhooks
-```
-
-### Memory Synchronization
-```bash
-# Debug memory sync issues
-npx ruv-swarm github debug-memory \
-  --check-consistency \
-  --identify-conflicts \
-  --repair-state
-```
-
-### Performance Bottlenecks
-```bash
-# Identify performance issues
-npx ruv-swarm github perf-analysis \
-  --profile-operations \
-  --identify-bottlenecks \
-  --suggest-optimizations
-```
-
-## Examples
-
-### Full-Stack Application Update
-```bash
-# Update full-stack application
-npx ruv-swarm github fullstack-update \
-  --frontend "org/web-app" \
-  --backend "org/api-server" \
-  --database "org/db-migrations" \
-  --coordinate-deployment
-```
-
-### Cross-Team Collaboration
-```bash
-# Facilitate cross-team work
-npx ruv-swarm github cross-team \
-  --teams "frontend,backend,devops" \
-  --task "implement-feature-x" \
-  --assign-by-expertise \
-  --track-progress
-```
-
+# Multi-Repo Swarm - Cross-Repository Swarm Orchestration
+
+## Overview
+Coordinate AI swarms across multiple repositories, enabling organization-wide automation and intelligent cross-project collaboration.
+
+## Core Features
+
+### 1. Cross-Repo Initialization
+```bash
+# Initialize multi-repo swarm with gh CLI
+# List organization repositories
+REPOS=$(gh repo list org --limit 100 --json name,description,languages \
+  --jq '.[] | select(.name | test("frontend|backend|shared"))')
+
+# Get repository details
+REPO_DETAILS=$(echo "$REPOS" | jq -r '.name' | while read -r repo; do
+  gh api repos/org/$repo --jq '{name, default_branch, languages, topics}'
+done | jq -s '.')
+
+# Initialize swarm with repository context
+npx ruv-swarm github multi-repo-init \
+  --repo-details "$REPO_DETAILS" \
+  --repos "org/frontend,org/backend,org/shared" \
+  --topology hierarchical \
+  --shared-memory \
+  --sync-strategy eventual
+```
+
+### 2. Repository Discovery
+```bash
+# Auto-discover related repositories with gh CLI
+# Search organization repositories
+REPOS=$(gh repo list my-organization --limit 100 \
+  --json name,description,languages,topics \
+  --jq '.[] | select(.languages | keys | contains(["TypeScript"]))')
+
+# Analyze repository dependencies
+DEPS=$(echo "$REPOS" | jq -r '.name' | while read -r repo; do
+  # Get package.json if it exists
+  if gh api repos/my-organization/$repo/contents/package.json --jq '.content' 2>/dev/null; then
+    gh api repos/my-organization/$repo/contents/package.json \
+      --jq '.content' | base64 -d | jq '{name, dependencies, devDependencies}'
+  fi
+done | jq -s '.')
+
+# Discover and analyze
+npx ruv-swarm github discover-repos \
+  --repos "$REPOS" \
+  --dependencies "$DEPS" \
+  --analyze-dependencies \
+  --suggest-swarm-topology
+```
+
+### 3. Synchronized Operations
+```bash
+# Execute synchronized changes across repos with gh CLI
+# Get matching repositories
+MATCHING_REPOS=$(gh repo list org --limit 100 --json name \
+  --jq '.[] | select(.name | test("-service$")) | .name')
+
+# Execute task and create PRs
+echo "$MATCHING_REPOS" | while read -r repo; do
+  # Clone repo
+  gh repo clone org/$repo /tmp/$repo -- --depth=1
+  
+  # Execute task
+  cd /tmp/$repo
+  npx ruv-swarm github task-execute \
+    --task "update-dependencies" \
+    --repo "org/$repo"
+  
+  # Create PR if changes exist
+  if [[ -n $(git status --porcelain) ]]; then
+    git checkout -b update-dependencies-$(date +%Y%m%d)
+    git add -A
+    git commit -m "chore: Update dependencies"
+    
+    # Push and create PR
+    git push origin HEAD
+    PR_URL=$(gh pr create \
+      --title "Update dependencies" \
+      --body "Automated dependency update across services" \
+      --label "dependencies,automated")
+    
+    echo "$PR_URL" >> /tmp/created-prs.txt
+  fi
+  cd -
+done
+
+# Link related PRs
+PR_URLS=$(cat /tmp/created-prs.txt)
+npx ruv-swarm github link-prs --urls "$PR_URLS"
+```
+
+## Configuration
+
+### Multi-Repo Config File
+```yaml
+# .swarm/multi-repo.yml
+version: 1
+organization: my-org
+repositories:
+  - name: frontend
+    url: github.com/my-org/frontend
+    role: ui
+    agents: [coder, designer, tester]
+    
+  - name: backend
+    url: github.com/my-org/backend
+    role: api
+    agents: [architect, coder, tester]
+    
+  - name: shared
+    url: github.com/my-org/shared
+    role: library
+    agents: [analyst, coder]
+
+coordination:
+  topology: hierarchical
+  communication: webhook
+  memory: redis://shared-memory
+  
+dependencies:
+  - from: frontend
+    to: [backend, shared]
+  - from: backend
+    to: [shared]
+```
+
+### Repository Roles
+```javascript
+// Define repository roles and responsibilities
+{
+  "roles": {
+    "ui": {
+      "responsibilities": ["user-interface", "ux", "accessibility"],
+      "default-agents": ["designer", "coder", "tester"]
+    },
+    "api": {
+      "responsibilities": ["endpoints", "business-logic", "data"],
+      "default-agents": ["architect", "coder", "security"]
+    },
+    "library": {
+      "responsibilities": ["shared-code", "utilities", "types"],
+      "default-agents": ["analyst", "coder", "documenter"]
+    }
+  }
+}
+```
+
+## Orchestration Commands
+
+### Dependency Management
+```bash
+# Update dependencies across all repos with gh CLI
+# Create tracking issue first
+TRACKING_ISSUE=$(gh issue create \
+  --title "Dependency Update: typescript@5.0.0" \
+  --body "Tracking issue for updating TypeScript across all repositories" \
+  --label "dependencies,tracking" \
+  --json number -q .number)
+
+# Get all repos with TypeScript
+TS_REPOS=$(gh repo list org --limit 100 --json name | jq -r '.[].name' | \
+  while read -r repo; do
+    if gh api repos/org/$repo/contents/package.json 2>/dev/null | \
+       jq -r '.content' | base64 -d | grep -q '"typescript"'; then
+      echo "$repo"
+    fi
+  done)
+
+# Update each repository
+echo "$TS_REPOS" | while read -r repo; do
+  # Clone and update
+  gh repo clone org/$repo /tmp/$repo -- --depth=1
+  cd /tmp/$repo
+  
+  # Update dependency
+  npm install --save-dev typescript@5.0.0
+  
+  # Test changes
+  if npm test; then
+    # Create PR
+    git checkout -b update-typescript-5
+    git add package.json package-lock.json
+    git commit -m "chore: Update TypeScript to 5.0.0
+
+Part of #$TRACKING_ISSUE"
+    
+    git push origin HEAD
+    gh pr create \
+      --title "Update TypeScript to 5.0.0" \
+      --body "Updates TypeScript to version 5.0.0\n\nTracking: #$TRACKING_ISSUE" \
+      --label "dependencies"
+  else
+    # Report failure
+    gh issue comment $TRACKING_ISSUE \
+      --body "❌ Failed to update $repo - tests failing"
+  fi
+  cd -
+done
+```
+
+### Refactoring Operations
+```bash
+# Coordinate large-scale refactoring
+npx ruv-swarm github multi-repo-refactor \
+  --pattern "rename:OldAPI->NewAPI" \
+  --analyze-impact \
+  --create-migration-guide \
+  --staged-rollout
+```
+
+### Security Updates
+```bash
+# Coordinate security patches
+npx ruv-swarm github multi-repo-security \
+  --scan-all \
+  --patch-vulnerabilities \
+  --verify-fixes \
+  --compliance-report
+```
+
+## Communication Strategies
+
+### 1. Webhook-Based Coordination
+```javascript
+// webhook-coordinator.js
+const { MultiRepoSwarm } = require('ruv-swarm');
+
+const swarm = new MultiRepoSwarm({
+  webhook: {
+    url: 'https://swarm-coordinator.example.com',
+    secret: process.env.WEBHOOK_SECRET
+  }
+});
+
+// Handle cross-repo events
+swarm.on('repo:update', async (event) => {
+  await swarm.propagate(event, {
+    to: event.dependencies,
+    strategy: 'eventual-consistency'
+  });
+});
+```
+
+### 2. GraphQL Federation
+```graphql
+# Federated schema for multi-repo queries
+type Repository @key(fields: "id") {
+  id: ID!
+  name: String!
+  swarmStatus: SwarmStatus!
+  dependencies: [Repository!]!
+  agents: [Agent!]!
+}
+
+type SwarmStatus {
+  active: Boolean!
+  topology: Topology!
+  tasks: [Task!]!
+  memory: JSON!
+}
+```
+
+### 3. Event Streaming
+```yaml
+# Kafka configuration for real-time coordination
+kafka:
+  brokers: ['kafka1:9092', 'kafka2:9092']
+  topics:
+    swarm-events: 
+      partitions: 10
+      replication: 3
+    swarm-memory:
+      partitions: 5
+      replication: 3
+```
+
+## Advanced Features
+
+### 1. Distributed Task Queue
+```bash
+# Create distributed task queue
+npx ruv-swarm github multi-repo-queue \
+  --backend redis \
+  --workers 10 \
+  --priority-routing \
+  --dead-letter-queue
+```
+
+### 2. Cross-Repo Testing
+```bash
+# Run integration tests across repos
+npx ruv-swarm github multi-repo-test \
+  --setup-test-env \
+  --link-services \
+  --run-e2e \
+  --tear-down
+```
+
+### 3. Monorepo Migration
+```bash
+# Assist in monorepo migration
+npx ruv-swarm github to-monorepo \
+  --analyze-repos \
+  --suggest-structure \
+  --preserve-history \
+  --create-migration-prs
+```
+
+## Monitoring & Visualization
+
+### Multi-Repo Dashboard
+```bash
+# Launch monitoring dashboard
+npx ruv-swarm github multi-repo-dashboard \
+  --port 3000 \
+  --metrics "agent-activity,task-progress,memory-usage" \
+  --real-time
+```
+
+### Dependency Graph
+```bash
+# Visualize repo dependencies
+npx ruv-swarm github dep-graph \
+  --format mermaid \
+  --include-agents \
+  --show-data-flow
+```
+
+### Health Monitoring
+```bash
+# Monitor swarm health across repos
+npx ruv-swarm github health-check \
+  --repos "org/*" \
+  --check "connectivity,memory,agents" \
+  --alert-on-issues
+```
+
+## Synchronization Patterns
+
+### 1. Eventually Consistent
+```javascript
+// Eventual consistency for non-critical updates
+{
+  "sync": {
+    "strategy": "eventual",
+    "max-lag": "5m",
+    "retry": {
+      "attempts": 3,
+      "backoff": "exponential"
+    }
+  }
+}
+```
+
+### 2. Strong Consistency
+```javascript
+// Strong consistency for critical operations
+{
+  "sync": {
+    "strategy": "strong",
+    "consensus": "raft",
+    "quorum": 0.51,
+    "timeout": "30s"
+  }
+}
+```
+
+### 3. Hybrid Approach
+```javascript
+// Mix of consistency levels
+{
+  "sync": {
+    "default": "eventual",
+    "overrides": {
+      "security-updates": "strong",
+      "dependency-updates": "strong",
+      "documentation": "eventual"
+    }
+  }
+}
+```
+
+## Use Cases
+
+### 1. Microservices Coordination
+```bash
+# Coordinate microservices development
+npx ruv-swarm github microservices \
+  --services "auth,users,orders,payments" \
+  --ensure-compatibility \
+  --sync-contracts \
+  --integration-tests
+```
+
+### 2. Library Updates
+```bash
+# Update shared library across consumers
+npx ruv-swarm github lib-update \
+  --library "org/shared-lib" \
+  --version "2.0.0" \
+  --find-consumers \
+  --update-imports \
+  --run-tests
+```
+
+### 3. Organization-Wide Changes
+```bash
+# Apply org-wide policy changes
+npx ruv-swarm github org-policy \
+  --policy "add-security-headers" \
+  --repos "org/*" \
+  --validate-compliance \
+  --create-reports
+```
+
+## Best Practices
+
+### 1. Repository Organization
+- Clear repository roles and boundaries
+- Consistent naming conventions
+- Documented dependencies
+- Shared configuration standards
+
+### 2. Communication
+- Use appropriate sync strategies
+- Implement circuit breakers
+- Monitor latency and failures
+- Clear error propagation
+
+### 3. Security
+- Secure cross-repo authentication
+- Encrypted communication channels
+- Audit trail for all operations
+- Principle of least privilege
+
+## Performance Optimization
+
+### Caching Strategy
+```bash
+# Implement cross-repo caching
+npx ruv-swarm github cache-strategy \
+  --analyze-patterns \
+  --suggest-cache-layers \
+  --implement-invalidation
+```
+
+### Parallel Execution
+```bash
+# Optimize parallel operations
+npx ruv-swarm github parallel-optimize \
+  --analyze-dependencies \
+  --identify-parallelizable \
+  --execute-optimal
+```
+
+### Resource Pooling
+```bash
+# Pool resources across repos
+npx ruv-swarm github resource-pool \
+  --share-agents \
+  --distribute-load \
+  --monitor-usage
+```
+
+## Troubleshooting
+
+### Connectivity Issues
+```bash
+# Diagnose connectivity problems
+npx ruv-swarm github diagnose-connectivity \
+  --test-all-repos \
+  --check-permissions \
+  --verify-webhooks
+```
+
+### Memory Synchronization
+```bash
+# Debug memory sync issues
+npx ruv-swarm github debug-memory \
+  --check-consistency \
+  --identify-conflicts \
+  --repair-state
+```
+
+### Performance Bottlenecks
+```bash
+# Identify performance issues
+npx ruv-swarm github perf-analysis \
+  --profile-operations \
+  --identify-bottlenecks \
+  --suggest-optimizations
+```
+
+## Examples
+
+### Full-Stack Application Update
+```bash
+# Update full-stack application
+npx ruv-swarm github fullstack-update \
+  --frontend "org/web-app" \
+  --backend "org/api-server" \
+  --database "org/db-migrations" \
+  --coordinate-deployment
+```
+
+### Cross-Team Collaboration
+```bash
+# Facilitate cross-team work
+npx ruv-swarm github cross-team \
+  --teams "frontend,backend,devops" \
+  --task "implement-feature-x" \
+  --assign-by-expertise \
+  --track-progress
+```
+
 See also: [swarm-pr.md](./swarm-pr.md), [project-board-sync.md](./project-board-sync.md)