modernize-assess

What problem does it solve?

This capability enables teams to perform a structured modernization assessment of a legacy system, delivering a fact-based executive brief that covers inventory, complexity, technical debt, and effort estimates.

Core Features & Use Cases

• Mode selection: Portfolio mode (--portfolio <parent-dir>) to analyze multiple subsystems and produce a prioritized heat-map; or Single-system mode to assess a specific legacy directory.
• Portfolio analysis: For each subsystem, compute LOC and complexity, assess dependency freshness, and generate an overall modernization plan.
• Single-system assessment: Conducts a comprehensive deep-dive into one legacy system, including architecture fingerprinting, debt identification, and remediation recommendations.
• Documentation & governance: Capture orchestration steps, deliver an executive summary, and prepare an architecture reference suitable for stakeholders.

Quick Start

Point the tool at a legacy directory and run with --portfolio <parent-dir> for a portfolio assessment, or run on legacy/$1 for a single-system assessment.