Afrexai Legacy Modernization

# Legacy System Modernization Engine

Complete methodology for assessing, planning, and executing legacy system modernization — from monolith decomposition to cloud migration. Works for any tech stack, any scale.

---

## Phase 1: System Assessment

### Modernization Brief

```yaml
system_name: "[Name]"
age_years: 0
primary_language: ""
framework: ""
database: ""
deployment: "on-prem | VM | container | serverless"
lines_of_code: 0
team_size: 0
monthly_users: 0
annual_revenue_supported: "$0"
compliance_requirements: []
known_pain_points: []
business_driver: "cost | speed | talent | risk | compliance | scale"
timeline_pressure: "low | medium | high | critical"
budget_range: "$0-$0"
sponsor: ""
```

### Technical Debt Inventory

Score each dimension 1-5 (1=critical, 5=healthy):

| Dimension | Score | Evidence |
|-----------|-------|----------|
| **Code quality** — test coverage, complexity, duplication | | |
| **Architecture** — coupling, modularity, clear boundaries | | |
| **Infrastructure** — deployment automation, monitoring, scaling | | |
| **Dependencies** — outdated libraries, EOL frameworks, security vulns | | |
| **Data** — schema quality, migration history, backup/recovery | | |
| **Documentation** — accuracy, coverage, onboarding effectiveness | | |
| **Operations** — deployment frequency, MTTR, incident rate | | |
| **Security** — auth patterns, encryption, audit trail, compliance gaps | | |
| **Developer experience** — build time, local setup, debugging tools | | |
| **Business logic clarity** — documented rules, test coverage of logic | | |

**Total: /50**

- **40-50**: Healthy — incremental improvement
- **30-39**: Aging — targeted modernization
- **20-29**: Legacy — systematic modernization needed
- **10-19**: Critical — modernize or replace

### Dependency Risk Matrix

For each major dependency:

```yaml
dependency: ""
current_version: ""
latest_version: ""
eol_date: ""  # End of life
security_vulns: 0  # Known CVEs
upgrade_difficulty: "trivial | moder...

# Legacy System Modernization Engine

Complete methodology for assessing, planning, and executing legacy system modernization — monolith decomposition, cloud migration, strangler fig patterns, database modernization, and more. Any tech stack, any scale.

## Install

```bash
clawhub install afrexai-legacy-modernization
```

## What You Get

- **Technical Debt Inventory** — 10-dimension scoring system with evidence tracking
- **Strategy Decision Matrix** — 8 strategies with selection decision tree
- **Strangler Fig Pattern** — step-by-step with facade YAML and sequencing rules
- **Monolith Decomposition** — domain discovery, bounded context mapping, extraction priority matrix
- **Database Modernization** — migration strategies, schema evolution rules, data quality gates
- **Cloud Migration** — readiness assessment, checklist, cost optimization from Day 1
- **API Modernization** — wrapping patterns, contract-first migration
- **Testing Strategy** — parity testing framework, performance regression rules
- **Language/Framework Playbooks** — Java, Python, jQuery→React, COBOL/mainframe
- **Risk Management** — top 10 pre-built risks, kill criteria
- **100-Point Quality Rubric** across 8 weighted dimensions

## Quick Start

Tell your agent: *"Assess this system for modernization"* — it'll run the full Technical Debt Inventory and recommend a strategy.

## Example

```
"We have a 15-year-old Java 8 monolith on-prem. 500K LOC, 12 developers. 
We need to get to cloud. What's the plan?"

→ Technical Debt Inventory → Strategy: Strangler Fig + Replatform
→ Domain discovery → Bounded contexts → Extraction sequence
→ Cloud readiness check → Migration phases → Testing plan
```

## ⚡ Level Up

For industry-specific modernization context (compliance requirements, integration patterns, vendor landscapes):

- **[SaaS Context Pack](https://afrexai-cto.github.io/context-packs/)** — $47
- **[Fintech Context Pack](https://afrexai-cto.github.io/context-packs/)** — $47
- **[Healthcare Context...