agent-repo-architect

Optimizes repository structure and coordinates multi-repo management using ruv-swarm and GitHub APIs.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill agent-repo-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-repo-architect
Source: https://github.com/ruvnet/claude-flow/tree/main/.agents/skills/agent-repo-architect
Command: npx skills add https://github.com/ruvnet/claude-flow --skill agent-repo-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ruv-swarm.

What problem does it solve?

Managing consistent structure, templates, and workflows across multiple GitHub repositories is manual and error-prone. This Skill automates repository architecture analysis, template creation, and cross-repo synchronization using swarm-based agent coordination.

Core Features & Use Cases

  • Repository Structure Analysis: Spawns analyst and architect agents via ruv-swarm to inspect directory layouts and recommend structural improvements.
  • Template Management: Creates standardized project templates (CLAUDE.md, config.json, workflows, issue/PR templates) and pushes them to GitHub repositories.
  • Cross-Repository Synchronization: Updates common files like CI workflows across multiple repositories in a single coordinated operation.
  • Use Case: A maintainer of several related packages (e.g., claude-code-flow and ruv-swarm) uses this Skill to standardize GitHub workflows, PR templates, and architecture documentation across all repos in one batch operation.

Quick Start

Ask the agent to analyze the structure of my repositories and generate standardized templates and workflow improvements across them.

Frequently Asked Questions about agent-repo-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize structure across multiple GitHub repositories?

Initialize a swarm with architect and coordinator agents, then use GitHub file push operations to update common files like workflows and templates across all target repositories in one batch. The Skill demonstrates this with create_or_update_file calls per repository.

How to create a reusable GitHub project template with automation?

Use the GitHub create_repository tool to scaffold a template repo, then push standardized files such as CLAUDE.md, config.json, package.json, and workflow definitions. The Skill includes a complete example pushing a Claude project template with ruv-swarm integration.

Does this Skill require ruv-swarm to be installed?

Yes, the coordination features depend on ruv-swarm MCP tools such as swarm_init, agent_spawn, and task_orchestrate. The hooks also invoke npx ruv-swarm commands for pre-task and post-task lifecycle events.

Can it synchronize CI workflows across repositories?

Yes, it iterates over a list of repositories and pushes standardized workflow files like integration.yml to each one using the GitHub API. Each update is committed with a consistent branch and commit message.

What are the limitations of swarm-based repo architecture analysis?

Analysis quality depends on the spawned agents and available repository access via the GitHub MCP tools. It does not perform deep code-level refactoring; it focuses on structure, templates, workflows, and documentation.