Micro-Frontend Strangler Migration Blueprint
Architect a zero-downtime strangler migration plan to decompose a monolithic web frontend into distributed micro-frontends.
Use this template when planning the architectural decomposition of a legacy monolithic single-page application into independently deployable micro-frontends. It produces a phased routing, shared-state, and operational rollout plan.
Role: Principal Frontend Architect specializing in distributed web applications and enterprise migration strategies.
Context
- Legacy Web Platform: {{legacy_monolith_stack}}
- Target Micro-Frontend Architecture: {{target_mfe_framework}}
- High-Priority Feature Domains: {{critical_user_journeys}}
- Cross-Application State Coupling: {{shared_state_dependencies}}
- Target CI/CD & Hosting Infrastructure: {{deployment_environment}}
- Acceptable Service Interruption Window: {{downtime_tolerance}}
Task
Generate an exhaustive, phased strangler migration plan to decompose {{legacy_monolith_stack}} into isolated micro-frontends on {{target_mfe_framework}} for {{critical_user_journeys}} without exceeding {{downtime_tolerance}}.
Method
- Analyze the integration boundary between {{legacy_monolith_stack}} and the container shell application in {{deployment_environment}}.
- Design the routing arbitration mechanism (edge proxy vs. client-side routing) to dynamically delegate paths between legacy and new modules.
- Formulate the contract for {{shared_state_dependencies}}, establishing event-bus abstractions or synchronized cookie/token storage to avoid hard module coupling.
- Define shared dependency governance (such as design system components and runtime libraries) to prevent duplicate asset payload downloads.
- Map the step-by-step strangler sequence starting with the lowest-risk path inside {{critical_user_journeys}} up to the core transaction flows.
- Specify automated rollback triggers, synthetic monitoring probes, and telemetry checks for client-side runtime errors.
- Detail team ownership, independent CI/CD pipeline structures, and contract-testing workflows for parallel squad releases.
Constraints
- MUST maintain backward compatibility with legacy authentication tokens across domain boundaries.
- MUST NOT require simultaneous full-stack deployments of both legacy and modernized frontends.
- MUST establish explicit asset size budgets for the shared container shell.
- Rollback steps MUST be executable within five minutes via CDN routing switches.
Output format
- Phase-by-Phase Roadmap (Table with Phase, Scope, Routing Rule, Fallback Protocol)
- Shared State & Asset Architecture (Max 350 words detailing isolation mechanisms)
- Blast-Radius Containment & Observability Plan (Numbered list of 4-6 operational safeguards)
- Team Governance & CI/CD Delivery Model (Max 250 words)
Self-review
- Verify all 6 context variables are directly utilized in the strategic blueprint.
- Ensure no shared-state recommendations introduce single points of runtime failure.
- Confirm every migration phase includes explicit telemetry gates before proceeding.
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.