# Migration Plan

Runs the migration-plan agent role from the ruflo multi-agent toolkit.

- Repository: https://github.com/ruvnet/ruflo (80531 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ruvnet/ruflo --skill agent-migration-plan -g -a claude-code -y`
Codex: `npx skills add ruvnet/ruflo --skill agent-migration-plan -g -a codex -y`
Cursor: `npx skills add ruvnet/ruflo --skill agent-migration-plan -g -a cursor -y`
Gemini CLI: `npx skills add ruvnet/ruflo --skill agent-migration-plan -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ruvnet/ruflo`

## Description

Agent skill for migration-plan - invoke with $agent-migration-plan

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

---
name: migration-planner
type: planning
color: red
description: Comprehensive migration plan for converting commands to agent-based system
capabilities:
  - migration-planning
  - system-transformation
  - agent-mapping
  - compatibility-analysis
  - rollout-coordination
priority: medium
hooks:
  pre: |
    echo "📋 Agent System Migration Planner activated"
    echo "🔄 Analyzing current command structure for migration"
    # Check existing command structure
    if [ -d ".claude$commands" ]; then
      echo "📁 Found existing command directory - will map to agents"
      find .claude$commands -name "*.md" | wc -l | xargs echo "Commands to migrate:"
    fi
  post: |
    echo "✅ Migration planning completed"
    echo "📊 Agent mapping strategy defined"
    echo "🚀 Ready for systematic agent system rollout"
---

# Claude Flow Commands to Agent System Migration Plan

## Overview
This document provides a comprehensive migration plan to convert existing .claude$commands to the new agent-based system. Each command is mapped to an equivalent agent with defined roles, responsibilities, capabilities, and tool access restrictions.

## Agent Definition Format
Each agent uses YAML frontmatter with the following structure:
```yaml
---
role: agent-type
name: Agent Display Name
responsibilities:
  - Primary responsibility
  - Secondary responsibility
capabilities:
  - capability-1
  - capability-2
tools:
  allowed:
    - tool-name
  restricted:
    - restricted-tool
triggers:
  - pattern: "regex pattern"
    priority: high|medium|low
  - keyword: "activation keyword"
---
```

## Migration Categories

### 1. Coordination Agents

The rest: https://github.com/ruvnet/ruflo/blob/HEAD/.agents/skills/agent-migration-plan/SKILL.md