[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6ESJNGGSJDQ33DRMZZPBJC7":3,"skill-same:01M6ESJNGGSJDQ33DRMZZPBJC7":86},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":39,"linkOnly":40,"markdownContent":41,"markdownBody":42,"frontMatter":43,"refName":57,"commitSha":58,"skillDirectory":59,"forksCount":60,"repositoryHtmlUrl":61,"repositoryHomepageUrl":62,"ownerHtmlUrl":63,"ownerBlogUrl":6,"ownerDescription":64,"updatedAt":65,"install":66,"resources":79},"01M6ESJNGGSJDQ33DRMZZPBJC7","github-multi-repo",null,"Multi-repository coordination, synchronization, and architecture management with AI swarm orchestration","ComeOnOliver\u002Fskillshub","ComeOnOliver","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F43215937?v=4","01M6E5JNFECJAAVFE0W7SMWWD2","Haoran Shu","01M6E5JNNDQS7AJZDYFQ8TPZCK",66,"MIT","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Faiskillstore\u002Fmarketplace\u002Fdnyoussef\u002Fgithub-multi-repo\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],"github","multi","repo","github multi repo","architecture","package","repository","Optimization","flow","team","swarm","template","gh","multi-repo","synchronization","coordination","workflows","Swarm Orchestration","orchestration","cli","2026-11-10 10:12:30",false,"---\nname: github-multi-repo\nversion: 1.0.0\ndescription: Multi-repository coordination, synchronization, and architecture management with AI swarm orchestration\ncategory: github-integration\ntags: [multi-repo, synchronization, architecture, coordination, github]\nauthor: Claude Flow Team\nrequires:\n  - ruv-swarm@^1.0.11\n  - gh-cli@^2.0.0\ncapabilities:\n  - cross-repository coordination\n  - package synchronization\n  - architecture optimization\n  - template management\n  - distributed workflows\n---\n\n# GitHub Multi-Repository Coordination Skill\n\n## Overview\n\nAdvanced multi-repository coordination system that combines swarm intelligence, package synchronization, and repository architecture optimization. This skill enables organization-wide automation, cross-project collaboration, and scalable repository management.\n\n## Core Capabilities\n\n### ? Multi-Repository Swarm Coordination\nCross-repository AI swarm orchestration for distributed development workflows.\n\n### ? Package Synchronization\nIntelligent dependency resolution and version alignment across multiple packages.\n\n### ?️ Repository Architecture\nStructure optimization and template management for scalable projects.\n\n### ? Integration Management\nCross-package integration testing and deployment coordination.\n\n## Quick Start\n\n### Initialize Multi-Repo Coordination\n```bash\n# Basic swarm initialization\nnpx claude-flow skill run github-multi-repo init \\\n  --repos \"org\u002Ffrontend,org\u002Fbackend,org\u002Fshared\" \\\n  --topology hierarchical\n\n# Advanced initialization with synchronization\nnpx claude-flow skill run github-multi-repo init \\\n  --repos \"org\u002Ffrontend,org\u002Fbackend,org\u002Fshared\" \\\n  --topology mesh \\\n  --shared-memory \\\n  --sync-strategy eventual\n```\n\n### Synchronize Packages\n```bash\n# Synchronize package versions and dependencies\nnpx claude-flow skill run github-multi-repo sync \\\n  --packages \"claude-code-flow,ruv-swarm\" \\\n  --align-versions \\\n  --update-docs\n```\n\n### Optimize Architecture\n```bash\n# Analyze and optimize repository structure\nnpx claude-flow skill run github-multi-repo optimize \\\n  --analyze-structure \\\n  --suggest-improvements \\\n  --create-templates\n```\n\n## Features\n\n### 1. Cross-Repository Swarm Orchestration\n\n#### Repository Discovery\n```javascript\n\u002F\u002F Auto-discover related repositories with gh CLI\nconst REPOS = Bash(`gh repo list my-organization --limit 100 \\\n  --json name,description,languages,topics \\\n  --jq '.[] | select(.languages | keys | contains([\"TypeScript\"]))'`)\n\n\u002F\u002F Analyze repository dependencies\nconst DEPS = Bash(`gh repo list my-organization --json name | \\\n  jq -r '.[].name' | while read -r repo; do\n    gh api repos\u002Fmy-organization\u002F$repo\u002Fcontents\u002Fpackage.json \\\n      --jq '.content' 2>\u002Fdev\u002Fnull | base64 -d | jq '{name, dependencies}'\n  done | jq -s '.'`)\n\n\u002F\u002F Initialize swarm with discovered repositories\nmcp__claude-flow__swarm_init({\n  topology: \"hierarchical\",\n  maxAgents: 8,\n  metadata: { repos: REPOS, dependencies: DEPS }\n})\n```\n\n#### Synchronized Operations\n```javascript\n\u002F\u002F Execute synchronized changes across repositories\n[Parallel Multi-Repo Operations]:\n  \u002F\u002F Spawn coordination agents\n  Task(\"Repository Coordinator\", \"Coordinate changes across all repositories\", \"coordinator\")\n  Task(\"Dependency Analyzer\", \"Analyze cross-repo dependencies\", \"analyst\")\n  Task(\"Integration Tester\", \"Validate cross-repo changes\", \"tester\")\n\n  \u002F\u002F Get matching repositories\n  Bash(`gh repo list org --limit 100 --json name \\\n    --jq '.[] | select(.name | test(\"-service$\")) | .name' > \u002Ftmp\u002Frepos.txt`)\n\n  \u002F\u002F Execute task across repositories\n  Bash(`cat \u002Ftmp\u002Frepos.txt | while read -r repo; do\n    gh repo clone org\u002F$repo \u002Ftmp\u002F$repo -- --depth=1\n    cd \u002Ftmp\u002F$repo\n\n    # Apply changes\n    npm update\n    npm test\n\n    # Create PR if successful\n    if [ $? -eq 0 ]; then\n      git checkout -b update-dependencies-$(date +%Y%m%d)\n      git add -A\n      git commit -m \"chore: Update dependencies\"\n      git push origin HEAD\n      gh pr create --title \"Update dependencies\" --body \"Automated update\" --label \"dependencies\"\n    fi\n  done`)\n\n  \u002F\u002F Track all operations\n  TodoWrite { todos: [\n    { id: \"discover\", content: \"Discover all service repositories\", status: \"completed\" },\n    { id: \"update\", content: \"Update dependencies\", status: \"completed\" },\n    { id: \"test\", content: \"Run integration tests\", status: \"in_progress\" },\n    { id: \"pr\", content: \"Create pull requests\", status: \"pending\" }\n  ]}\n```\n\n### 2. Package Synchronization\n\n#### Version Alignment\n```javascript\n\u002F\u002F Synchronize package dependencies and versions\n[Complete Package Sync]:\n  \u002F\u002F Initialize sync swarm\n  mcp__claude-flow__swarm_init({ topology: \"mesh\", maxAgents: 5 })\n\n  \u002F\u002F Spawn sync agents\n  Task(\"Sync Coordinator\", \"Coordinate version alignment\", \"coordinator\")\n  Task(\"Dependency Analyzer\", \"Analyze dependencies\", \"analyst\")\n  Task(\"Integration Tester\", \"Validate synchronization\", \"tester\")\n\n  \u002F\u002F Read package states\n  Read(\"\u002Fworkspaces\u002Fruv-FANN\u002Fclaude-code-flow\u002Fclaude-code-flow\u002Fpackage.json\")\n  Read(\"\u002Fworkspaces\u002Fruv-FANN\u002Fruv-swarm\u002Fnpm\u002Fpackage.json\")\n\n  \u002F\u002F Align versions using gh CLI\n  Bash(`gh api repos\u002F:owner\u002F:repo\u002Fgit\u002Frefs \\\n    -f ref='refs\u002Fheads\u002Fsync\u002Fpackage-alignment' \\\n    -f sha=$(gh api repos\u002F:owner\u002F:repo\u002Fgit\u002Frefs\u002Fheads\u002Fmain --jq '.object.sha')`)\n\n  \u002F\u002F Update package.json files\n  Bash(`gh api repos\u002F:owner\u002F:repo\u002Fcontents\u002Fpackage.json \\\n    --method PUT \\\n    -f message=\"feat: Align Node.js version requirements\" \\\n    -f branch=\"sync\u002Fpackage-alignment\" \\\n    -f content=\"$(cat aligned-package.json | base64)\"`)\n\n  \u002F\u002F Store sync state\n  mcp__claude-flow__memory_usage({\n    action: \"store\",\n    key: \"sync\u002Fpackages\u002Fstatus\",\n    value: {\n      timestamp: Date.now(),\n      packages_synced: [\"claude-code-flow\", \"ruv-swarm\"],\n      status: \"synchronized\"\n    }\n  })\n```\n\n#### Documentation Synchronization\n```javascript\n\u002F\u002F Synchronize CLAUDE.md files across packages\n[Documentation Sync]:\n  \u002F\u002F Get source documentation\n  Bash(`gh api repos\u002F:owner\u002F:repo\u002Fcontents\u002Fruv-swarm\u002Fdocs\u002FCLAUDE.md \\\n    --jq '.content' | base64 -d > \u002Ftmp\u002Fclaude-source.md`)\n\n  \u002F\u002F Update target documentation\n  Bash(`gh api repos\u002F:owner\u002F:repo\u002Fcontents\u002Fclaude-code-flow\u002FCLAUDE.md \\\n    --method PUT \\\n    -f message=\"docs: Synchronize CLAUDE.md\" \\\n    -f branch=\"sync\u002Fdocumentation\" \\\n    -f content=\"$(cat \u002Ftmp\u002Fclaude-source.md | base64)\"`)\n\n  \u002F\u002F Track sync status\n  mcp__claude-flow__memory_usage({\n    action: \"store\",\n    key: \"sync\u002Fdocumentation\u002Fstatus\",\n    value: { status: \"synchronized\", files: [\"CLAUDE.md\"] }\n  })\n```\n\n#### Cross-Package Integration\n```javascript\n\u002F\u002F Coordinate feature implementation across packages\n[Cross-Package Feature]:\n  \u002F\u002F Push changes to all packages\n  mcp__github__push_files({\n    branch: \"feature\u002Fgithub-integration\",\n    files: [\n      {\n        path: \"claude-code-flow\u002F.claude\u002Fcommands\u002Fgithub\u002Fgithub-modes.md\",\n        content: \"[GitHub modes documentation]\"\n      },\n      {\n        path: \"ruv-swarm\u002Fsrc\u002Fgithub-coordinator\u002Fhooks.js\",\n        content: \"[GitHub coordination hooks]\"\n      }\n    ],\n    message: \"feat: Add GitHub workflow integration\"\n  })\n\n  \u002F\u002F Create coordinated PR\n  Bash(`gh pr create \\\n    --title \"Feature: GitHub Workflow Integration\" \\\n    --body \"## ? GitHub Integration\n\n### Features\n- ✅ Multi-repo coordination\n- ✅ Package synchronization\n- ✅ Architecture optimization\n\n### Testing\n- [x] Package dependency verification\n- [x] Integration tests\n- [x] Cross-package compatibility\"`)\n```\n\n### 3. Repository Architecture\n\n#### Structure Analysis\n```javascript\n\u002F\u002F Analyze and optimize repository structure\n[Architecture Analysis]:\n  \u002F\u002F Initialize architecture swarm\n  mcp__claude-flow__swarm_init({ topology: \"hierarchical\", maxAgents: 6 })\n\n  \u002F\u002F Spawn architecture agents\n  Task(\"Senior Architect\", \"Analyze repository structure\", \"architect\")\n  Task(\"Structure Analyst\", \"Identify optimization opportunities\", \"analyst\")\n  Task(\"Performance Optimizer\", \"Optimize structure for scalability\", \"optimizer\")\n  Task(\"Best Practices Researcher\", \"Research architecture patterns\", \"researcher\")\n\n  \u002F\u002F Analyze current structures\n  LS(\"\u002Fworkspaces\u002Fruv-FANN\u002Fclaude-code-flow\u002Fclaude-code-flow\")\n  LS(\"\u002Fworkspaces\u002Fruv-FANN\u002Fruv-swarm\u002Fnpm\")\n\n  \u002F\u002F Search for best practices\n  Bash(`gh search repos \"language:javascript template architecture\" \\\n    --limit 10 \\\n    --json fullName,description,stargazersCount \\\n    --sort stars \\\n    --order desc`)\n\n  \u002F\u002F Store analysis results\n  mcp__claude-flow__memory_usage({\n    action: \"store\",\n    key: \"architecture\u002Fanalysis\u002Fresults\",\n    value: {\n      repositories_analyzed: [\"claude-code-flow\", \"ruv-swarm\"],\n      optimization_areas: [\"structure\", \"workflows\", \"templates\"],\n      recommendations: [\"standardize_structure\", \"improve_workflows\"]\n    }\n  })\n```\n\n#### Template Creation\n```javascript\n\u002F\u002F Create standardized repository template\n[Template Creation]:\n  \u002F\u002F Create template repository\n  mcp__github__create_repository({\n    name: \"claude-project-template\",\n    description: \"Standardized template for Claude Code projects\",\n    private: false,\n    autoInit: true\n  })\n\n  \u002F\u002F Push template structure\n  mcp__github__push_files({\n    repo: \"claude-project-template\",\n    files: [\n      {\n        path: \".claude\u002Fcommands\u002Fgithub\u002Fgithub-modes.md\",\n        content: \"[GitHub modes template]\"\n      },\n      {\n        path: \".claude\u002Fconfig.json\",\n        content: JSON.stringify({\n          version: \"1.0\",\n          mcp_servers: {\n            \"ruv-swarm\": {\n              command: \"npx\",\n              args: [\"ruv-swarm\", \"mcp\", \"start\"]\n            }\n          }\n        })\n      },\n      {\n        path: \"CLAUDE.md\",\n        content: \"[Standardized CLAUDE.md]\"\n      },\n      {\n        path: \"package.json\",\n        content: JSON.stringify({\n          name: \"claude-project-template\",\n          engines: { node: \">=20.0.0\" },\n          dependencies: { \"ruv-swarm\": \"^1.0.11\" }\n        })\n      }\n    ],\n    message: \"feat: Create standardized template\"\n  })\n```\n\n#### Cross-Repository Standardization\n```javascript\n\u002F\u002F Synchronize structure across repositories\n[Structure Standardization]:\n  const repositories = [\"claude-code-flow\", \"ruv-swarm\", \"claude-extensions\"]\n\n  \u002F\u002F Update common files across all repositories\n  repositories.forEach(repo => {\n    mcp__github__create_or_update_file({\n      repo: \"ruv-FANN\",\n      path: `${repo}\u002F.github\u002Fworkflows\u002Fintegration.yml`,\n      content: `name: Integration Tests\non: [push, pull_request]\njobs:\n  test:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v3\n      - uses: actions\u002Fsetup-node@v3\n        with: { node-version: '20' }\n      - run: npm install && npm test`,\n      message: \"ci: Standardize integration workflow\",\n      branch: \"structure\u002Fstandardization\"\n    })\n  })\n```\n\n### 4. Orchestration Workflows\n\n#### Dependency Management\n```javascript\n\u002F\u002F Update dependencies across all repositories\n[Organization-Wide Dependency Update]:\n  \u002F\u002F Create tracking issue\n  TRACKING_ISSUE=$(Bash(`gh issue create \\\n    --title \"Dependency Update: typescript@5.0.0\" \\\n    --body \"Tracking TypeScript update across all repositories\" \\\n    --label \"dependencies,tracking\" \\\n    --json number -q .number`))\n\n  \u002F\u002F Find all TypeScript repositories\n  TS_REPOS=$(Bash(`gh repo list org --limit 100 --json name | \\\n    jq -r '.[].name' | while read -r repo; do\n      if gh api repos\u002Forg\u002F$repo\u002Fcontents\u002Fpackage.json 2>\u002Fdev\u002Fnull | \\\n         jq -r '.content' | base64 -d | grep -q '\"typescript\"'; then\n        echo \"$repo\"\n      fi\n    done`))\n\n  \u002F\u002F Update each repository\n  Bash(`echo \"$TS_REPOS\" | while read -r repo; do\n    gh repo clone org\u002F$repo \u002Ftmp\u002F$repo -- --depth=1\n    cd \u002Ftmp\u002F$repo\n\n    npm install --save-dev typescript@5.0.0\n\n    if npm test; then\n      git checkout -b update-typescript-5\n      git add package.json package-lock.json\n      git commit -m \"chore: Update TypeScript to 5.0.0\n\nPart of #$TRACKING_ISSUE\"\n\n      git push origin HEAD\n      gh pr create \\\n        --title \"Update TypeScript to 5.0.0\" \\\n        --body \"Updates TypeScript\\n\\nTracking: #$TRACKING_ISSUE\" \\\n        --label \"dependencies\"\n    else\n      gh issue comment $TRACKING_ISSUE \\\n        --body \"❌ Failed to update $repo - tests failing\"\n    fi\n  done`)\n```\n\n#### Refactoring Operations\n```javascript\n\u002F\u002F Coordinate large-scale refactoring\n[Cross-Repo Refactoring]:\n  \u002F\u002F Initialize refactoring swarm\n  mcp__claude-flow__swarm_init({ topology: \"mesh\", maxAgents: 8 })\n\n  \u002F\u002F Spawn specialized agents\n  Task(\"Refactoring Coordinator\", \"Coordinate refactoring across repos\", \"coordinator\")\n  Task(\"Impact Analyzer\", \"Analyze refactoring impact\", \"analyst\")\n  Task(\"Code Transformer\", \"Apply refactoring changes\", \"coder\")\n  Task(\"Migration Guide Creator\", \"Create migration documentation\", \"documenter\")\n  Task(\"Integration Tester\", \"Validate refactored code\", \"tester\")\n\n  \u002F\u002F Execute refactoring\n  mcp__claude-flow__task_orchestrate({\n    task: \"Rename OldAPI to NewAPI across all repositories\",\n    strategy: \"sequential\",\n    priority: \"high\"\n  })\n```\n\n#### Security Updates\n```javascript\n\u002F\u002F Coordinate security patches\n[Security Patch Deployment]:\n  \u002F\u002F Scan all repositories\n  Bash(`gh repo list org --limit 100 --json name | jq -r '.[].name' | \\\n    while read -r repo; do\n      gh repo clone org\u002F$repo \u002Ftmp\u002F$repo -- --depth=1\n      cd \u002Ftmp\u002F$repo\n      npm audit --json > \u002Ftmp\u002Faudit-$repo.json\n    done`)\n\n  \u002F\u002F Apply patches\n  Bash(`for repo in \u002Ftmp\u002Faudit-*.json; do\n    if [ $(jq '.vulnerabilities | length' $repo) -gt 0 ]; then\n      cd \u002Ftmp\u002F$(basename $repo .json | sed 's\u002Faudit-\u002F\u002F')\n      npm audit fix\n\n      if npm test; then\n        git checkout -b security\u002Fpatch-$(date +%Y%m%d)\n        git add -A\n        git commit -m \"security: Apply security patches\"\n        git push origin HEAD\n        gh pr create --title \"Security patches\" --label \"security\"\n      fi\n    fi\n  done`)\n```\n\n## Configuration\n\n### Multi-Repo Config File\n```yaml\n# .swarm\u002Fmulti-repo.yml\nversion: 1\norganization: my-org\n\nrepositories:\n  - name: frontend\n    url: github.com\u002Fmy-org\u002Ffrontend\n    role: ui\n    agents: [coder, designer, tester]\n\n  - name: backend\n    url: github.com\u002Fmy-org\u002Fbackend\n    role: api\n    agents: [architect, coder, tester]\n\n  - name: shared\n    url: github.com\u002Fmy-org\u002Fshared\n    role: library\n    agents: [analyst, coder]\n\ncoordination:\n  topology: hierarchical\n  communication: webhook\n  memory: redis:\u002F\u002Fshared-memory\n\ndependencies:\n  - from: frontend\n    to: [backend, shared]\n  - from: backend\n    to: [shared]\n```\n\n### Repository Roles\n```javascript\n{\n  \"roles\": {\n    \"ui\": {\n      \"responsibilities\": [\"user-interface\", \"ux\", \"accessibility\"],\n      \"default-agents\": [\"designer\", \"coder\", \"tester\"]\n    },\n    \"api\": {\n      \"responsibilities\": [\"endpoints\", \"business-logic\", \"data\"],\n      \"default-agents\": [\"architect\", \"coder\", \"security\"]\n    },\n    \"library\": {\n      \"responsibilities\": [\"shared-code\", \"utilities\", \"types\"],\n      \"default-agents\": [\"analyst\", \"coder\", \"documenter\"]\n    }\n  }\n}\n```\n\n## Communication Strategies\n\n### 1. Webhook-Based Coordination\n```javascript\nconst { MultiRepoSwarm } = require('ruv-swarm');\n\nconst swarm = new MultiRepoSwarm({\n  webhook: {\n    url: 'https:\u002F\u002Fswarm-coordinator.example.com',\n    secret: process.env.WEBHOOK_SECRET\n  }\n});\n\nswarm.on('repo:update', async (event) => {\n  await swarm.propagate(event, {\n    to: event.dependencies,\n    strategy: 'eventual-consistency'\n  });\n});\n```\n\n### 2. Event Streaming\n```yaml\n# Kafka configuration for real-time coordination\nkafka:\n  brokers: ['kafka1:9092', 'kafka2:9092']\n  topics:\n    swarm-events:\n      partitions: 10\n      replication: 3\n    swarm-memory:\n      partitions: 5\n      replication: 3\n```\n\n## Synchronization Patterns\n\n### 1. Eventually Consistent\n```javascript\n{\n  \"sync\": {\n    \"strategy\": \"eventual\",\n    \"max-lag\": \"5m\",\n    \"retry\": {\n      \"attempts\": 3,\n      \"backoff\": \"exponential\"\n    }\n  }\n}\n```\n\n### 2. Strong Consistency\n```javascript\n{\n  \"sync\": {\n    \"strategy\": \"strong\",\n    \"consensus\": \"raft\",\n    \"quorum\": 0.51,\n    \"timeout\": \"30s\"\n  }\n}\n```\n\n### 3. Hybrid Approach\n```javascript\n{\n  \"sync\": {\n    \"default\": \"eventual\",\n    \"overrides\": {\n      \"security-updates\": \"strong\",\n      \"dependency-updates\": \"strong\",\n      \"documentation\": \"eventual\"\n    }\n  }\n}\n```\n\n## Use Cases\n\n### 1. Microservices Coordination\n```bash\nnpx claude-flow skill run github-multi-repo microservices \\\n  --services \"auth,users,orders,payments\" \\\n  --ensure-compatibility \\\n  --sync-contracts \\\n  --integration-tests\n```\n\n### 2. Library Updates\n```bash\nnpx claude-flow skill run github-multi-repo lib-update \\\n  --library \"org\u002Fshared-lib\" \\\n  --version \"2.0.0\" \\\n  --find-consumers \\\n  --update-imports \\\n  --run-tests\n```\n\n### 3. Organization-Wide Changes\n```bash\nnpx claude-flow skill run github-multi-repo org-policy \\\n  --policy \"add-security-headers\" \\\n  --repos \"org\u002F*\" \\\n  --validate-compliance \\\n  --create-reports\n```\n\n## Architecture Patterns\n\n### Monorepo Structure\n```\nruv-FANN\u002F\n├── packages\u002F\n│   ├── claude-code-flow\u002F\n│   │   ├── src\u002F\n│   │   ├── .claude\u002F\n│   │   └── package.json\n│   ├── ruv-swarm\u002F\n│   │   ├── src\u002F\n│   │   ├── wasm\u002F\n│   │   └── package.json\n│   └── shared\u002F\n│       ├── types\u002F\n│       ├── utils\u002F\n│       └── config\u002F\n├── tools\u002F\n│   ├── build\u002F\n│   ├── test\u002F\n│   └── deploy\u002F\n├── docs\u002F\n│   ├── architecture\u002F\n│   ├── integration\u002F\n│   └── examples\u002F\n└── .github\u002F\n    ├── workflows\u002F\n    ├── templates\u002F\n    └── actions\u002F\n```\n\n### Command Structure\n```\n.claude\u002F\n├── commands\u002F\n│   ├── github\u002F\n│   │   ├── github-modes.md\n│   │   ├── pr-manager.md\n│   │   ├── issue-tracker.md\n│   │   └── sync-coordinator.md\n│   ├── sparc\u002F\n│   │   ├── sparc-modes.md\n│   │   ├── coder.md\n│   │   └── tester.md\n│   └── swarm\u002F\n│       ├── coordination.md\n│       └── orchestration.md\n├── templates\u002F\n│   ├── issue.md\n│   ├── pr.md\n│   └── project.md\n└── config.json\n```\n\n## Monitoring & Visualization\n\n### Multi-Repo Dashboard\n```bash\nnpx claude-flow skill run github-multi-repo dashboard \\\n  --port 3000 \\\n  --metrics \"agent-activity,task-progress,memory-usage\" \\\n  --real-time\n```\n\n### Dependency Graph\n```bash\nnpx claude-flow skill run github-multi-repo dep-graph \\\n  --format mermaid \\\n  --include-agents \\\n  --show-data-flow\n```\n\n### Health Monitoring\n```bash\nnpx claude-flow skill run github-multi-repo health-check \\\n  --repos \"org\u002F*\" \\\n  --check \"connectivity,memory,agents\" \\\n  --alert-on-issues\n```\n\n## Best Practices\n\n### 1. Repository Organization\n- Clear repository roles and boundaries\n- Consistent naming conventions\n- Documented dependencies\n- Shared configuration standards\n\n### 2. Communication\n- Use appropriate sync strategies\n- Implement circuit breakers\n- Monitor latency and failures\n- Clear error propagation\n\n### 3. Security\n- Secure cross-repo authentication\n- Encrypted communication channels\n- Audit trail for all operations\n- Principle of least privilege\n\n### 4. Version Management\n- Semantic versioning alignment\n- Dependency compatibility validation\n- Automated version bump coordination\n\n### 5. Testing Integration\n- Cross-package test validation\n- Integration test automation\n- Performance regression detection\n\n## Performance Optimization\n\n### Caching Strategy\n```bash\nnpx claude-flow skill run github-multi-repo cache-strategy \\\n  --analyze-patterns \\\n  --suggest-cache-layers \\\n  --implement-invalidation\n```\n\n### Parallel Execution\n```bash\nnpx claude-flow skill run github-multi-repo parallel-optimize \\\n  --analyze-dependencies \\\n  --identify-parallelizable \\\n  --execute-optimal\n```\n\n### Resource Pooling\n```bash\nnpx claude-flow skill run github-multi-repo resource-pool \\\n  --share-agents \\\n  --distribute-load \\\n  --monitor-usage\n```\n\n## Troubleshooting\n\n### Connectivity Issues\n```bash\nnpx claude-flow skill run github-multi-repo diagnose-connectivity \\\n  --test-all-repos \\\n  --check-permissions \\\n  --verify-webhooks\n```\n\n### Memory Synchronization\n```bash\nnpx claude-flow skill run github-multi-repo debug-memory \\\n  --check-consistency \\\n  --identify-conflicts \\\n  --repair-state\n```\n\n### Performance Bottlenecks\n```bash\nnpx claude-flow skill run github-multi-repo perf-analysis \\\n  --profile-operations \\\n  --identify-bottlenecks \\\n  --suggest-optimizations\n```\n\n## Advanced Features\n\n### 1. Distributed Task Queue\n```bash\nnpx claude-flow skill run github-multi-repo queue \\\n  --backend redis \\\n  --workers 10 \\\n  --priority-routing \\\n  --dead-letter-queue\n```\n\n### 2. Cross-Repo Testing\n```bash\nnpx claude-flow skill run github-multi-repo test \\\n  --setup-test-env \\\n  --link-services \\\n  --run-e2e \\\n  --tear-down\n```\n\n### 3. Monorepo Migration\n```bash\nnpx claude-flow skill run github-multi-repo to-monorepo \\\n  --analyze-repos \\\n  --suggest-structure \\\n  --preserve-history \\\n  --create-migration-prs\n```\n\n## Examples\n\n### Full-Stack Application Update\n```bash\nnpx claude-flow skill run github-multi-repo fullstack-update \\\n  --frontend \"org\u002Fweb-app\" \\\n  --backend \"org\u002Fapi-server\" \\\n  --database \"org\u002Fdb-migrations\" \\\n  --coordinate-deployment\n```\n\n### Cross-Team Collaboration\n```bash\nnpx claude-flow skill run github-multi-repo cross-team \\\n  --teams \"frontend,backend,devops\" \\\n  --task \"implement-feature-x\" \\\n  --assign-by-expertise \\\n  --track-progress\n```\n\n## Metrics and Reporting\n\n### Sync Quality Metrics\n- Package version alignment percentage\n- Documentation consistency score\n- Integration test success rate\n- Synchronization completion time\n\n### Architecture Health Metrics\n- Repository structure consistency score\n- Documentation coverage percentage\n- Cross-repository integration success rate\n- Template adoption and usage statistics\n\n### Automated Reporting\n- Weekly sync status reports\n- Dependency drift detection\n- Documentation divergence alerts\n- Integration health monitoring\n\n## Integration Points\n\n### Related Skills\n- `github-workflow` - GitHub workflow automation\n- `github-pr` - Pull request management\n- `sparc-architect` - Architecture design\n- `sparc-optimizer` - Performance optimization\n\n### Related Commands\n- `\u002Fgithub sync-coordinator` - Cross-repo synchronization\n- `\u002Fgithub release-manager` - Coordinated releases\n- `\u002Fgithub repo-architect` - Repository optimization\n- `\u002Fsparc architect` - Detailed architecture design\n\n## Support and Resources\n\n- Documentation: https:\u002F\u002Fgithub.com\u002Fruvnet\u002Fclaude-flow\n- Issues: https:\u002F\u002Fgithub.com\u002Fruvnet\u002Fclaude-flow\u002Fissues\n- Examples: `.claude\u002Fexamples\u002Fgithub-multi-repo\u002F`\n\n---\n\n**Version:** 1.0.0\n**Last Updated:** 2025-10-19\n**Maintainer:** Claude Flow Team\n","# GitHub Multi-Repository Coordination Skill\n\n## Overview\n\nAdvanced multi-repository coordination system that combines swarm intelligence, package synchronization, and repository architecture optimization. This skill enables organization-wide automation, cross-project collaboration, and scalable repository management.\n\n## Core Capabilities\n\n### ? Multi-Repository Swarm Coordination\nCross-repository AI swarm orchestration for distributed development workflows.\n\n### ? Package Synchronization\nIntelligent dependency resolution and version alignment across multiple packages.\n\n### ?️ Repository Architecture\nStructure optimization and template management for scalable projects.\n\n### ? Integration Management\nCross-package integration testing and deployment coordination.\n\n## Quick Start\n\n### Initialize Multi-Repo Coordination\n```bash\n# Basic swarm initialization\nnpx claude-flow skill run github-multi-repo init \\\n  --repos \"org\u002Ffrontend,org\u002Fbackend,org\u002Fshared\" \\\n  --topology hierarchical\n\n# Advanced initialization with synchronization\nnpx claude-flow skill run github-multi-repo init \\\n  --repos \"org\u002Ffrontend,org\u002Fbackend,org\u002Fshared\" \\\n  --topology mesh \\\n  --shared-memory \\\n  --sync-strategy eventual\n```\n\n### Synchronize Packages\n```bash\n# Synchronize package versions and dependencies\nnpx claude-flow skill run github-multi-repo sync \\\n  --packages \"claude-code-flow,ruv-swarm\" \\\n  --align-versions \\\n  --update-docs\n```\n\n### Optimize Architecture\n```bash\n# Analyze and optimize repository structure\nnpx claude-flow skill run github-multi-repo optimize \\\n  --analyze-structure \\\n  --suggest-improvements \\\n  --create-templates\n```\n\n## Features\n\n### 1. Cross-Repository Swarm Orchestration\n\n#### Repository Discovery\n```javascript\n\u002F\u002F Auto-discover related repositories with gh CLI\nconst REPOS = Bash(`gh repo list my-organization --limit 100 \\\n  --json name,description,languages,topics \\\n  --jq '.[] | select(.languages | keys | contains([\"TypeScript\"]))'`)\n\n\u002F\u002F Analyze repository dependencies\nconst DEPS = Bash(`gh repo list my-organization --json name | \\\n  jq -r '.[].name' | while read -r repo; do\n    gh api repos\u002Fmy-organization\u002F$repo\u002Fcontents\u002Fpackage.json \\\n      --jq '.content' 2>\u002Fdev\u002Fnull | base64 -d | jq '{name, dependencies}'\n  done | jq -s '.'`)\n\n\u002F\u002F Initialize swarm with discovered repositories\nmcp__claude-flow__swarm_init({\n  topology: \"hierarchical\",\n  maxAgents: 8,\n  metadata: { repos: REPOS, dependencies: DEPS }\n})\n```\n\n#### Synchronized Operations\n```javascript\n\u002F\u002F Execute synchronized changes across repositories\n[Parallel Multi-Repo Operations]:\n  \u002F\u002F Spawn coordination agents\n  Task(\"Repository Coordinator\", \"Coordinate changes across all repositories\", \"coordinator\")\n  Task(\"Dependency Analyzer\", \"Analyze cross-repo dependencies\", \"analyst\")\n  Task(\"Integration Tester\", \"Validate cross-repo changes\", \"tester\")\n\n  \u002F\u002F Get matching repositories\n  Bash(`gh repo list org --limit 100 --json name \\\n    --jq '.[] | select(.name | test(\"-service$\")) | .name' > \u002Ftmp\u002Frepos.txt`)\n\n  \u002F\u002F Execute task across repositories\n  Bash(`cat \u002Ftmp\u002Frepos.txt | while read -r repo; do\n    gh repo clone org\u002F$repo \u002Ftmp\u002F$repo -- --depth=1\n    cd \u002Ftmp\u002F$repo\n\n    # Apply changes\n    npm update\n    npm test\n\n    # Create PR if successful\n    if [ $? -eq 0 ]; then\n      git checkout -b update-dependencies-$(date +%Y%m%d)\n      git add -A\n      git commit -m \"chore: Update dependencies\"\n      git push origin HEAD\n      gh pr create --title \"Update dependencies\" --body \"Automated update\" --label \"dependencies\"\n    fi\n  done`)\n\n  \u002F\u002F Track all operations\n  TodoWrite { todos: [\n    { id: \"discover\", content: \"Discover all service repositories\", status: \"completed\" },\n    { id: \"update\", content: \"Update dependencies\", status: \"completed\" },\n    { id: \"test\", content: \"Run integration tests\", status: \"in_progress\" },\n    { id: \"pr\", content: \"Create pull requests\", status: \"pending\" }\n  ]}\n```\n\n### 2. Package Synchronization\n\n#### Version Alignment\n```javascript\n\u002F\u002F Synchronize package dependencies and versions\n[Complete Package Sync]:\n  \u002F\u002F Initialize sync swarm\n  mcp__claude-flow__swarm_init({ topology: \"mesh\", maxAgents: 5 })\n\n  \u002F\u002F Spawn sync agents\n  Task(\"Sync Coordinator\", \"Coordinate version alignment\", \"coordinator\")\n  Task(\"Dependency Analyzer\", \"Analyze dependencies\", \"analyst\")\n  Task(\"Integration Tester\", \"Validate synchronization\", \"tester\")\n\n  \u002F\u002F Read package states\n  Read(\"\u002Fworkspaces\u002Fruv-FANN\u002Fclaude-code-flow\u002Fclaude-code-flow\u002Fpackage.json\")\n  Read(\"\u002Fworkspaces\u002Fruv-FANN\u002Fruv-swarm\u002Fnpm\u002Fpackage.json\")\n\n  \u002F\u002F Align versions using gh CLI\n  Bash(`gh api repos\u002F:owner\u002F:repo\u002Fgit\u002Frefs \\\n    -f ref='refs\u002Fheads\u002Fsync\u002Fpackage-alignment' \\\n    -f sha=$(gh api repos\u002F:owner\u002F:repo\u002Fgit\u002Frefs\u002Fheads\u002Fmain --jq '.object.sha')`)\n\n  \u002F\u002F Update package.json files\n  Bash(`gh api repos\u002F:owner\u002F:repo\u002Fcontents\u002Fpackage.json \\\n    --method PUT \\\n    -f message=\"feat: Align Node.js version requirements\" \\\n    -f branch=\"sync\u002Fpackage-alignment\" \\\n    -f content=\"$(cat aligned-package.json | base64)\"`)\n\n  \u002F\u002F Store sync state\n  mcp__claude-flow__memory_usage({\n    action: \"store\",\n    key: \"sync\u002Fpackages\u002Fstatus\",\n    value: {\n      timestamp: Date.now(),\n      packages_synced: [\"claude-code-flow\", \"ruv-swarm\"],\n      status: \"synchronized\"\n    }\n  })\n```\n\n#### Documentation Synchronization\n```javascript\n\u002F\u002F Synchronize CLAUDE.md files across packages\n[Documentation Sync]:\n  \u002F\u002F Get source documentation\n  Bash(`gh api repos\u002F:owner\u002F:repo\u002Fcontents\u002Fruv-swarm\u002Fdocs\u002FCLAUDE.md \\\n    --jq '.content' | base64 -d > \u002Ftmp\u002Fclaude-source.md`)\n\n  \u002F\u002F Update target documentation\n  Bash(`gh api repos\u002F:owner\u002F:repo\u002Fcontents\u002Fclaude-code-flow\u002FCLAUDE.md \\\n    --method PUT \\\n    -f message=\"docs: Synchronize CLAUDE.md\" \\\n    -f branch=\"sync\u002Fdocumentation\" \\\n    -f content=\"$(cat \u002Ftmp\u002Fclaude-source.md | base64)\"`)\n\n  \u002F\u002F Track sync status\n  mcp__claude-flow__memory_usage({\n    action: \"store\",\n    key: \"sync\u002Fdocumentation\u002Fstatus\",\n    value: { status: \"synchronized\", files: [\"CLAUDE.md\"] }\n  })\n```\n\n#### Cross-Package Integration\n```javascript\n\u002F\u002F Coordinate feature implementation across packages\n[Cross-Package Feature]:\n  \u002F\u002F Push changes to all packages\n  mcp__github__push_files({\n    branch: \"feature\u002Fgithub-integration\",\n    files: [\n      {\n        path: \"claude-code-flow\u002F.claude\u002Fcommands\u002Fgithub\u002Fgithub-modes.md\",\n        content: \"[GitHub modes documentation]\"\n      },\n      {\n        path: \"ruv-swarm\u002Fsrc\u002Fgithub-coordinator\u002Fhooks.js\",\n        content: \"[GitHub coordination hooks]\"\n      }\n    ],\n    message: \"feat: Add GitHub workflow integration\"\n  })\n\n  \u002F\u002F Create coordinated PR\n  Bash(`gh pr create \\\n    --title \"Feature: GitHub Workflow Integration\" \\\n    --body \"## ? GitHub Integration\n\n### Features\n- ✅ Multi-repo coordination\n- ✅ Package synchronization\n- ✅ Architecture optimization\n\n### Testing\n- [x] Package dependency verification\n- [x] Integration tests\n- [x] Cross-package compatibility\"`)\n```\n\n### 3. Repository Architecture\n\n#### Structure Analysis\n```javascript\n\u002F\u002F Analyze and optimize repository structure\n[Architecture Analysis]:\n  \u002F\u002F Initialize architecture swarm\n  mcp__claude-flow__swarm_init({ topology: \"hierarchical\", maxAgents: 6 })\n\n  \u002F\u002F Spawn architecture agents\n  Task(\"Senior Architect\", \"Analyze repository structure\", \"architect\")\n  Task(\"Structure Analyst\", \"Identify optimization opportunities\", \"analyst\")\n  Task(\"Performance Optimizer\", \"Optimize structure for scalability\", \"optimizer\")\n  Task(\"Best Practices Researcher\", \"Research architecture patterns\", \"researcher\")\n\n  \u002F\u002F Analyze current structures\n  LS(\"\u002Fworkspaces\u002Fruv-FANN\u002Fclaude-code-flow\u002Fclaude-code-flow\")\n  LS(\"\u002Fworkspaces\u002Fruv-FANN\u002Fruv-swarm\u002Fnpm\")\n\n  \u002F\u002F Search for best practices\n  Bash(`gh search repos \"language:javascript template architecture\" \\\n    --limit 10 \\\n    --json fullName,description,stargazersCount \\\n    --sort stars \\\n    --order desc`)\n\n  \u002F\u002F Store analysis results\n  mcp__claude-flow__memory_usage({\n    action: \"store\",\n    key: \"architecture\u002Fanalysis\u002Fresults\",\n    value: {\n      repositories_analyzed: [\"claude-code-flow\", \"ruv-swarm\"],\n      optimization_areas: [\"structure\", \"workflows\", \"templates\"],\n      recommendations: [\"standardize_structure\", \"improve_workflows\"]\n    }\n  })\n```\n\n#### Template Creation\n```javascript\n\u002F\u002F Create standardized repository template\n[Template Creation]:\n  \u002F\u002F Create template repository\n  mcp__github__create_repository({\n    name: \"claude-project-template\",\n    description: \"Standardized template for Claude Code projects\",\n    private: false,\n    autoInit: true\n  })\n\n  \u002F\u002F Push template structure\n  mcp__github__push_files({\n    repo: \"claude-project-template\",\n    files: [\n      {\n        path: \".claude\u002Fcommands\u002Fgithub\u002Fgithub-modes.md\",\n        content: \"[GitHub modes template]\"\n      },\n      {\n        path: \".claude\u002Fconfig.json\",\n        content: JSON.stringify({\n          version: \"1.0\",\n          mcp_servers: {\n            \"ruv-swarm\": {\n              command: \"npx\",\n              args: [\"ruv-swarm\", \"mcp\", \"start\"]\n            }\n          }\n        })\n      },\n      {\n        path: \"CLAUDE.md\",\n        content: \"[Standardized CLAUDE.md]\"\n      },\n      {\n        path: \"package.json\",\n        content: JSON.stringify({\n          name: \"claude-project-template\",\n          engines: { node: \">=20.0.0\" },\n          dependencies: { \"ruv-swarm\": \"^1.0.11\" }\n        })\n      }\n    ],\n    message: \"feat: Create standardized template\"\n  })\n```\n\n#### Cross-Repository Standardization\n```javascript\n\u002F\u002F Synchronize structure across repositories\n[Structure Standardization]:\n  const repositories = [\"claude-code-flow\", \"ruv-swarm\", \"claude-extensions\"]\n\n  \u002F\u002F Update common files across all repositories\n  repositories.forEach(repo => {\n    mcp__github__create_or_update_file({\n      repo: \"ruv-FANN\",\n      path: `${repo}\u002F.github\u002Fworkflows\u002Fintegration.yml`,\n      content: `name: Integration Tests\non: [push, pull_request]\njobs:\n  test:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v3\n      - uses: actions\u002Fsetup-node@v3\n        with: { node-version: '20' }\n      - run: npm install && npm test`,\n      message: \"ci: Standardize integration workflow\",\n      branch: \"structure\u002Fstandardization\"\n    })\n  })\n```\n\n### 4. Orchestration Workflows\n\n#### Dependency Management\n```javascript\n\u002F\u002F Update dependencies across all repositories\n[Organization-Wide Dependency Update]:\n  \u002F\u002F Create tracking issue\n  TRACKING_ISSUE=$(Bash(`gh issue create \\\n    --title \"Dependency Update: typescript@5.0.0\" \\\n    --body \"Tracking TypeScript update across all repositories\" \\\n    --label \"dependencies,tracking\" \\\n    --json number -q .number`))\n\n  \u002F\u002F Find all TypeScript repositories\n  TS_REPOS=$(Bash(`gh repo list org --limit 100 --json name | \\\n    jq -r '.[].name' | while read -r repo; do\n      if gh api repos\u002Forg\u002F$repo\u002Fcontents\u002Fpackage.json 2>\u002Fdev\u002Fnull | \\\n         jq -r '.content' | base64 -d | grep -q '\"typescript\"'; then\n        echo \"$repo\"\n      fi\n    done`))\n\n  \u002F\u002F Update each repository\n  Bash(`echo \"$TS_REPOS\" | while read -r repo; do\n    gh repo clone org\u002F$repo \u002Ftmp\u002F$repo -- --depth=1\n    cd \u002Ftmp\u002F$repo\n\n    npm install --save-dev typescript@5.0.0\n\n    if npm test; then\n      git checkout -b update-typescript-5\n      git add package.json package-lock.json\n      git commit -m \"chore: Update TypeScript to 5.0.0\n\nPart of #$TRACKING_ISSUE\"\n\n      git push origin HEAD\n      gh pr create \\\n        --title \"Update TypeScript to 5.0.0\" \\\n        --body \"Updates TypeScript\\n\\nTracking: #$TRACKING_ISSUE\" \\\n        --label \"dependencies\"\n    else\n      gh issue comment $TRACKING_ISSUE \\\n        --body \"❌ Failed to update $repo - tests failing\"\n    fi\n  done`)\n```\n\n#### Refactoring Operations\n```javascript\n\u002F\u002F Coordinate large-scale refactoring\n[Cross-Repo Refactoring]:\n  \u002F\u002F Initialize refactoring swarm\n  mcp__claude-flow__swarm_init({ topology: \"mesh\", maxAgents: 8 })\n\n  \u002F\u002F Spawn specialized agents\n  Task(\"Refactoring Coordinator\", \"Coordinate refactoring across repos\", \"coordinator\")\n  Task(\"Impact Analyzer\", \"Analyze refactoring impact\", \"analyst\")\n  Task(\"Code Transformer\", \"Apply refactoring changes\", \"coder\")\n  Task(\"Migration Guide Creator\", \"Create migration documentation\", \"documenter\")\n  Task(\"Integration Tester\", \"Validate refactored code\", \"tester\")\n\n  \u002F\u002F Execute refactoring\n  mcp__claude-flow__task_orchestrate({\n    task: \"Rename OldAPI to NewAPI across all repositories\",\n    strategy: \"sequential\",\n    priority: \"high\"\n  })\n```\n\n#### Security Updates\n```javascript\n\u002F\u002F Coordinate security patches\n[Security Patch Deployment]:\n  \u002F\u002F Scan all repositories\n  Bash(`gh repo list org --limit 100 --json name | jq -r '.[].name' | \\\n    while read -r repo; do\n      gh repo clone org\u002F$repo \u002Ftmp\u002F$repo -- --depth=1\n      cd \u002Ftmp\u002F$repo\n      npm audit --json > \u002Ftmp\u002Faudit-$repo.json\n    done`)\n\n  \u002F\u002F Apply patches\n  Bash(`for repo in \u002Ftmp\u002Faudit-*.json; do\n    if [ $(jq '.vulnerabilities | length' $repo) -gt 0 ]; then\n      cd \u002Ftmp\u002F$(basename $repo .json | sed 's\u002Faudit-\u002F\u002F')\n      npm audit fix\n\n      if npm test; then\n        git checkout -b security\u002Fpatch-$(date +%Y%m%d)\n        git add -A\n        git commit -m \"security: Apply security patches\"\n        git push origin HEAD\n        gh pr create --title \"Security patches\" --label \"security\"\n      fi\n    fi\n  done`)\n```\n\n## Configuration\n\n### Multi-Repo Config File\n```yaml\n# .swarm\u002Fmulti-repo.yml\nversion: 1\norganization: my-org\n\nrepositories:\n  - name: frontend\n    url: github.com\u002Fmy-org\u002Ffrontend\n    role: ui\n    agents: [coder, designer, tester]\n\n  - name: backend\n    url: github.com\u002Fmy-org\u002Fbackend\n    role: api\n    agents: [architect, coder, tester]\n\n  - name: shared\n    url: github.com\u002Fmy-org\u002Fshared\n    role: library\n    agents: [analyst, coder]\n\ncoordination:\n  topology: hierarchical\n  communication: webhook\n  memory: redis:\u002F\u002Fshared-memory\n\ndependencies:\n  - from: frontend\n    to: [backend, shared]\n  - from: backend\n    to: [shared]\n```\n\n### Repository Roles\n```javascript\n{\n  \"roles\": {\n    \"ui\": {\n      \"responsibilities\": [\"user-interface\", \"ux\", \"accessibility\"],\n      \"default-agents\": [\"designer\", \"coder\", \"tester\"]\n    },\n    \"api\": {\n      \"responsibilities\": [\"endpoints\", \"business-logic\", \"data\"],\n      \"default-agents\": [\"architect\", \"coder\", \"security\"]\n    },\n    \"library\": {\n      \"responsibilities\": [\"shared-code\", \"utilities\", \"types\"],\n      \"default-agents\": [\"analyst\", \"coder\", \"documenter\"]\n    }\n  }\n}\n```\n\n## Communication Strategies\n\n### 1. Webhook-Based Coordination\n```javascript\nconst { MultiRepoSwarm } = require('ruv-swarm');\n\nconst swarm = new MultiRepoSwarm({\n  webhook: {\n    url: 'https:\u002F\u002Fswarm-coordinator.example.com',\n    secret: process.env.WEBHOOK_SECRET\n  }\n});\n\nswarm.on('repo:update', async (event) => {\n  await swarm.propagate(event, {\n    to: event.dependencies,\n    strategy: 'eventual-consistency'\n  });\n});\n```\n\n### 2. Event Streaming\n```yaml\n# Kafka configuration for real-time coordination\nkafka:\n  brokers: ['kafka1:9092', 'kafka2:9092']\n  topics:\n    swarm-events:\n      partitions: 10\n      replication: 3\n    swarm-memory:\n      partitions: 5\n      replication: 3\n```\n\n## Synchronization Patterns\n\n### 1. Eventually Consistent\n```javascript\n{\n  \"sync\": {\n    \"strategy\": \"eventual\",\n    \"max-lag\": \"5m\",\n    \"retry\": {\n      \"attempts\": 3,\n      \"backoff\": \"exponential\"\n    }\n  }\n}\n```\n\n### 2. Strong Consistency\n```javascript\n{\n  \"sync\": {\n    \"strategy\": \"strong\",\n    \"consensus\": \"raft\",\n    \"quorum\": 0.51,\n    \"timeout\": \"30s\"\n  }\n}\n```\n\n### 3. Hybrid Approach\n```javascript\n{\n  \"sync\": {\n    \"default\": \"eventual\",\n    \"overrides\": {\n      \"security-updates\": \"strong\",\n      \"dependency-updates\": \"strong\",\n      \"documentation\": \"eventual\"\n    }\n  }\n}\n```\n\n## Use Cases\n\n### 1. Microservices Coordination\n```bash\nnpx claude-flow skill run github-multi-repo microservices \\\n  --services \"auth,users,orders,payments\" \\\n  --ensure-compatibility \\\n  --sync-contracts \\\n  --integration-tests\n```\n\n### 2. Library Updates\n```bash\nnpx claude-flow skill run github-multi-repo lib-update \\\n  --library \"org\u002Fshared-lib\" \\\n  --version \"2.0.0\" \\\n  --find-consumers \\\n  --update-imports \\\n  --run-tests\n```\n\n### 3. Organization-Wide Changes\n```bash\nnpx claude-flow skill run github-multi-repo org-policy \\\n  --policy \"add-security-headers\" \\\n  --repos \"org\u002F*\" \\\n  --validate-compliance \\\n  --create-reports\n```\n\n## Architecture Patterns\n\n### Monorepo Structure\n```\nruv-FANN\u002F\n├── packages\u002F\n│   ├── claude-code-flow\u002F\n│   │   ├── src\u002F\n│   │   ├── .claude\u002F\n│   │   └── package.json\n│   ├── ruv-swarm\u002F\n│   │   ├── src\u002F\n│   │   ├── wasm\u002F\n│   │   └── package.json\n│   └── shared\u002F\n│       ├── types\u002F\n│       ├── utils\u002F\n│       └── config\u002F\n├── tools\u002F\n│   ├── build\u002F\n│   ├── test\u002F\n│   └── deploy\u002F\n├── docs\u002F\n│   ├── architecture\u002F\n│   ├── integration\u002F\n│   └── examples\u002F\n└── .github\u002F\n    ├── workflows\u002F\n    ├── templates\u002F\n    └── actions\u002F\n```\n\n### Command Structure\n```\n.claude\u002F\n├── commands\u002F\n│   ├── github\u002F\n│   │   ├── github-modes.md\n│   │   ├── pr-manager.md\n│   │   ├── issue-tracker.md\n│   │   └── sync-coordinator.md\n│   ├── sparc\u002F\n│   │   ├── sparc-modes.md\n│   │   ├── coder.md\n│   │   └── tester.md\n│   └── swarm\u002F\n│       ├── coordination.md\n│       └── orchestration.md\n├── templates\u002F\n│   ├── issue.md\n│   ├── pr.md\n│   └── project.md\n└── config.json\n```\n\n## Monitoring & Visualization\n\n### Multi-Repo Dashboard\n```bash\nnpx claude-flow skill run github-multi-repo dashboard \\\n  --port 3000 \\\n  --metrics \"agent-activity,task-progress,memory-usage\" \\\n  --real-time\n```\n\n### Dependency Graph\n```bash\nnpx claude-flow skill run github-multi-repo dep-graph \\\n  --format mermaid \\\n  --include-agents \\\n  --show-data-flow\n```\n\n### Health Monitoring\n```bash\nnpx claude-flow skill run github-multi-repo health-check \\\n  --repos \"org\u002F*\" \\\n  --check \"connectivity,memory,agents\" \\\n  --alert-on-issues\n```\n\n## Best Practices\n\n### 1. Repository Organization\n- Clear repository roles and boundaries\n- Consistent naming conventions\n- Documented dependencies\n- Shared configuration standards\n\n### 2. Communication\n- Use appropriate sync strategies\n- Implement circuit breakers\n- Monitor latency and failures\n- Clear error propagation\n\n### 3. Security\n- Secure cross-repo authentication\n- Encrypted communication channels\n- Audit trail for all operations\n- Principle of least privilege\n\n### 4. Version Management\n- Semantic versioning alignment\n- Dependency compatibility validation\n- Automated version bump coordination\n\n### 5. Testing Integration\n- Cross-package test validation\n- Integration test automation\n- Performance regression detection\n\n## Performance Optimization\n\n### Caching Strategy\n```bash\nnpx claude-flow skill run github-multi-repo cache-strategy \\\n  --analyze-patterns \\\n  --suggest-cache-layers \\\n  --implement-invalidation\n```\n\n### Parallel Execution\n```bash\nnpx claude-flow skill run github-multi-repo parallel-optimize \\\n  --analyze-dependencies \\\n  --identify-parallelizable \\\n  --execute-optimal\n```\n\n### Resource Pooling\n```bash\nnpx claude-flow skill run github-multi-repo resource-pool \\\n  --share-agents \\\n  --distribute-load \\\n  --monitor-usage\n```\n\n## Troubleshooting\n\n### Connectivity Issues\n```bash\nnpx claude-flow skill run github-multi-repo diagnose-connectivity \\\n  --test-all-repos \\\n  --check-permissions \\\n  --verify-webhooks\n```\n\n### Memory Synchronization\n```bash\nnpx claude-flow skill run github-multi-repo debug-memory \\\n  --check-consistency \\\n  --identify-conflicts \\\n  --repair-state\n```\n\n### Performance Bottlenecks\n```bash\nnpx claude-flow skill run github-multi-repo perf-analysis \\\n  --profile-operations \\\n  --identify-bottlenecks \\\n  --suggest-optimizations\n```\n\n## Advanced Features\n\n### 1. Distributed Task Queue\n```bash\nnpx claude-flow skill run github-multi-repo queue \\\n  --backend redis \\\n  --workers 10 \\\n  --priority-routing \\\n  --dead-letter-queue\n```\n\n### 2. Cross-Repo Testing\n```bash\nnpx claude-flow skill run github-multi-repo test \\\n  --setup-test-env \\\n  --link-services \\\n  --run-e2e \\\n  --tear-down\n```\n\n### 3. Monorepo Migration\n```bash\nnpx claude-flow skill run github-multi-repo to-monorepo \\\n  --analyze-repos \\\n  --suggest-structure \\\n  --preserve-history \\\n  --create-migration-prs\n```\n\n## Examples\n\n### Full-Stack Application Update\n```bash\nnpx claude-flow skill run github-multi-repo fullstack-update \\\n  --frontend \"org\u002Fweb-app\" \\\n  --backend \"org\u002Fapi-server\" \\\n  --database \"org\u002Fdb-migrations\" \\\n  --coordinate-deployment\n```\n\n### Cross-Team Collaboration\n```bash\nnpx claude-flow skill run github-multi-repo cross-team \\\n  --teams \"frontend,backend,devops\" \\\n  --task \"implement-feature-x\" \\\n  --assign-by-expertise \\\n  --track-progress\n```\n\n## Metrics and Reporting\n\n### Sync Quality Metrics\n- Package version alignment percentage\n- Documentation consistency score\n- Integration test success rate\n- Synchronization completion time\n\n### Architecture Health Metrics\n- Repository structure consistency score\n- Documentation coverage percentage\n- Cross-repository integration success rate\n- Template adoption and usage statistics\n\n### Automated Reporting\n- Weekly sync status reports\n- Dependency drift detection\n- Documentation divergence alerts\n- Integration health monitoring\n\n## Integration Points\n\n### Related Skills\n- `github-workflow` - GitHub workflow automation\n- `github-pr` - Pull request management\n- `sparc-architect` - Architecture design\n- `sparc-optimizer` - Performance optimization\n\n### Related Commands\n- `\u002Fgithub sync-coordinator` - Cross-repo synchronization\n- `\u002Fgithub release-manager` - Coordinated releases\n- `\u002Fgithub repo-architect` - Repository optimization\n- `\u002Fsparc architect` - Detailed architecture design\n\n## Support and Resources\n\n- Documentation: https:\u002F\u002Fgithub.com\u002Fruvnet\u002Fclaude-flow\n- Issues: https:\u002F\u002Fgithub.com\u002Fruvnet\u002Fclaude-flow\u002Fissues\n- Examples: `.claude\u002Fexamples\u002Fgithub-multi-repo\u002F`\n\n---\n\n**Version:** 1.0.0\n**Last Updated:** 2025-10-19\n**Maintainer:** Claude Flow Team\n",{"name":5,"tags":44,"author":45,"version":46,"category":47,"requires":48,"description":7,"capabilities":51},[32,33,23,34,19],"Claude Flow Team","1.0.0","github-integration",[49,50],"ruv-swarm@^1.0.11","gh-cli@^2.0.0",[52,53,54,55,56],"cross-repository coordination","package synchronization","architecture optimization","template management","distributed workflows","main","def8531e65114c0fca8fb8551c1871ee0eed705c","skills\u002Faiskillstore\u002Fmarketplace\u002Fdnyoussef\u002Fgithub-multi-repo",24,"https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub","https:\u002F\u002Fskillshub.wtf","https:\u002F\u002Fgithub.com\u002FComeOnOliver","AI & Blockchain Engineer\r\n","2026-06-24 22:07:19",{"source":8,"skillName":5,"commands":67,"prompt":77,"zipAvailable":78},[68,71,74],{"tool":69,"command":70},"npx","npx skills add ComeOnOliver\u002Fskillshub --skill github-multi-repo",{"tool":72,"command":73},"bunx","bunx skills add ComeOnOliver\u002Fskillshub --skill github-multi-repo",{"tool":75,"command":76},"pnpm","pnpm dlx skills add ComeOnOliver\u002Fskillshub --skill github-multi-repo","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Faiskillstore\u002Fmarketplace\u002Fdnyoussef\u002Fgithub-multi-repo\u002FSKILL.md",true,[80],{"path":81,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":84,"sourceHtmlUrl":85},"skill-report.json","REFERENCE","参考文档",8914,"https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Faiskillstore\u002Fmarketplace\u002Fdnyoussef\u002Fgithub-multi-repo\u002Fskill-report.json",[87,101,111,120,126,133],{"skillNo":88,"name":89,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":97,"publishedAt":39},"01M6FKJN13GMG4KY57J3QD8GY5","model-hierarchy-skill","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzscole\u002Fmodel-hierarchy-skill\u002Fmodel-hierarchy-skill\u002FSKILL.md",[92],{"categoryNo":93,"categoryName":94,"taxonomyType":95,"taxonomyTypeDesc":96},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[98,99,100],"model","model hierarchy","model hierarchy skill",{"skillNo":102,"name":103,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":107,"publishedAt":39},"01M6FKJJJ6GCAMR4PPPRD12M5X","zoom-mcp","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-mcp\u002FSKILL.md",[106],{"categoryNo":93,"categoryName":94,"taxonomyType":95,"taxonomyTypeDesc":96},[108,109,110],"MCP","zoom","zoom mcp",{"skillNo":112,"name":113,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":39},"01M6FKJE3KYT3KPEZMEEHYKA6K","zoom-apps-sdk","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[117,118,119,109],"sdk","zoom apps sdk","apps",{"skillNo":121,"name":122,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":123,"categories":124,"keywords":125,"publishedAt":39},"01M6FKJ9EDH9Q5VWDF8HAJRSP0","windows","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwindows\u002FSKILL.md",[],[122],{"skillNo":127,"name":128,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":129,"categories":130,"keywords":132,"publishedAt":39},"01M6FKJ666BEEFC3AE9GJ72Q93","whiteboard","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwhiteboard\u002FSKILL.md",[131],{"categoryNo":93,"categoryName":94,"taxonomyType":95,"taxonomyTypeDesc":96},[128],{"skillNo":134,"name":135,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":136,"categories":137,"keywords":138,"publishedAt":39},"01M6FKJ21WFCDGTJQ2Q91T9DVW","websockets","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwebsockets\u002FSKILL.md",[],[135]]