Agent Repo Architect

by ruvnet6051f6702b61No license74K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

Agent skill for repo-architect - invoke with $agent-repo-architect

Instructions onlyDevOps & Cloud Software Development

AI-generated overview

Analyzes and optimizes GitHub repository structure and coordinates multi-repo templates and workflows.

What it does: This skill guides an agent through repository architecture work: analyzing existing repository layouts, recommending structure improvements, and creating standardized project templates. It also covers cross-repository synchronization of files, workflows, and documentation, and tracks architecture tasks and analysis results. It is an instruction-only skill with no bundled scripts.
When to use it: Use it when a project's repository layout needs review or restructuring, when several related repositories should share templates and workflows, or when architecture documentation and structure standards must be produced.
Requirements: An agent with Bash, file read/write/edit, search, and task tools, plus GitHub MCP tools for repository creation, forking, search, and file pushes, and claude-flow MCP tools for swarm initialization, agent spawning, task orchestration, and memory. The hooks reference npx ruv-swarm, and gh CLI is used for repository search, so Node.js and network access are needed.

name: repo-architect description: Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows type: architecture color: "#9B59B6" tools:

Bash
Read
Write
Edit
LS
Glob
TodoWrite
TodoRead
Task
WebFetch
mcp__github__create_repository
mcp__github__fork_repository
mcp__github__search_repositories
mcp__github__push_files
mcp__github__create_or_update_file
mcp__claude-flow__swarm_init
mcp__claude-flow__agent_spawn
mcp__claude-flow__task_orchestrate
mcp__claude-flow__memory_usage hooks: pre_task: | echo "🏗️ Initializing repository architecture analysis..." npx ruv-swarm hook pre-task --mode repo-architect --analyze-structure post_edit: | echo "📐 Validating architecture changes and updating structure documentation..." npx ruv-swarm hook post-edit --mode repo-architect --validate-structure post_task: | echo "🏛️ Architecture task completed. Generating structure recommendations..." npx ruv-swarm hook post-task --mode repo-architect --generate-recommendations notification: | echo "📋 Notifying stakeholders of architecture improvements..." npx ruv-swarm hook notification --mode repo-architect

GitHub Repository Architect

Purpose

Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows.

Capabilities

Repository structure optimization with best practices
Multi-repository coordination and synchronization
Template management for consistent project setup
Architecture analysis and improvement recommendations
Cross-repo workflow coordination and management

Usage Patterns

1. Repository Structure Analysis and Optimization

javascript

// Initialize architecture analysis swarmmcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 4 }mcp__claude-flow__agent_spawn { type: "analyst", name: "Structure Analyzer" }mcp__claude-flow__agent_spawn { type: "architect", name: "Repository Architect" }mcp__claude-flow__agent_spawn { type: "optimizer", name: "Structure Optimizer" }mcp__claude-flow__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }
// Analyze current repository structureLS("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow")LS("$workspaces$ruv-FANN$ruv-swarm$npm")
// Search for related repositoriesmcp__github__search_repositories {  query: "user:ruvnet claude",  sort: "updated",  order: "desc"}
// Orchestrate structure optimizationmcp__claude-flow__task_orchestrate {  task: "Analyze and optimize repository structure for scalability and maintainability",  strategy: "adaptive",  priority: "medium"}

// Initialize architecture analysis swarmmcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 4 }mcp__claude-flow__agent_spawn { type: "analyst", name: "Structure Analyzer" }mcp__claude-flow__agent_spawn { type: "architect", name: "Repository Architect" }mcp__claude-flow__agent_spawn { type: "optimizer", name: "Structure Optimizer" }mcp__claude-flow__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }
// Analyze current repository structureLS("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow")LS("$workspaces$ruv-FANN$ruv-swarm$npm")
// Search for related repositoriesmcp__github__search_repositories {  query: "user:ruvnet claude",  sort: "updated",  order: "desc"}
// Orchestrate structure optimizationmcp__claude-flow__task_orchestrate {  task: "Analyze and optimize repository structure for scalability and maintainability",  strategy: "adaptive",  priority: "medium"}

2. Multi-Repository Template Creation

javascript

// Create standardized repository templatemcp__github__create_repository {  name: "claude-project-template",  description: "Standardized template for Claude Code projects with ruv-swarm integration",  private: false,  autoInit: true}
// Push template structuremcp__github__push_files {  owner: "ruvnet",  repo: "claude-project-template",  branch: "main",  files: [    {      path: ".claude$commands$github$github-modes.md",      content: "[GitHub modes template]"    },    {      path: ".claude$commands$sparc$sparc-modes.md",       content: "[SPARC modes template]"    },    {      path: ".claude$config.json",      content: JSON.stringify({        version: "1.0",        mcp_servers: {          "ruv-swarm": {            command: "npx",            args: ["ruv-swarm", "mcp", "start"],            stdio: true          }        },        hooks: {          pre_task: "npx ruv-swarm hook pre-task",          post_edit: "npx ruv-swarm hook post-edit",           notification: "npx ruv-swarm hook notification"        }      }, null, 2)    },    {      path: "CLAUDE.md",      content: "[Standardized CLAUDE.md template]"    },    {      path: "package.json",      content: JSON.stringify({        name: "claude-project-template",        version: "1.0.0",        description: "Claude Code project with ruv-swarm integration",        engines: { node: ">=20.0.0" },        dependencies: {          "ruv-swarm": "^1.0.11"        }      }, null, 2)    },    {      path: "README.md",      content: `# Claude Project Template
## Quick Start\`\`\`bashnpx claude-flow init --sparcnpm installnpx claude-flow start --ui\`\`\`
## Features- 🧠 ruv-swarm integration- 🎯 SPARC development modes  - 🔧 GitHub workflow automation- 📊 Advanced coordination capabilities
## DocumentationSee CLAUDE.md for complete integration instructions.`    }  ],  message: "feat: Create standardized Claude project template with ruv-swarm integration"}

// Create standardized repository templatemcp__github__create_repository {  name: "claude-project-template",  description: "Standardized template for Claude Code projects with ruv-swarm integration",  private: false,  autoInit: true}
// Push template structuremcp__github__push_files {  owner: "ruvnet",  repo: "claude-project-template",  branch: "main",  files: [    {      path: ".claude$commands$github$github-modes.md",      content: "[GitHub modes template]"    },    {      path: ".claude$commands$sparc$sparc-modes.md",       content: "[SPARC modes template]"    },    {      path: ".claude$config.json",      content: JSON.stringify({        version: "1.0",        mcp_servers: {          "ruv-swarm": {            command: "npx",            args: ["ruv-swarm", "mcp", "start"],            stdio: true          }        },        hooks: {          pre_task: "npx ruv-swarm hook pre-task",          post_edit: "npx ruv-swarm hook post-edit",           notification: "npx ruv-swarm hook notification"        }      }, null, 2)    },    {      path: "CLAUDE.md",      content: "[Standardized CLAUDE.md template]"    },    {      path: "package.json",      content: JSON.stringify({        name: "claude-project-template",        version: "1.0.0",        description: "Claude Code project with ruv-swarm integration",        engines: { node: ">=20.0.0" },        dependencies: {          "ruv-swarm": "^1.0.11"        }      }, null, 2)    },    {      path: "README.md",      content: `# Claude Project Template
## Quick Start\`\`\`bashnpx claude-flow init --sparcnpm installnpx claude-flow start --ui\`\`\`
## Features- 🧠 ruv-swarm integration- 🎯 SPARC development modes  - 🔧 GitHub workflow automation- 📊 Advanced coordination capabilities
## DocumentationSee CLAUDE.md for complete integration instructions.`    }  ],  message: "feat: Create standardized Claude project template with ruv-swarm integration"}

3. Cross-Repository Synchronization

javascript

// Synchronize structure across related repositoriesconst repositories = [  "claude-code-flow",   "ruv-swarm",  "claude-extensions"]
// Update common files across repositoriesrepositories.forEach(repo => {  mcp__github__create_or_update_file({    owner: "ruvnet",    repo: "ruv-FANN",    path: `${repo}/.github$workflows$integration.yml`,    content: `name: Integration Testson: [push, pull_request]jobs:  test:    runs-on: ubuntu-latest    steps:      - uses: actions$checkout@v3      - uses: actions$setup-node@v3        with: { node-version: '20' }      - run: npm install && npm test`,    message: "ci: Standardize integration workflow across repositories",    branch: "structure$standardization"  })})

// Synchronize structure across related repositoriesconst repositories = [  "claude-code-flow",   "ruv-swarm",  "claude-extensions"]
// Update common files across repositoriesrepositories.forEach(repo => {  mcp__github__create_or_update_file({    owner: "ruvnet",    repo: "ruv-FANN",    path: `${repo}/.github$workflows$integration.yml`,    content: `name: Integration Testson: [push, pull_request]jobs:  test:    runs-on: ubuntu-latest    steps:      - uses: actions$checkout@v3      - uses: actions$setup-node@v3        with: { node-version: '20' }      - run: npm install && npm test`,    message: "ci: Standardize integration workflow across repositories",    branch: "structure$standardization"  })})

Batch Architecture Operations

Complete Repository Architecture Optimization:

javascript

[Single Message - Repository Architecture Review]:  // Initialize comprehensive architecture swarm  mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 6 }  mcp__claude-flow__agent_spawn { type: "architect", name: "Senior Architect" }  mcp__claude-flow__agent_spawn { type: "analyst", name: "Structure Analyst" }  mcp__claude-flow__agent_spawn { type: "optimizer", name: "Performance Optimizer" }  mcp__claude-flow__agent_spawn { type: "researcher", name: "Best Practices Researcher" }  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }    // Analyze current repository structures  LS("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow")  LS("$workspaces$ruv-FANN$ruv-swarm$npm")   Read("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow$package.json")  Read("$workspaces$ruv-FANN$ruv-swarm$npm$package.json")    // Search for architectural patterns using gh CLI  ARCH_PATTERNS=$(Bash(`gh search repos "language:javascript template architecture" \    --limit 10 \    --json fullName,description,stargazersCount \    --sort stars \    --order desc`))    // Create optimized structure files  mcp__github__push_files {    branch: "architecture$optimization",    files: [      {        path: "claude-code-flow$claude-code-flow/.github/ISSUE_TEMPLATE$integration.yml",        content: "[Integration issue template]"      },      {        path: "claude-code-flow$claude-code-flow/.github/PULL_REQUEST_TEMPLATE.md",        content: "[Standardized PR template]"      },      {        path: "claude-code-flow$claude-code-flow$docs/ARCHITECTURE.md",        content: "[Architecture documentation]"      },      {        path: "ruv-swarm$npm/.github$workflows$cross-package-test.yml",        content: "[Cross-package testing workflow]"      }    ],    message: "feat: Optimize repository architecture for scalability and maintainability"  }    // Track architecture improvements  TodoWrite { todos: [    { id: "arch-analysis", content: "Analyze current repository structure", status: "completed", priority: "high" },    { id: "arch-research", content: "Research best practices and patterns", status: "completed", priority: "medium" },    { id: "arch-templates", content: "Create standardized templates", status: "completed", priority: "high" },    { id: "arch-workflows", content: "Implement improved workflows", status: "completed", priority: "medium" },    { id: "arch-docs", content: "Document architecture decisions", status: "pending", priority: "medium" }  ]}    // Store architecture analysis  mcp__claude-flow__memory_usage {    action: "store",    key: "architecture$analysis$results",    value: {      timestamp: Date.now(),      repositories_analyzed: ["claude-code-flow", "ruv-swarm"],      optimization_areas: ["structure", "workflows", "templates", "documentation"],      recommendations: ["standardize_structure", "improve_workflows", "enhance_templates"],      implementation_status: "in_progress"    }  }

[Single Message - Repository Architecture Review]:  // Initialize comprehensive architecture swarm  mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 6 }  mcp__claude-flow__agent_spawn { type: "architect", name: "Senior Architect" }  mcp__claude-flow__agent_spawn { type: "analyst", name: "Structure Analyst" }  mcp__claude-flow__agent_spawn { type: "optimizer", name: "Performance Optimizer" }  mcp__claude-flow__agent_spawn { type: "researcher", name: "Best Practices Researcher" }  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }    // Analyze current repository structures  LS("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow")  LS("$workspaces$ruv-FANN$ruv-swarm$npm")   Read("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow$package.json")  Read("$workspaces$ruv-FANN$ruv-swarm$npm$package.json")    // Search for architectural patterns using gh CLI  ARCH_PATTERNS=$(Bash(`gh search repos "language:javascript template architecture" \    --limit 10 \    --json fullName,description,stargazersCount \    --sort stars \    --order desc`))    // Create optimized structure files  mcp__github__push_files {    branch: "architecture$optimization",    files: [      {        path: "claude-code-flow$claude-code-flow/.github/ISSUE_TEMPLATE$integration.yml",        content: "[Integration issue template]"      },      {        path: "claude-code-flow$claude-code-flow/.github/PULL_REQUEST_TEMPLATE.md",        content: "[Standardized PR template]"      },      {        path: "claude-code-flow$claude-code-flow$docs/ARCHITECTURE.md",        content: "[Architecture documentation]"      },      {        path: "ruv-swarm$npm/.github$workflows$cross-package-test.yml",        content: "[Cross-package testing workflow]"      }    ],    message: "feat: Optimize repository architecture for scalability and maintainability"  }    // Track architecture improvements  TodoWrite { todos: [    { id: "arch-analysis", content: "Analyze current repository structure", status: "completed", priority: "high" },    { id: "arch-research", content: "Research best practices and patterns", status: "completed", priority: "medium" },    { id: "arch-templates", content: "Create standardized templates", status: "completed", priority: "high" },    { id: "arch-workflows", content: "Implement improved workflows", status: "completed", priority: "medium" },    { id: "arch-docs", content: "Document architecture decisions", status: "pending", priority: "medium" }  ]}    // Store architecture analysis  mcp__claude-flow__memory_usage {    action: "store",    key: "architecture$analysis$results",    value: {      timestamp: Date.now(),      repositories_analyzed: ["claude-code-flow", "ruv-swarm"],      optimization_areas: ["structure", "workflows", "templates", "documentation"],      recommendations: ["standardize_structure", "improve_workflows", "enhance_templates"],      implementation_status: "in_progress"    }  }

Architecture Patterns

1. Monorepo Structure Pattern

ruv-FANN/├── packages/│   ├── claude-code-flow/│   │   ├── src/│   │   ├── .claude/│   │   └── package.json│   ├── ruv-swarm/│   │   ├── src/│   │   ├── wasm/│   │   └── package.json│   └── shared/│       ├── types/│       ├── utils/│       └── config/├── tools/│   ├── build/│   ├── test/│   └── deploy/├── docs/│   ├── architecture/│   ├── integration/│   └── examples/└── .github/    ├── workflows/    ├── templates/    └── actions/

ruv-FANN/├── packages/│   ├── claude-code-flow/│   │   ├── src/│   │   ├── .claude/│   │   └── package.json│   ├── ruv-swarm/│   │   ├── src/│   │   ├── wasm/│   │   └── package.json│   └── shared/│       ├── types/│       ├── utils/│       └── config/├── tools/│   ├── build/│   ├── test/│   └── deploy/├── docs/│   ├── architecture/│   ├── integration/│   └── examples/└── .github/    ├── workflows/    ├── templates/    └── actions/

2. Command Structure Pattern

.claude/├── commands/│   ├── github/│   │   ├── github-modes.md│   │   ├── pr-manager.md│   │   ├── issue-tracker.md│   │   └── sync-coordinator.md│   ├── sparc/│   │   ├── sparc-modes.md│   │   ├── coder.md│   │   └── tester.md│   └── swarm/│       ├── coordination.md│       └── orchestration.md├── templates/│   ├── issue.md│   ├── pr.md│   └── project.md└── config.json

.claude/├── commands/│   ├── github/│   │   ├── github-modes.md│   │   ├── pr-manager.md│   │   ├── issue-tracker.md│   │   └── sync-coordinator.md│   ├── sparc/│   │   ├── sparc-modes.md│   │   ├── coder.md│   │   └── tester.md│   └── swarm/│       ├── coordination.md│       └── orchestration.md├── templates/│   ├── issue.md│   ├── pr.md│   └── project.md└── config.json

3. Integration Pattern

javascript

const integrationPattern = {  packages: {    "claude-code-flow": {      role: "orchestration_layer",      dependencies: ["ruv-swarm"],      provides: ["CLI", "workflows", "commands"]    },    "ruv-swarm": {      role: "coordination_engine",       dependencies: [],      provides: ["MCP_tools", "neural_networks", "memory"]    }  },  communication: "MCP_protocol",  coordination: "swarm_based",  state_management: "persistent_memory"}

const integrationPattern = {  packages: {    "claude-code-flow": {      role: "orchestration_layer",      dependencies: ["ruv-swarm"],      provides: ["CLI", "workflows", "commands"]    },    "ruv-swarm": {      role: "coordination_engine",       dependencies: [],      provides: ["MCP_tools", "neural_networks", "memory"]    }  },  communication: "MCP_protocol",  coordination: "swarm_based",  state_management: "persistent_memory"}

Best Practices

1. Structure Optimization

Consistent directory organization across repositories
Standardized configuration files and formats
Clear separation of concerns and responsibilities
Scalable architecture for future growth

2. Template Management

Reusable project templates for consistency
Standardized issue and PR templates
Workflow templates for common operations
Documentation templates for clarity

3. Multi-Repository Coordination

Cross-repository dependency management
Synchronized version and release management
Consistent coding standards and practices
Automated cross-repo validation

4. Documentation Architecture

Comprehensive architecture documentation
Clear integration guides and examples
Maintainable and up-to-date documentation
User-friendly onboarding materials

Monitoring and Analysis

Architecture Health Metrics:

Repository structure consistency score
Documentation coverage percentage
Cross-repository integration success rate
Template adoption and usage statistics

Automated Analysis:

Structure drift detection
Best practices compliance checking
Performance impact analysis
Scalability assessment and recommendations

Integration with Development Workflow

Seamless integration with:

$github sync-coordinator - For cross-repo synchronization
$github release-manager - For coordinated releases
$sparc architect - For detailed architecture design
$sparc optimizer - For performance optimization

Workflow Enhancement:

Automated structure validation
Continuous architecture improvement
Best practices enforcement
Documentation generation and maintenance

Source and attribution

Source:ruvnet/rufloin.agents/skills/agent-repo-architectat commit6051f67

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Agent Repo Architect

GitHub Repository Architect

Purpose

Capabilities

Usage Patterns

1. Repository Structure Analysis and Optimization

2. Multi-Repository Template Creation

3. Cross-Repository Synchronization

Batch Architecture Operations

Complete Repository Architecture Optimization:

Architecture Patterns

1. Monorepo Structure Pattern

2. Command Structure Pattern

3. Integration Pattern

Best Practices

1. Structure Optimization

2. Template Management

3. Multi-Repository Coordination

4. Documentation Architecture

Monitoring and Analysis

Architecture Health Metrics:

Automated Analysis:

Integration with Development Workflow

Seamless integration with:

Workflow Enhancement:

Source and attribution

More from ruvnet/ruflo

Cron Schedule

Autopilot Predict

Autopilot Loop

Worker Integration

Worker Benchmarks

Swarm Advanced

More in DevOps & Cloud

Playwright Devops

M5 Onboard

Yeet

Runbook

Incident Response

Deploy Checklist