mainframe-architect

Translate mainframe constructs into cloud-native architectures and produce a migration blueprint.

1|1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/duboc/mainframe-skills-mig --skill mainframe-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mainframe-architect
Source: https://github.com/duboc/mainframe-skills-mig/tree/main/skills/03-mainframe-architect
Command: npx skills add https://github.com/duboc/mainframe-skills-mig --skill mainframe-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mainframe applications rely on legacy paradigms (VSAM, IMS, CICS, JCL) that do not map directly to cloud platforms, creating high friction and risk when planning migration. This Skill consolidates inventory and profiling outputs to produce a concrete, actionable target architecture that downstream translation, data migration, and cutover phases can implement.

Core Features & Use Cases

  • Microservice Boundary Definition: Translate call-graph communities and workload profiles into candidate microservices and migration priorities.
  • Database Migration Mapping: Map VSAM types and IMS hierarchies to relational schemas and object stores with recommended tools and table naming conventions.
  • CICS → REST & Batch → Event Design: Generate OpenAPI-compatible endpoint definitions and cloud-native workflow DAGs (including Airflow DAG skeletons for GCP).
  • Architectural Governance: Produce ADRs, an architecture overview, and an output checklist to validate blockers before marking Phase 03 complete.

Quick Start

Run phase 03 by asking the assistant to analyze Phase 01 and Phase 02 outputs and generate microservice boundaries, database migration maps, REST API designs, batch workflow definitions, and ADRs into docs/03_architecture/.

Frequently Asked Questions about mainframe-architect

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

FAQPage Schema
How do I map VSAM files to PostgreSQL during a mainframe migration?

Mapping VSAM files to PostgreSQL involves translating VSAM types and IMS hierarchies into relational schemas and object stores, generating a database migration map with recommended tools and table naming conventions for downstream phases.

How do I convert CICS transactions to REST APIs for cloud-native architectures?

Converting CICS transactions to REST APIs requires generating OpenAPI-compatible endpoint definitions that replace legacy CICS paradigms, forming a core part of the target architecture design and migration blueprint for downstream implementation.

Do I need program inventories and call graphs to define microservice boundaries from mainframe applications?

Yes, defining microservice boundaries requires Phase 02 profiling outputs, program inventories, and call graphs as inputs to translate workload profiles and call-graph communities into candidate microservices and migration priorities.

What is the best way to redesign mainframe batch jobs for cloud-native event workflows?

Redesigning mainframe batch jobs for cloud-native workflows involves translating JCL batch processes into cloud-native workflow DAGs, including generating Airflow DAG skeletons for GCP to define event-driven workflow definitions.

How do I validate mainframe migration blockers before completing target architecture design?

Validating mainframe migration blockers requires producing Architectural Decision Records (ADRs), an architecture overview, and an output checklist to validate governance and ensure all architectural blockers are resolved before marking Phase 03 complete.