legacy-modernization-orchestrator

Guide IBM i/AS400 modernization through Legacy Spec Factory workflow stages.

Updated May 12, 2026
One-click install
npx skills add https://github.com/wwa-lab/legacy-spec-factory --skill legacy-modernization-orchestrator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: legacy-modernization-orchestrator
Source: https://github.com/wwa-lab/legacy-spec-factory/tree/main/.opencode/skills/legacy-modernization-orchestrator
Command: npx skills add https://github.com/wwa-lab/legacy-spec-factory --skill legacy-modernization-orchestrator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ibmi_program_analysis, ibmi_inventory, ibmi_flow_analysis, ibmi_module_analysis, ibmi_spec_writing, ibmi_sdlc_handoff, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill acts as an entry-point router for the Legacy Spec Factory reverse chain, guiding users through IBM i / AS400 / RPGLE / CLLE / COBOL modernization with a structured workflow, reducing errors, and improving efficiency.

Core Features & Use Cases

  • Natural-Language Guidance: Offers step-by-step instructions through various modernization stages, from document/evidence intake to SDLC handoff.
  • Program Analysis: Analyzes RPG / CL / COBOL source code and extracts business logic, validation logic, exception handling, and data usage.
  • Legacy BRD Discovery: Generates Business Requirement Documents (BRDs) for migration discovery and post-BRD old-vs-new disposition.
  • Spec Writing & SDLC Handoff: Assists in writing specifications and preparing inputs for target architecture planning, application retirement, and AI-native SDLC handoff.
  • Use Case: When faced with a legacy system, the user can use this Skill to start by understanding the system's architecture, identifying the modules for modernization, and then proceed with detailed analysis and documentation.

Quick Start

Run the legacy-modernization-orchestrator skill and provide the initial artifact or specify the project context to begin the modernization workflow.

Frequently Asked Questions about legacy-modernization-orchestrator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I modernize IBM i AS400 RPGLE applications and extract business logic?

To modernize IBM i AS400 RPGLE applications, this Skill orchestrates a reverse chain workflow that analyzes RPG, CL, and COBOL source code to extract business logic, validation rules, and exception handling before generating migration specifications.

What is the best way to generate Business Requirement Documents for legacy system migration?

Generating Business Requirement Documents for legacy migration requires analyzing existing program modules and data flows. This Skill guides users through BRD discovery and post-BRD old-vs-new disposition to ensure accurate requirement capture for target architecture planning.

How do I start analyzing legacy COBOL and CLLE source code for system retirement?

Analyzing legacy COBOL and CLLE source code starts with document and evidence intake, followed by inventory and program analysis. This Skill routes users through these structured stages to prevent unsafe workflow skips during system retirement planning.

Can I skip program analysis steps when modernizing AS400 applications?

Skipping program analysis steps during AS400 modernization is prevented by this Skill to maintain workflow integrity. It ensures all required stages, including flow and module analysis, are completed before proceeding to spec writing and SDLC handoff.

Does this workflow support AI-native SDLC handoff for IBM i modernization projects?

Yes, AI-native SDLC handoff is supported for IBM i modernization projects. After spec writing and target architecture planning are complete, this Skill prepares the necessary inputs for application retirement and seamless transition to modern development workflows.

What prerequisites are needed before analyzing RPG source code for modernization?

Before analyzing RPG source code for modernization, you need the IBM i program analysis, inventory, flow, and module analysis dependencies installed. This Skill requires these components to properly execute the Legacy Spec Factory reverse chain.