IT Modernization Architecture: Planning Legacy System Transformation with Sparx EA
Modernization programs rarely fail on the technology. They fail because nobody mapped the current state first. A modernization program needs a complete current-state application landscape, a dependency map that shows what breaks when something is retired, a risk profile that quantifies legacy debt, and a target architecture and sequenced roadmap that hold up in execution.
The old way to build that foundation was a long manual exercise: spreadsheets from application owners, cost and support dates typed into the repository, dependency diagrams drawn by hand, and a picture that was out of date by the time the program started. The modern way is different. The architect decides what the model must contain to support the modernization decisions. AI connects to the PPM, ITSM, eGRC and ITFM systems that already hold project, configuration, risk and cost data, and brings it in. The architecture model in Sparx EA stitches that data together and shows the relationships, and dashboards in Prolaborate or Power BI give sponsors a current view. It takes less effort, it is easier to maintain through a multi-year program, and it stays current.
IT modernization is one of the highest-stakes enterprise architecture efforts in the public and private sectors. Programs run over budget and schedule for a predictable set of reasons: unknown system dependencies, an undocumented current state, integration complexity that was never estimated, and the supposed quick win that turns out to be entangled with many other systems. This piece walks through each part of the work, how it is done today and AI-augmented, and what it asks of the architect.
The legacy estate, and why modernization is hard
Mature enterprises, such as government departments, banks, health systems, manufacturers and insurers, carry decades of accumulated IT investment. A few characteristics show up again and again, and each raises the cost of getting modernization wrong.
- Monolithic applications. Large, tightly coupled systems that bundle business logic, data access and presentation into one deployable unit. Changing one part means testing the whole. Think COBOL mainframe applications running core banking or benefits administration, Oracle Forms estates, or an SAP ECC install customized over many years.
- Unsupported platforms. Software on platforms past end of support, such as Windows Server 2003, unpatched database versions, or middleware from vendors that have ceased trading. These carry unmitigated security exposure and cannot run in PCI-DSS or FedRAMP-compliant environments.
- Proprietary data stores. Custom formats, flat-file systems or obsolete products (dBase, FoxPro, CA-IDMS) that modern tools cannot read without bespoke adapters.
- Undocumented integrations. Point-to-point links built by developers who have left, connecting systems that look unrelated but share critical data flows. These are the dependencies that cause failures when a system is switched off.
- Vendor lock-in. Stacks controlled by a single vendor, creating lock-in at the licensing, support and skills levels at once.
The first risk in modernization is informational. Teams cannot inventory the estate accurately, enumerate the dependencies or scope the migration, because the current state is not written down in one place.
Building the current-state application landscape
The first deliverable of any modernization program is an accurate current-state landscape, built in Sparx EA at the application layer using ArchiMate.
Today an architect assembles the inventory from spreadsheets and interviews and types attributes such as cost, support dates and hosting into tagged values, where they begin to go stale. Working AI-augmented, the architect states what each Application Component must carry and which system owns each value, and AI brings it in from those systems and links it to the right elements:
Application NameandVendor, from the ITSM configuration dataVersionandEnd of Vendor Support Date, from ITSM and vendor support dataHosting Model: On-Premises, Colocation, IaaS, SaaS or PaaSPrimary Language/Platform: COBOL on IBM z/OS, C++ on Solaris, .NET Framework 4.5, Java 8, and so onAnnual Cost, licensing, infrastructure and support, from the ITFM systemBusiness Criticalityand risk ratings, from the eGRC systemModernization Status: Current, Legacy, End of Life, In Migration or DecommissionedTarget Disposition: Retire, Replace, Re-platform, Re-architect or Retain
The last two are decisions, and they belong to the architects and the program, recorded in the model. Application Interfaces capture integration endpoints: REST APIs, SOAP web services, message queues, file-based interfaces (FTP, SFTP, AS2), database-level integrations and legacy middleware. Data Flow relationships connect those interfaces, labeled with what is exchanged and over which technology. AI can propose these from middleware configuration and interface documentation. They expose the hidden dependency web: the application that looks isolated on the org chart turns out to be wired into several others. The skill is deciding what the landscape must contain and checking what AI found against what application owners know.
Dependency mapping: the core risk-management activity
The most valuable product of the current-state work is the dependency map. ArchiMate Serving relationships (Component B serves Component A) and Access relationships (Component A reads or writes Data Object B) build the dependency graph.
Today an architect traces it by hand for each question. Working AI-augmented, the architect asks and AI traverses the model and returns the answer with the paths it followed:
- “If we decommission the mainframe policy administration system, what else breaks?” Trace the relationships from that component to every dependent one.
- “Which systems read directly from the legacy Oracle database?” Trace Access relationships from that Data Object.
- “What is the blast radius if the Windows Server 2003 application goes offline?” Trace data flows to every downstream consumer.
Visualized as an application-layer diagram, the graph makes the impact of a target decommission visible before the decision is made. A tagged value on each dependency records its type: Hard (the consumer cannot function without it), Soft (it degrades but survives) or Temporal (time-based, such as a nightly batch). Hard dependencies must be resolved before decommissioning, and soft ones can be managed with fallback procedures. Classifying them is a judgment for the architect and the application owners, because AI can only see the relationships that exist in the model.
Risk profiling: quantifying legacy debt
Because the risk data is structured and current, it can be profiled. A risk heat map built from the model plots:
- X-axis: time to end of support
- Y-axis: business criticality
- Bubble size: annual cost (total cost of ownership)
- Bubble color: modernization status (red for End of Life, amber for Legacy, green for Current)
Systems with high criticality, imminent end of support and high cost are the highest-priority candidates. That view replaces a vague case for modernization with a defensible one: “these [n] systems run critical business functions, lose vendor support within [n] months and cost $[n]M a year to operate, which is why they go first.” With cost and support dates drawn from the source systems, the view stays accurate as the program moves.
Target architecture: modern patterns in Sparx EA
With the current state documented, the target architecture defines what the modernized estate will look like. Sparx EA holds the target separately, as a parallel package or a scenario, so as-is and target can be compared side by side.
Cloud-first reference architecture. The target usually adopts cloud-native patterns, modeled as reference-architecture building blocks: an API Gateway (Application Component), a container runtime such as Kubernetes (Technology Node), an event bus (Application Component), managed database services (Technology Node), an identity provider (Application Component) and a CI/CD pipeline (Technology Node). These become the approved building blocks for new design, so architects choose from the library instead of starting fresh each time.
Strangler Fig pattern. For large monoliths that cannot be rewritten in one program, the Strangler Fig is the usual architecture pattern: new functionality is built as modern services that gradually replace the monolith’s capabilities while it keeps running. In Sparx EA it is modeled as a transition architecture: the monolith stays as an Application Component, new services are added alongside it, and an API Gateway routes each request to the right service by business capability. Work Packages capture each capability extraction and the order in which functionality moves off the monolith.
Big bang or incremental. The choice between all-at-once replacement and incremental migration is recorded as an architecture decision record with its rationale and constraints. Most programs favor incremental, because big bang carries the highest execution risk. For a simple, low-criticality system, a clean replacement is often the pragmatic call.
AI can build the target views, transition states and navigation diagrams once the architect has stated the target. Choosing the patterns and the dispositions is the architect’s work.
The migration roadmap
The roadmap lives in the Implementation and Migration layer as Work Packages arranged into waves. Dependency relationships between them make the sequencing logic explicit and auditable. A typical structure has four phases.
Foundation
Establish the cloud landing zone, modernize identity and access management, and stand up the CI/CD pipeline and DevSecOps toolchain. Nothing migrates yet. This phase builds the platform everything else lands on.
Quick wins
Retire or re-platform low-criticality end-of-support systems to SaaS or cloud IaaS, and move the first candidate service off the primary monolith. Early, low-risk wins build credibility and momentum.
Core modernization
Run Strangler Fig extraction for the core capabilities, migrate the legacy database to a managed service, and replace point-to-point integration with API and event-driven patterns. This is where the heavy lifting happens.
Completion
Decommission the monolith once every capability is extracted, retire the remaining legacy systems, and remediate residual technical debt. The target architecture becomes the new as-is.
Each Work Package links to the Application Components being deployed or retired, the integrations being replaced, the business processes being enabled and the risks being resolved, so the roadmap stays traceable to the reasons each item exists. When the PPM system holds the project schedule, AI can bring status into the model so the roadmap reflects delivery as it happens.
Executive visibility without opening the tool
Most executive sponsors will never open Sparx EA, and they should not have to. Because status, dependency type, cost and criticality are structured data in the model, they can be shown on dashboards sponsors and steering committees use. We can help you build a reporting database on top of your Sparx EA repository and a Power BI model over it, or use the Kernaro Connector for Power BI if you have Kernaro AI Hub, or publish dashboards in Prolaborate. The dashboards that matter on a modernization program are usually these:
- Modernization heat map: the portfolio colored by status (Current, Legacy, End of Life, In Migration, Decommissioned).
- Cost-savings tracker: actual decommissions against plan, with realized savings from the ITFM data.
- Dependency resolution: how many hard dependencies remain for each target decommission.
- Phase completion: Work Package progress by phase and wave.
The architecture model is the single source the reporting draws from. When the question of what is blocking the mainframe decommission resolves to a specific set of incomplete dependency Work Packages, instead of a slide someone updated by hand last month, the program runs on evidence. Designing which dashboards each sponsor sees, and what question each one answers, is the architect’s job. See reporting and Power BI for the options, and application portfolio management for the standing portfolio view that outlasts the program.
FAQ
How do we handle applications with no documentation for the current-state assessment?
Undocumented applications are common in legacy estates. Sources include infrastructure discovery data in the ITSM system, cloud migration assessment tools, the configuration of integration middleware, application-team interviews and network traffic analysis. AI can read these sources and add what it finds to the model as discovery progresses, and architects check it. Partial information in the model is better than none.
What is the right level of detail for the current-state landscape?
Enough to support the key decisions: which systems to retire first, which dependencies must be resolved before decommissioning, and which systems are safe to isolate. That means every application as an Application Component, every significant integration as a Data Flow, and every end-of-support platform clearly identified. Individual API endpoints and data fields belong in integration design specifications.
How does Sparx EA handle applications hosted by MSPs or SaaS vendors?
Third-party hosted applications are modeled as Application Components with a Hosting Model value of MSP or SaaS. Integration dependencies are modeled exactly as for any other system, because external hosting does not change the relationships. For SaaS the disposition is usually Retain, unless the vendor itself is at risk of failure or capability decline.
How do we manage the transition architecture as the program runs?
Transition architectures, the intermediate states between as-is and target, are held as dated baselines. One is captured before each major phase. As Work Packages complete, the live model moves on, and comparing it to a prior baseline shows what changed, which helps stakeholder communication and program assurance. AI can produce the comparison summary; architects confirm what it means.
What is the typical timeline for building a current-state landscape?
It depends on the size of the estate, the quality of existing data, how available application owners are, and access to the systems that hold the data. Working AI-augmented shifts the effort: AI collects and builds from the source systems, and the time goes to deciding what the model must contain and checking what AI built.
How does technical debt quantification work in Sparx EA?
Technical debt is captured as a Technical Debt Score (1 to 5, assessed by the architecture team), a Technical Debt Description, and an Estimated Remediation Cost where one exists. Combined with cost from the ITFM system and risk from the eGRC system, these feed a technical-debt dashboard in Prolaborate or Power BI that shows debt across the portfolio and the investment needed to address it, the core of the modernization business case.
Where this fits
IT modernization needs architecture as well as project management. Most programs start with the current-state landscape and risk profile, the evidence-based starting point our Paralysis to a Plan engagement produces, before committing to transformation decisions. The target architecture, migration roadmap and reporting follow. For multi-year programs, the same model keeps serving the organization once the program ends, as long as someone keeps it current.
Map the estate before you move it.
We can teach your architects to build and run the modernization model AI-augmented on your own repository, and mentor them until it sticks. Or we can build the current-state landscape, dependency map and dashboards for you and hand them over.
Book a callKeep reading
You might also be interested in
Cloud Migration Architecture in Sparx EA
Planning and documenting your move to the cloud, the architecture half of a migration program.
Read InsightApplication Portfolio Management in Sparx EA
The standing portfolio view that outlasts the program, kept current from the source systems.
Read DisciplineApplication Portfolio Management
How we turn the application estate into a governed, queryable asset architects and leaders trust.
Explore For leadersParalysis to a Plan
Turn an undocumented estate into a scored, fundable starting point.
See how