Breakdown Epic Arch

breakdown-epic-arch skill for programming & development

What Is This?

Overview

Breakdown Epic Arch decomposes large architectural initiatives into manageable implementation phases. It analyzes current state architecture, defines target state, identifies transformation steps, sequences phases considering dependencies, plans migration strategies minimizing disruption, assesses risks at each phase, and creates detailed roadmaps with milestones and success criteria.

The skill considers technical constraints, team capacity, business continuity requirements, and risk tolerance. It produces phased plans enabling incremental progress, validates feasibility of each phase, and provides rollback strategies for risk mitigation.

Who Should Use This

Architects planning major changes. Technical leads executing transformations. Engineering managers scheduling work. Teams migrating architectures. Anyone tackling complex architectural initiatives.

Why Use It?

Problems It Solves

Large architectural changes attempted all at once fail frequently. A phased approach manages complexity through incremental progress.

Dependencies between changes cause blocking. Sequencing phases considering dependencies enables smooth execution.

Business disruption from big-bang migrations is unacceptable. Incremental migration strategies maintain continuity.

Core Highlights

Epic decomposition into phases. Dependency identification and sequencing. Migration strategy planning. Risk assessment per phase. Rollback strategy definition. Milestone and success criteria. Team capacity consideration. Business continuity planning.

How to Use It?

Basic Usage

Analyze epic scope, identify phases, sequence by dependencies, plan migrations, assess risks, create roadmap.

Document current architecture state
Define target architecture
Identify major transformation steps
Sequence into phases considering dependencies
Plan migration strategy for each phase
Assess risks and define mitigations
Create timeline with milestones

Specific Scenarios

For microservices migration:

Phase 1: Service extraction framework
Phase 2: Extract read-only services
Phase 3: Extract write services with careful data migration
Phase 4: Extract complex services
Phase 5: Decommission monolith
Each phase with rollback plan

For database migration:

Phase 1: Set up replication
Phase 2: Migrate read traffic
Phase 3: Validate data consistency
Phase 4: Migrate write traffic
Phase 5: Decommission old database
Risk mitigation at each phase

For cloud migration:

Phase 1: Stateless services
Phase 2: Stateful services with data replication
Phase 3: Database migration
Phase 4: Cut over traffic
Phase 5: Optimize cloud-native
Parallel running for validation

Real-World Examples

A company migrates a monolith to microservices. An architect breaks the epic into 8 phases over 12 months. Phase 1 establishes the service framework and patterns. Phases 2-6 extract services by business domain considering data dependencies. Phase 7 migrates remaining functionality. Phase 8 decommissions the monolith. Each phase has success criteria, a rollback plan, and a 4-6 week timeline. The team executes systematically without major incidents.

A team modernizes a legacy database across 5 phases. Phase 1 sets up the modern database with replication. Phase 2 migrates read queries validating consistency. Phase 3 implements write replication with conflict resolution. Phase 4 shifts writes to the new database. Phase 5 decommissions the legacy system. Rollback strategies protect each phase, and migration completes successfully over 6 months.

An infrastructure modernization epic targets containerization across 6 phases. Phase 1 containerizes development environments, Phase 2 handles staging, and Phase 3 migrates non-critical production services. Phases 4-5 migrate critical services with careful planning. Phase 6 optimizes orchestration. Phasing manages risk while building team expertise and confidence through early phases.

Advanced Tips

Start with clear current and target state documentation. Identify all dependencies between phases. Consider team capacity realistically and plan for a learning curve in early phases. Define clear success criteria per phase and create rollback plans for each. Assess risks honestly and plan mitigations. Communicate the roadmap to stakeholders and build in buffer time for unknowns. Validate phases with prototype work.

When to Use It?

Use Cases

Microservices migration planning. Database modernization. Cloud migration architecture. Legacy system replacement. Platform transformation. Architecture refactoring. Technology stack migration. Infrastructure modernization.

Related Topics

Architecture migration patterns. Strangler fig pattern. Blue-green deployment. Feature flags. Parallel running strategies. Risk assessment frameworks. Project planning methodologies.

Important Notes

Requirements

Clear understanding of current architecture. Defined target architecture. Knowledge of dependencies. Team capacity estimates. Risk tolerance understanding. Stakeholder buy-in for timeline. Technical feasibility validation.

Usage Recommendations

Document current and target states thoroughly. Identify all dependencies carefully and sequence phases logically. Plan migrations minimizing disruption. Define success criteria clearly, assess risks honestly, and create rollback strategies. Build in learning time and validate feasibility early. Adjust the plan based on learnings.

Limitations

Cannot predict all challenges upfront. Estimates may be inaccurate and dependencies may be discovered late. Team capacity and business priorities may shift. Technical challenges may emerge. Requires significant planning effort and success depends on execution discipline.