ecosystem-migration

name	ecosystem-migration
description	Migrate existing repositories to use GitHub Ecosystem templates and patterns. USE THIS SKILL when user says "migrate to ecosystem", "adopt templates", "convert workflow", "upgrade CI", or wants to transition existing projects.
allowed-tools	["Bash","Read","Write","Edit","Glob","Grep"]

Ecosystem Migration Skill

Migrate existing repositories to the GitHub Ecosystem.

Trigger Phrases

• "migrate this repo to the ecosystem"
• "adopt the python template"
• "convert to reusable workflows"
• "upgrade my CI to ecosystem standards"
• "add ecosystem AI integration"

Migration Assessment

# Detect project type
[ -f "pyproject.toml" ] && echo "Python"
[ -f "package.json" ] && echo "Node.js"
[ -f "go.mod" ] && echo "Go"
[ -f "Cargo.toml" ] && echo "Rust"
[ -f "build.gradle.kts" ] && echo "Java"

# Check existing config
ls -la .github/workflows/ 2>/dev/null
[ -f "CLAUDE.md" ] && echo "Has CLAUDE.md"
[ -f ".github/copilot-instructions.md" ] && echo "Has Copilot"

Migration Strategies

Strategy 1: Full Template Adoption

Best for: New-ish projects with minimal customization

# 1. Backup existing config
mkdir -p .migration-backup
cp -r .github .migration-backup/

# 2. Copy template files
cp -r ~/ecosystem/templates/python-template/.github ./
cp ~/ecosystem/templates/python-template/CLAUDE.md ./
mkdir -p .vscode
cp ~/ecosystem/templates/python-template/.vscode/mcp.json .vscode/

# 3. Merge configurations (manual review)

Strategy 2: Workflow-Only Migration

Best for: Established projects wanting CI standardization

# Replace existing CI with reusable workflow
name: CI
on: [push, pull_request]

jobs:
  ci:
    uses: epicpast/.github/.github/workflows/reusable-ci-python.yml@main
    with:
      python-version: '3.12'
    secrets: inherit

Strategy 3: Incremental Adoption

Best for: Large projects requiring careful migration

Phase 1: AI Integration

• Add CLAUDE.md
• Add copilot-instructions.md
• Add mcp.json

Phase 2: Standardize Tooling

• Update linter/formatter configs

Phase 3: Migrate Workflows

• Add reusable workflow alongside existing
• Test and validate
• Remove old workflow

Phase 4: Security Baseline

• Add pre-commit hooks
• Configure gitleaks
• Enable Dependabot

Adding AI Integration

# Create CLAUDE.md
cat > CLAUDE.md << 'EOF'
# CLAUDE.md

## Project Overview
[Describe project]

## Build Commands
```bash
[relevant commands]

Code Style

[Document standards] EOF

Create copilot-instructions.md

mkdir -p .github cat > .github/copilot-instructions.md << 'EOF'

GitHub Copilot Instructions

Project Context

[Describe for Copilot]

Code Guidelines

[Language patterns] EOF

## Converting to Reusable Workflows

**Before:**
```yaml
name: CI
on: [push]
jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: pip install ruff && ruff check .

After:

name: CI
on: [push]
jobs:
  ci:
    uses: epicpast/.github/.github/workflows/reusable-ci-python.yml@main

Validation After Migration

# Check required files
for f in CLAUDE.md .github/copilot-instructions.md; do
  [ -f "$f" ] && echo "OK $f" || echo "MISSING $f"
done

# Test CI (if possible)
# Run linting, tests locally

Rollback Procedure

# Quick rollback
cp -r .migration-backup/.github ./
rm CLAUDE.md .github/copilot-instructions.md

# Or selective
git checkout HEAD~1 -- .github/workflows/

Migration Checklist

Pre-Migration

• Document current CI behavior
• Create backup branch
• Identify custom configs to preserve

During Migration

• Copy/adapt template files
• Merge configs (don't overwrite)
• Update project-specific values

Post-Migration

• CI passes
• Existing features work
• AI integration functional
• Team approval