Skip to main content

Modernization Module Overview

Welcome to the Modernization Module! This module within AI Cockpit is designed to streamline the process of analyzing, documenting, and planning the modernization of existing codebases. Whether you're working with legacy systems, mainframe applications, or undocumented code, this module provides the tools needed to understand and transform your software assets.

This section of the documentation will guide you through the module's features and how to use them effectively in your modernization projects.

Module Capabilities​

The Modernization Module provides several key capabilities to support your modernization efforts:

Documentation Generation​

Automatically generate technical documentation from source code analysis. The module examines code structure, dependencies, and logic patterns to produce structured documentation in multiple formats including Markdown and HTML.

Legacy System Support​

The module includes specialized support for analyzing legacy and mainframe technologies, including:

  • COBOL
  • JCL
  • CICS
  • Natural
  • Visual Age
  • Clipeer
  • PLSQL
  • IBM ACE
  • Java
  • GoLang
  • C#
  • Ruby
  • Other languages and frameworks

This support enables effective analysis of systems built on these platforms.

Diagram Generation​

Generate visual representations of system architecture and code structure, including:

  • Flowcharts
  • Sequence diagrams
  • Component architecture diagrams
  • Data models
  • Dependency maps

Diagrams are generated in Mermaid format for easy integration into documentation systems.

Business Rules Extraction​

The module analyzes code to identify and extract embedded business rules, including:

  • Validation logic
  • Calculation procedures
  • Decision processes
  • Workflow patterns

These extracted rules are documented in a structured format for review and planning.

Agile Artifact Generation​

Transform code analysis into agile planning artifacts:

  • Epics: High-level feature groupings organized by business domain
  • User Stories: Detailed requirements with acceptance criteria
  • Business Rules: Formal documentation of identified business logic

Interactive Documentation Portal​

Access generated documentation through a web-based portal that provides:

  • Semantic search capabilities
  • Module and component navigation
  • Interactive diagram viewing
  • Version history tracking
  • Export functionality in multiple formats

Code Indexing​

The module creates a semantic index of the codebase that enables:

  • Concept-based search beyond syntax matching
  • Identification of similar functionality across the codebase
  • Impact analysis for proposed changes
  • Traceability between code and requirements
  • Dependency analysis

Typical Workflow​

A typical modernization project using this module follows these steps:

  1. Code Upload: Upload the source code to be analyzed
  2. Analysis: The system processes the code to identify patterns, rules, and structure
  3. Documentation: Review generated documentation and diagrams
  4. Planning: Use generated artifacts to plan modernization work
  5. Execution: Implement modernization based on the analysis and planning

Common Use Cases​

The Modernization Module is commonly used for:

  • Analyzing mainframe systems before cloud migration
  • Creating documentation for undocumented legacy systems
  • Planning the decomposition of monolithic applications
  • Facilitating knowledge transfer and team onboarding
  • Conducting impact analysis before system changes
  • Supporting compliance and audit requirements

Access and Permissions​

  • Module Name: Modernization
  • Access Control: Access to this module requires Architect-level permissions. To request access, contact your project manager.

Next Steps​

The following pages in this section provide detailed information about:

  • Creating and managing modernization projects
  • Uploading code for analysis
  • Configuring analysis tasks
  • Accessing and working with generated artifacts
  • Integrating modernization outputs into your development workflow

Continue to the next page to learn how to create your first modernization project.