legacy-modernizer

Legacy Modernizer

Purpose

Provides expertise in incrementally modernizing legacy systems without full rewrites. Specializes in migration patterns like Strangler Fig, Change Data Capture (CDC), and Anti-Corruption Layers to safely evolve systems while maintaining business continuity.

When to Use

• Planning migration from monolith to microservices
• Implementing Strangler Fig pattern
• Designing Anti-Corruption Layers between old and new systems
• Setting up Change Data Capture for data synchronization
• Modernizing legacy databases incrementally
• Replacing legacy APIs while maintaining compatibility
• Assessing legacy codebase for modernization priority
• Managing dual-write scenarios during transitions

Quick Start

Invoke this skill when:

• Migrating legacy monoliths to modern architectures
• Implementing Strangler Fig or Branch by Abstraction
• Designing Anti-Corruption Layers
• Setting up CDC for data sync between systems
• Planning incremental modernization roadmaps

Do NOT invoke when:

• Greenfield microservices design → use /microservices-architect
• General refactoring without migration → use /refactoring-specialist
• Database optimization without migration → use /database-optimizer
• API design without legacy concerns → use /api-designer

Decision Framework

Migration Strategy?
├── Replace Incrementally
│   └── Strangler Fig: Route traffic to new service gradually
├── Abstract and Replace
│   └── Branch by Abstraction: Interface → implement new → switch
├── Data Sync Required
│   └── CDC with Debezium/similar for real-time sync
└── Protect New from Old
    └── Anti-Corruption Layer: Translate between domains

Core Workflows

1. Strangler Fig Implementation

1. Identify bounded context to extract
2. Create facade/proxy in front of legacy system
3. Build new service implementing same interface
4. Route subset of traffic to new service
5. Gradually increase traffic percentage
6. Retire legacy component when fully migrated

2. Anti-Corruption Layer Setup

1. Define clean domain model for new system
2. Identify integration points with legacy
3. Build translator layer between models
4. Implement adapters for legacy APIs/data
5. Add monitoring for translation failures
6. Document mapping rules

3. CDC Data Migration

1. Set up CDC tool (Debezium, AWS DMS)
2. Configure change capture on legacy database
3. Build consumer to apply changes to new system
4. Handle schema differences with transformations
5. Implement validation and reconciliation
6. Plan cutover and fallback strategy

Best Practices

• Migrate incrementally—avoid big-bang rewrites
• Maintain feature parity during transition
• Use feature flags to control traffic routing
• Implement comprehensive monitoring during migration
• Keep legacy and new systems in sync until cutover
• Document all integration points and dependencies

Anti-Patterns

Anti-Pattern	Problem	Correct Approach
Big-bang rewrite	High risk, long timeline	Incremental migration
No Anti-Corruption Layer	New system polluted by legacy	Isolate with ACL
Dual-write without CDC	Data inconsistency	Use CDC for sync
Migrating everything at once	Overwhelming complexity	Prioritize by business value
No rollback plan	Stuck if migration fails	Always plan fallback