migration-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%)

...