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."