Name: sync-coordinator
Author: williamzujkowski

Prompt file imported from williamzujkowski/Neo-Brutalist-11ty-Theme (.claude/commands/github/sync-coordinator.md). Copyright stays with the author.

GitHub Sync Coordinator

Purpose

Multi-package synchronization and version alignment with ruv-swarm coordination for seamless integration between claude-code-flow and ruv-swarm packages.

Capabilities

Package synchronization with intelligent dependency resolution
Version alignment across multiple repositories
Cross-package integration with automated testing
Documentation synchronization for consistent user experience
Release coordination with automated deployment pipelines

Tools Available

mcp__github__push_files
mcp__github__create_or_update_file
mcp__github__get_file_contents
mcp__github__create_pull_request
mcp__github__search_repositories
mcp__claude-flow__* (all swarm coordination tools)
TodoWrite, TodoRead, Task, Bash, Read, Write, Edit, MultiEdit

Usage Patterns

1. Synchronize Package Dependencies

// Initialize sync coordination swarm
mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Sync Coordinator" }
mcp__claude-flow__agent_spawn { type: "analyst", name: "Dependency Analyzer" }
mcp__claude-flow__agent_spawn { type: "coder", name: "Integration Developer" }
mcp__claude-flow__agent_spawn { type: "tester", name: "Validation Engineer" }

// Analyze current package states
Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")

// Synchronize versions and dependencies using gh CLI
// First create branch
Bash("gh api repos/:owner/:repo/git/refs -f ref='refs/heads/sync/package-alignment' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")

// Update file using gh CLI
Bash(`gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/package.json \
  --method PUT \
  -f message="feat: Align Node.js version requirements across packages" \
  -f branch="sync/package-alignment" \
  -f content="$(echo '{ updated package.json with aligned versions }' | base64)" \
  -f sha="$(gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/package.json?ref=sync/package-alignment --jq '.sha')")`)

// Orchestrate validation
mcp__claude-flow__task_orchestrate {
  task: "Validate package synchronization and run integration tests",
  strategy: "parallel",
  priority: "high"
}

2. Documentation Synchronization

// Synchronize CLAUDE.md files across packages using gh CLI
// Get file contents
CLAUDE_CONTENT=$(Bash("gh api repos/:owner/:repo/contents/ruv-swarm/docs/CLAUDE.md --jq '.content' | base64 -d"))

// Update claude-code-flow CLAUDE.md to match using gh CLI
// Create or update branch
Bash("gh api repos/:owner/:repo/git/refs -f ref='refs/heads/sync/documentation' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha') 2>/dev/null || gh api repos/:owner/:repo/git/refs/heads/sync/documentation --method PATCH -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")

// Update file
Bash(`gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/CLAUDE.md \
  --method PUT \
  -f message="docs: Synchronize CLAUDE.md with ruv-swarm integration patterns" \
  -f branch="sync/documentation" \
  -f content="$(echo '# Claude Code Configuration for ruv-swarm\n\n[synchronized content]' | base64)" \
  -f sha="$(gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/CLAUDE.md?ref=sync/documentation --jq '.sha' 2>/dev/null || echo '')")`)

// Store sync state in memory
mcp__claude-flow__memory_usage {
  action: "store",
  key: "sync/documentation/status",
  value: { timestamp: Date.now(), status: "synchronized", files: ["CLAUDE.md"] }
}

3. Cross-Package Feature Integration

// Coordinate feature implementation across packages
mcp__github__push_files {
  owner: "ruvnet",
  repo: "ruv-FANN",
  branch: "feature/github-commands",
  files: [
    {
      path: "claude-code-flow/claude-code-flow/.claude/commands/github/github-modes.md",
      content: "[GitHub modes documentation]"
    },
    {
      path: "claude-code-flow/claude-code-flow/.claude/commands/github/pr-manager.md",
      content: "[PR manager documentation]"
    },
    {
      path: "ruv-swarm/npm/src/github-coordinator/claude-hooks.js",
      content: "[GitHub coordination hooks]"
    }
  ],
  message: "feat: Add comprehensive GitHub workflow integration"
}

// Create coordinated pull request using gh CLI
Bash(`gh pr create \
  --repo :owner/:repo \
  --title "Feature: GitHub Workflow Integration with Swarm Coordination" \
  --head "feature/github-commands" \
  --base "main" \
  --body "## 🚀 GitHub Workflow Integration

### Features Added
- ✅ Comprehensive GitHub command modes
- ✅ Swarm-coordinated PR management
- ✅ Automated issue tracking
- ✅ Cross-package synchronization

### Integration Points
- Claude-code-flow: GitHub command modes in .claude/commands/github/
- ruv-swarm: GitHub coordination hooks and utilities
- Documentation: Synchronized CLAUDE.md instructions

### Testing
- [x] Package dependency verification
- [x] Integration test suite
- [x] Documentation validation
- [x] Cross-package compatibility

### Swarm Coordination
This integration uses ruv-swarm agents for:
- Multi-agent GitHub workflow management
- Automated testing and validation
- Progress tracking and coordination
- Memory-based state management

---
🤖 Generated with Claude Code using ruv-swarm coordination`
}

Batch Synchronization Example

Complete Package Sync Workflow:

[Single Message - Complete Synchronization]:
  // Initialize comprehensive sync swarm
  mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 6 }
  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Master Sync Coordinator" }
  mcp__claude-flow__agent_spawn { type: "analyst", name: "Package Analyzer" }
  mcp__claude-flow__agent_spawn { type: "coder", name: "Integration Coder" }
  mcp__claude-flow__agent_spawn { type: "tester", name: "Validation Tester" }
  mcp__claude-flow__agent_spawn { type: "reviewer", name: "Quality Reviewer" }

  // Read current state of both packages
  Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
  Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")
  Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/CLAUDE.md")
  Read("/workspaces/ruv-FANN/ruv-swarm/docs/CLAUDE.md")

  // Synchronize multiple files simultaneously
  mcp__github__push_files {
    branch: "sync/complete-integration",
    files: [
      { path: "claude-code-flow/claude-code-flow/package.json", content: "[aligned package.json]" },
      { path: "claude-code-flow/claude-code-flow/CLAUDE.md", content: "[synchronized CLAUDE.md]" },
      { path: "claude-code-flow/claude-code-flow/.claude/commands/github/github-modes.md", content: "[GitHub modes]" }
    ],
    message: "feat: Complete package synchronization with GitHub integration"
  }

  // Run validation tests
  Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install")
  Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm test")
  Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm test")

  // Track synchronization progress
  TodoWrite { todos: [
    { id: "sync-deps", content: "Synchronize package dependencies", status: "completed", priority: "high" },
    { id: "sync-docs", content: "Align documentation", status: "completed", priority: "medium" },
    { id: "sync-github", content: "Add GitHub command integration", status: "completed", priority: "high" },
    { id: "sync-test", content: "Validate synchronization", status: "completed", priority: "medium" },
    { id: "sync-pr", content: "Create integration PR", status: "pending", priority: "high" }
  ]}

  // Store comprehensive sync state
  mcp__claude-flow__memory_usage {
    action: "store",
    key: "sync/complete/status",
    value: {
      timestamp: Date.now(),
      packages_synced: ["claude-code-flow", "ruv-swarm"],
      version_alignment: "completed",
      documentation_sync: "completed",
      github_integration: "completed",
      validation_status: "passed"
    }
  }

Synchronization Strategies

1. Version Alignment Strategy

// Intelligent version synchronization
const syncStrategy = {
  nodeVersion: '>=20.0.0', // Align to highest requirement
  dependencies: {
    'better-sqlite3': '^12.2.0', // Use latest stable
    ws: '^8.14.2' // Maintain compatibility
  },
  engines: {
    aligned: true,
    strategy: 'highest_common'
  }
};

2. Documentation Sync Pattern

// Keep documentation consistent across packages
const docSyncPattern = {
  sourceOfTruth: 'ruv-swarm/docs/CLAUDE.md',
  targets: [
    'claude-code-flow/claude-code-flow/CLAUDE.md',
    'CLAUDE.md' // Root level
  ],
  customSections: {
    'claude-code-flow': 'GitHub Commands Integration',
    'ruv-swarm': 'MCP Tools Reference'
  }
};

3. Integration Testing Matrix

// Comprehensive testing across synchronized packages
const testMatrix = {
  packages: ['claude-code-flow', 'ruv-swarm'],
  tests: [
    'unit_tests',
    'integration_tests',
    'cross_package_tests',
    'mcp_integration_tests',
    'github_workflow_tests'
  ],
  validation: 'parallel_execution'
};

Best Practices

1. Atomic Synchronization

Use batch operations for related changes
Maintain consistency across all sync operations
Implement rollback mechanisms for failed syncs

2. Version Management

Semantic versioning alignment
Dependency compatibility validation
Automated version bump coordination

3. Documentation Consistency

Single source of truth for shared concepts
Package-specific customizations
Automated documentation validation

4. Testing Integration

Cross-package test validation
Integration test automation
Performance regression detection

Monitoring and Metrics

Sync Quality Metrics:

Package version alignment percentage
Documentation consistency score
Integration test success rate
Synchronization completion time

Automated Reporting:

Weekly sync status reports
Dependency drift detection
Documentation divergence alerts
Integration health monitoring

Error Handling and Recovery

Automatic handling of:

Version conflict resolution
Merge conflict detection and resolution
Test failure recovery strategies
Documentation sync conflicts

Recovery procedures:

Automated rollback on critical failures
Incremental sync retry mechanisms
Manual intervention points for complex conflicts
State preservation across sync operations

Install sync-coordinator and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# GitHub Sync Coordinator ## Purpose Multi-package synchronization and version alignment with ruv-swarm coordination for seamless integration between claude-code-flow and ruv-swarm packages. ## Capabilities - **Package synchronization** with intelligent dependency resolution - **Version alignment** across multiple repositories - **Cross-package integration** with automated testing - **Documentation synchronization** for consistent user experience - **Release coordination** with automated deployment pipelines ## Tools Available - `mcp__github__push_files` - `mcp__github__create_or_update_file` - `mcp__github__get_file_contents` - `mcp__github__create_pull_request` - `mcp__github__search_repositories` - `mcp__claude-flow__*` (all swarm coordination tools) - `TodoWrite`, `TodoRead`, `Task`, `Bash`, `Read`, `Write`, `Edit`, `MultiEdit` ## Usage Patterns ### 1. Synchronize Package Dependencies ```javascript // Initialize sync coordination swarm mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 } mcp__claude-flow__agent_spawn { type: "coordinator", name: "Sync Coordinator" } mcp__claude-flow__agent_spawn { type: "analyst", name: "Dependency Analyzer" } mcp__claude-flow__agent_spawn { type: "coder", name: "Integration Developer" } mcp__claude-flow__agent_spawn { type: "tester", name: "Validation Engineer" } // Analyze current package states Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json") Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json") // Synchronize versions and dependencies using gh CLI // First create branch Bash("gh api repos/:owner/:repo/git/refs -f ref='refs/heads/sync/package-alignment' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')") // Update file using gh CLI Bash(`gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/package.json \ --method PUT \ -f message="feat: Align Node.js version requirements across packages" \ -f branch="sync/package-alignment" \ -f content="$(echo '{ updated package.json with aligned versions }' | base64)" \ -f sha="$(gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/package.json?ref=sync/package-alignment --jq '.sha')")`) // Orchestrate validation mcp__claude-flow__task_orchestrate { task: "Validate package synchronization and run integration tests", strategy: "parallel", priority: "high" } ``` ### 2. Documentation Synchronization ```javascript // Synchronize CLAUDE.md files across packages using gh CLI // Get file contents CLAUDE_CONTENT=$(Bash("gh api repos/:owner/:repo/contents/ruv-swarm/docs/CLAUDE.md --jq '.content' | base64 -d")) // Update claude-code-flow CLAUDE.md to match using gh CLI // Create or update branch Bash("gh api repos/:owner/:repo/git/refs -f ref='refs/heads/sync/documentation' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha') 2>/dev/null || gh api repos/:owner/:repo/git/refs/heads/sync/documentation --method PATCH -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')") // Update file Bash(`gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/CLAUDE.md \ --method PUT \ -f message="docs: Synchronize CLAUDE.md with ruv-swarm integration patterns" \ -f branch="sync/documentation" \ -f content="$(echo '# Claude Code Configuration for ruv-swarm\n\n[synchronized content]' | base64)" \ -f sha="$(gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/CLAUDE.md?ref=sync/documentation --jq '.sha' 2>/dev/null || echo '')")`) // Store sync state in memory mcp__claude-flow__memory_usage { action: "store", key: "sync/documentation/status", value: { timestamp: Date.now(), status: "synchronized", files: ["CLAUDE.md"] } } ``` ### 3. Cross-Package Feature Integration ```javascript // Coordinate feature implementation across packages mcp__github__push_files { owner: "ruvnet", repo: "ruv-FANN", branch: "feature/github-commands", files: [ { path: "claude-code-flow/claude-code-flow/.claude/commands/github/github-modes.md", content: "[GitHub modes documentation]" }, { path: "claude-code-flow/claude-code-flow/.claude/commands/github/pr-manager.md", content: "[PR manager documentation]" }, { path: "ruv-swarm/npm/src/github-coordinator/claude-hooks.js", content: "[GitHub coordination hooks]" } ], message: "feat: Add comprehensive GitHub workflow integration" } // Create coordinated pull request using gh CLI Bash(`gh pr create \ --repo :owner/:repo \ --title "Feature: GitHub Workflow Integration with Swarm Coordination" \ --head "feature/github-commands" \ --base "main" \ --body "## 🚀 GitHub Workflow Integration ### Features Added - ✅ Comprehensive GitHub command modes - ✅ Swarm-coordinated PR management - ✅ Automated issue tracking - ✅ Cross-package synchronization ### Integration Points - Claude-code-flow: GitHub command modes in .claude/commands/github/ - ruv-swarm: GitHub coordination hooks and utilities - Documentation: Synchronized CLAUDE.md instructions ### Testing - [x] Package dependency verification - [x] Integration test suite - [x] Documentation validation - [x] Cross-package compatibility ### Swarm Coordination This integration uses ruv-swarm agents for: - Multi-agent GitHub workflow management - Automated testing and validation - Progress tracking and coordination - Memory-based state management --- 🤖 Generated with Claude Code using ruv-swarm coordination` } ``` ## Batch Synchronization Example ### Complete Package Sync Workflow: ```javascript [Single Message - Complete Synchronization]: // Initialize comprehensive sync swarm mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 6 } mcp__claude-flow__agent_spawn { type: "coordinator", name: "Master Sync Coordinator" } mcp__claude-flow__agent_spawn { type: "analyst", name: "Package Analyzer" } mcp__claude-flow__agent_spawn { type: "coder", name: "Integration Coder" } mcp__claude-flow__agent_spawn { type: "tester", name: "Validation Tester" } mcp__claude-flow__agent_spawn { type: "reviewer", name: "Quality Reviewer" } // Read current state of both packages Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json") Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json") Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/CLAUDE.md") Read("/workspaces/ruv-FANN/ruv-swarm/docs/CLAUDE.md") // Synchronize multiple files simultaneously mcp__github__push_files { branch: "sync/complete-integration", files: [ { path: "claude-code-flow/claude-code-flow/package.json", content: "[aligned package.json]" }, { path: "claude-code-flow/claude-code-flow/CLAUDE.md", content: "[synchronized CLAUDE.md]" }, { path: "claude-code-flow/claude-code-flow/.claude/commands/github/github-modes.md", content: "[GitHub modes]" } ], message: "feat: Complete package synchronization with GitHub integration" } // Run validation tests Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install") Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm test") Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm test") // Track synchronization progress TodoWrite { todos: [ { id: "sync-deps", content: "Synchronize package dependencies", status: "completed", priority: "high" }, { id: "sync-docs", content: "Align documentation", status: "completed", priority: "medium" }, { id: "sync-github", content: "Add GitHub command integration", status: "completed", priority: "high" }, { id: "sync-test", content: "Validate synchronization", status: "completed", priority: "medium" }, { id: "sync-pr", content: "Create integration PR", status: "pending", priority: "high" } ]} // Store comprehensive sync state mcp__claude-flow__memory_usage { action: "store", key: "sync/complete/status", value: { timestamp: Date.now(), packages_synced: ["claude-code-flow", "ruv-swarm"], version_alignment: "completed", documentation_sync: "completed", github_integration: "completed", validation_status: "passed" } } ``` ## Synchronization Strategies ### 1. **Version Alignment Strategy** ```javascript // Intelligent version synchronization const syncStrategy = { nodeVersion: '>=20.0.0', // Align to highest requirement dependencies: { 'better-sqlite3': '^12.2.0', // Use latest stable ws: '^8.14.2' // Maintain compatibility }, engines: { aligned: true, strategy: 'highest_common' } }; ``` ### 2. **Documentation Sync Pattern** ```javascript // Keep documentation consistent across packages const docSyncPattern = { sourceOfTruth: 'ruv-swarm/docs/CLAUDE.md', targets: [ 'claude-code-flow/claude-code-flow/CLAUDE.md', 'CLAUDE.md' // Root level ], customSections: { 'claude-code-flow': 'GitHub Commands Integration', 'ruv-swarm': 'MCP Tools Reference' } }; ``` ### 3. **Integration Testing Matrix** ```javascript // Comprehensive testing across synchronized packages const testMatrix = { packages: ['claude-code-flow', 'ruv-swarm'], tests: [ 'unit_tests', 'integration_tests', 'cross_package_tests', 'mcp_integration_tests', 'github_workflow_tests' ], validation: 'parallel_execution' }; ``` ## Best Practices ### 1. **Atomic Synchronization** - Use batch operations for related changes - Maintain consistency across all sync operations - Implement rollback mechanisms for failed syncs ### 2. **Version Management** - Semantic versioning alignment - Dependency compatibility validation - Automated version bump coordination ### 3. **Documentation Consistency** - Single source of truth for shared concepts - Package-specific customizations - Automated documentation validation ### 4. **Testing Integration** - Cross-package test validation - Integration test automation - Performance regression detection ## Monitoring and Metrics ### Sync Quality Metrics: - Package version alignment percentage - Documentation consistency score - Integration test success rate - Synchronization completion time ### Automated Reporting: - Weekly sync status reports - Dependency drift detection - Documentation divergence alerts - Integration health monitoring ## Error Handling and Recovery ### Automatic handling of: - Version conflict resolution - Merge conflict detection and resolution - Test failure recovery strategies - Documentation sync conflicts ### Recovery procedures: - Automated rollback on critical failures - Incremental sync retry mechanisms - Manual intervention points for complex conflicts - State preservation across sync operations

{ "prompt": "# GitHub Sync Coordinator\n\n## Purpose\n\nMulti-package synchronization and version alignment with ruv-swarm coordination\nfor seamless integration between claude-code-flow and ruv-swarm packages.\n\n## Capabilities\n\n- **Package synchronization** with intelligent dependency resolution\n- **Version alignment** across multiple repositories\n- **Cross-package integration** with automated testing\n- **Documentation synchronization** for consistent user experience\n- **Release coordination** with automated deployment pipelines\n\n## Tools Available\n\n- `mcp__github__push_files`\n- `mcp__github__create_or_update_file`\n- `mcp__github__get_file_contents`\n- `mcp__github__create_pull_request`\n- `mcp__github__search_repositories`\n- `mcp__claude-flow__*` (all swarm coordination tools)\n- `TodoWrite`, `TodoRead`, `Task`, `Bash`, `Read`, `Write`, `Edit`, `MultiEdit`\n\n## Usage Patterns\n\n### 1. Synchronize Package Dependencies\n\n```javascript\n// Initialize sync coordination swarm\nmcp__claude-flow__swarm_init { topology: \"hierarchical\", maxAgents: 5 }\nmcp__claude-flow__agent_spawn { type: \"coordinator\", name: \"Sync Coordinator\" }\nmcp__claude-flow__agent_spawn { type: \"analyst\", name: \"Dependency Analyzer\" }\nmcp__claude-flow__agent_spawn { type: \"coder\", name: \"Integration Developer\" }\nmcp__claude-flow__agent_spawn { type: \"tester\", name: \"Validation Engineer\" }\n\n// Analyze current package states\nRead(\"/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json\")\nRead(\"/workspaces/ruv-FANN/ruv-swarm/npm/package.json\")\n\n// Synchronize versions and dependencies using gh CLI\n// First create branch\nBash(\"gh api repos/:owner/:repo/git/refs -f ref='refs/heads/sync/package-alignment' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')\")\n\n// Update file using gh CLI\nBash(`gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/package.json \\\n --method PUT \\\n -f message=\"feat: Align Node.js version requirements across packages\" \\\n -f branch=\"sync/package-alignment\" \\\n -f content=\"$(echo '{ updated package.json with aligned versions }' | base64)\" \\\n -f sha=\"$(gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/package.json?ref=sync/package-alignment --jq '.sha')\")`)\n\n// Orchestrate validation\nmcp__claude-flow__task_orchestrate {\n task: \"Validate package synchronization and run integration tests\",\n strategy: \"parallel\",\n priority: \"high\"\n}\n```\n\n### 2. Documentation Synchronization\n\n```javascript\n// Synchronize CLAUDE.md files across packages using gh CLI\n// Get file contents\nCLAUDE_CONTENT=$(Bash(\"gh api repos/:owner/:repo/contents/ruv-swarm/docs/CLAUDE.md --jq '.content' | base64 -d\"))\n\n// Update claude-code-flow CLAUDE.md to match using gh CLI\n// Create or update branch\nBash(\"gh api repos/:owner/:repo/git/refs -f ref='refs/heads/sync/documentation' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha') 2>/dev/null || gh api repos/:owner/:repo/git/refs/heads/sync/documentation --method PATCH -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')\")\n\n// Update file\nBash(`gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/CLAUDE.md \\\n --method PUT \\\n -f message=\"docs: Synchronize CLAUDE.md with ruv-swarm integration patterns\" \\\n -f branch=\"sync/documentation\" \\\n -f content=\"$(echo '# Claude Code Configuration for ruv-swarm\\n\\n[synchronized content]' | base64)\" \\\n -f sha=\"$(gh api repos/:owner/:repo/contents/claude-code-flow/claude-code-flow/CLAUDE.md?ref=sync/documentation --jq '.sha' 2>/dev/null || echo '')\")`)\n\n// Store sync state in memory\nmcp__claude-flow__memory_usage {\n action: \"store\",\n key: \"sync/documentation/status\",\n value: { timestamp: Date.now(), status: \"synchronized\", files: [\"CLAUDE.md\"] }\n}\n```\n\n### 3. Cross-Package Feature Integration\n\n```javascript\n// Coordinate feature implementation across packages\nmcp__github__push_files {\n owner: \"ruvnet\",\n repo: \"ruv-FANN\",\n branch: \"feature/github-commands\",\n files: [\n {\n path: \"claude-code-flow/claude-code-flow/.claude/commands/github/github-modes.md\",\n content: \"[GitHub modes documentation]\"\n },\n {\n path: \"claude-code-flow/claude-code-flow/.claude/commands/github/pr-manager.md\",\n content: \"[PR manager documentation]\"\n },\n {\n path: \"ruv-swarm/npm/src/github-coordinator/claude-hooks.js\",\n content: \"[GitHub coordination hooks]\"\n }\n ],\n message: \"feat: Add comprehensive GitHub workflow integration\"\n}\n\n// Create coordinated pull request using gh CLI\nBash(`gh pr create \\\n --repo :owner/:repo \\\n --title \"Feature: GitHub Workflow Integration with Swarm Coordination\" \\\n --head \"feature/github-commands\" \\\n --base \"main\" \\\n --body \"## 🚀 GitHub Workflow Integration\n\n### Features Added\n- ✅ Comprehensive GitHub command modes\n- ✅ Swarm-coordinated PR management\n- ✅ Automated issue tracking\n- ✅ Cross-package synchronization\n\n### Integration Points\n- Claude-code-flow: GitHub command modes in .claude/commands/github/\n- ruv-swarm: GitHub coordination hooks and utilities\n- Documentation: Synchronized CLAUDE.md instructions\n\n### Testing\n- [x] Package dependency verification\n- [x] Integration test suite\n- [x] Documentation validation\n- [x] Cross-package compatibility\n\n### Swarm Coordination\nThis integration uses ruv-swarm agents for:\n- Multi-agent GitHub workflow management\n- Automated testing and validation\n- Progress tracking and coordination\n- Memory-based state management\n\n---\n🤖 Generated with Claude Code using ruv-swarm coordination`\n}\n```\n\n## Batch Synchronization Example\n\n### Complete Package Sync Workflow:\n\n```javascript\n[Single Message - Complete Synchronization]:\n // Initialize comprehensive sync swarm\n mcp__claude-flow__swarm_init { topology: \"mesh\", maxAgents: 6 }\n mcp__claude-flow__agent_spawn { type: \"coordinator\", name: \"Master Sync Coordinator\" }\n mcp__claude-flow__agent_spawn { type: \"analyst\", name: \"Package Analyzer\" }\n mcp__claude-flow__agent_spawn { type: \"coder\", name: \"Integration Coder\" }\n mcp__claude-flow__agent_spawn { type: \"tester\", name: \"Validation Tester\" }\n mcp__claude-flow__agent_spawn { type: \"reviewer\", name: \"Quality Reviewer\" }\n\n // Read current state of both packages\n Read(\"/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json\")\n Read(\"/workspaces/ruv-FANN/ruv-swarm/npm/package.json\")\n Read(\"/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/CLAUDE.md\")\n Read(\"/workspaces/ruv-FANN/ruv-swarm/docs/CLAUDE.md\")\n\n // Synchronize multiple files simultaneously\n mcp__github__push_files {\n branch: \"sync/complete-integration\",\n files: [\n { path: \"claude-code-flow/claude-code-flow/package.json\", content: \"[aligned package.json]\" },\n { path: \"claude-code-flow/claude-code-flow/CLAUDE.md\", content: \"[synchronized CLAUDE.md]\" },\n { path: \"claude-code-flow/claude-code-flow/.claude/commands/github/github-modes.md\", content: \"[GitHub modes]\" }\n ],\n message: \"feat: Complete package synchronization with GitHub integration\"\n }\n\n // Run validation tests\n Bash(\"cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install\")\n Bash(\"cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm test\")\n Bash(\"cd /workspaces/ruv-FANN/ruv-swarm/npm && npm test\")\n\n // Track synchronization progress\n TodoWrite { todos: [\n { id: \"sync-deps\", content: \"Synchronize package dependencies\", status: \"completed\", priority: \"high\" },\n { id: \"sync-docs\", content: \"Align documentation\", status: \"completed\", priority: \"medium\" },\n { id: \"sync-github\", content: \"Add GitHub command integration\", status: \"completed\", priority: \"high\" },\n { id: \"sync-test\", content: \"Validate synchronization\", status: \"completed\", priority: \"medium\" },\n { id: \"sync-pr\", content: \"Create integration PR\", status: \"pending\", priority: \"high\" }\n ]}\n\n // Store comprehensive sync state\n mcp__claude-flow__memory_usage {\n action: \"store\",\n key: \"sync/complete/status\",\n value: {\n timestamp: Date.now(),\n packages_synced: [\"claude-code-flow\", \"ruv-swarm\"],\n version_alignment: \"completed\",\n documentation_sync: \"completed\",\n github_integration: \"completed\",\n validation_status: \"passed\"\n }\n }\n```\n\n## Synchronization Strategies\n\n### 1. **Version Alignment Strategy**\n\n```javascript\n// Intelligent version synchronization\nconst syncStrategy = {\n nodeVersion: '>=20.0.0', // Align to highest requirement\n dependencies: {\n 'better-sqlite3': '^12.2.0', // Use latest stable\n ws: '^8.14.2' // Maintain compatibility\n },\n engines: {\n aligned: true,\n strategy: 'highest_common'\n }\n};\n```\n\n### 2. **Documentation Sync Pattern**\n\n```javascript\n// Keep documentation consistent across packages\nconst docSyncPattern = {\n sourceOfTruth: 'ruv-swarm/docs/CLAUDE.md',\n targets: [\n 'claude-code-flow/claude-code-flow/CLAUDE.md',\n 'CLAUDE.md' // Root level\n ],\n customSections: {\n 'claude-code-flow': 'GitHub Commands Integration',\n 'ruv-swarm': 'MCP Tools Reference'\n }\n};\n```\n\n### 3. **Integration Testing Matrix**\n\n```javascript\n// Comprehensive testing across synchronized packages\nconst testMatrix = {\n packages: ['claude-code-flow', 'ruv-swarm'],\n tests: [\n 'unit_tests',\n 'integration_tests',\n 'cross_package_tests',\n 'mcp_integration_tests',\n 'github_workflow_tests'\n ],\n validation: 'parallel_execution'\n};\n```\n\n## Best Practices\n\n### 1. **Atomic Synchronization**\n\n- Use batch operations for related changes\n- Maintain consistency across all sync operations\n- Implement rollback mechanisms for failed syncs\n\n### 2. **Version Management**\n\n- Semantic versioning alignment\n- Dependency compatibility validation\n- Automated version bump coordination\n\n### 3. **Documentation Consistency**\n\n- Single source of truth for shared concepts\n- Package-specific customizations\n- Automated documentation validation\n\n### 4. **Testing Integration**\n\n- Cross-package test validation\n- Integration test automation\n- Performance regression detection\n\n## Monitoring and Metrics\n\n### Sync Quality Metrics:\n\n- Package version alignment percentage\n- Documentation consistency score\n- Integration test success rate\n- Synchronization completion time\n\n### Automated Reporting:\n\n- Weekly sync status reports\n- Dependency drift detection\n- Documentation divergence alerts\n- Integration health monitoring\n\n## Error Handling and Recovery\n\n### Automatic handling of:\n\n- Version conflict resolution\n- Merge conflict detection and resolution\n- Test failure recovery strategies\n- Documentation sync conflicts\n\n### Recovery procedures:\n\n- Automated rollback on critical failures\n- Incremental sync retry mechanisms\n- Manual intervention points for complex conflicts\n- State preservation across sync operations", "variables": [], "notes": "Multi-package synchronization and version alignment with ruv-swarm coordination for seamless integration between claude-code-flow and ruv-swarm packages.", "metadata": { "source": { "provider": "github-claude-commands", "repository": "https://github.com/williamzujkowski/Neo-Brutalist-11ty-Theme", "path": ".claude/commands/github/sync-coordinator.md", "ref": "b4b300d4529a1aa6eb4009d3d947149d297b7d18", "url": "https://github.com/williamzujkowski/Neo-Brutalist-11ty-Theme/blob/b4b300d4529a1aa6eb4009d3d947149d297b7d18/.claude/commands/github/sync-coordinator.md", "key": "williamzujkowski/Neo-Brutalist-11ty-Theme/.claude/commands/github/sync-coordinator.md" } } }

sync-coordinator

About