/migration-report

name: migration-report
description: Generate a comprehensive migration report summarizing quality scores and providing recommendations. Use after scoring a migration project.
license: MIT
compatibility: Requires migration_score.json and style_score.json files
triggers:
  - migration report
  - migration summary
  - quality report

Generate a comprehensive migration report that summarizes scores and provides actionable insights.

**Prerequisites**: Migration quality scores and style scores must exist (see `migration-score-quality` and `migration-score-style` skills).

Report Structure

1. Executive Summary

• Overall migration health (High/Medium/Low confidence)
• Key statistics: total files, average scores, score distribution
• One-paragraph assessment for stakeholders

2. Score Overview

Coverage Statistics

• Average coverage score
• Files with coverage < 3 (needs attention)
• Files with coverage = 5 (complete)

Correctness Statistics

• Average correctness score
• Files with correctness < 3 (needs attention)
• Files with correctness = 5 (verified)

Style Statistics

• Average style score per attribute
• Common style issues identified

3. Risk Assessment

Categorize files into:

• **Green**: Coverage ≥ 4, Correctness ≥ 4, Style ≥ 4
• **Yellow**: Any score between 3-4
• **Red**: Any score < 3

4. Notable Findings

Strengths

• What was migrated well
• Good patterns to replicate

Weaknesses

• Common issues across files
• Patterns to avoid

5. Recommendations

Prioritized action items: 1. **Critical** — Files with scores < 3 2. **Important** — Files with scores 3-4 3. **Nice to have** — Style improvements for green files

6. Detailed Scores

Include the raw scores for reference (or link to score files).

Output Format

Generate the report as a Markdown file:

# Migration Quality Report

**Generated**: 2024-01-15
**Project**: Customer Management System
**Source**: COBOL (45 files)
**Target**: Java (62 files)

## Executive Summary

Migration is at **MEDIUM confidence** with average coverage of 4.2/5 and 
correctness of 4.0/5. Three files require immediate attention due to 
incomplete business logic migration.

## Score Overview

### Coverage
- Average: 4.2/5
- Complete (5): 28 files (62%)
- Needs attention (<3): 3 files (7%)

...

Tone and Audience

• Write for technical stakeholders (architects, tech leads)
• Be specific about issues (cite file names, line numbers if relevant)
• Provide actionable recommendations, not vague suggestions
• Acknowledge good work, not just problems

Data Sources

Read scores from:

• `migration_score.json` — Coverage and correctness scores
• `style_score.json` — Style evaluation scores
• `migration_mapping.json` — File mapping (for counts)

Example Recommendations

**Good:** > "CALC001.java has coverage 2/5 because batch processing logic in > CALC001.cbl lines 150-200 was not migrated. Implement the > `processBatch()` method to match COBOL paragraph PROCESS-BATCH."

**Bad:** > "Some files need more work."