architecture-evolve

Generates decision records, target-state specs, and phased plans for architectural migrations.

2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/alex-voloshin-dev/ai-skills --skill architecture-evolve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-evolve
Source: https://github.com/alex-voloshin-dev/ai-skills/tree/main/plugin/skills/architecture-evolve
Command: npx skills add https://github.com/alex-voloshin-dev/ai-skills --skill architecture-evolve

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This skill mitigates the high risk of architectural migrations by providing a structured, repeatable framework for planning, documenting, and executing transitions between technologies or patterns.

Core Features & Use Cases

  • Migration Planning: Generates comprehensive ADRs, target-state architectures, and phased migration plans (e.g., Strangler Fig, Expand-Contract).
  • Risk Management: Enforces the creation of fitness functions and explicit rollback strategies for every phase of the migration.
  • Use Case: Use this when transitioning a legacy monolith to microservices or migrating from a REST API to gRPC to ensure the target state is well-defined and the migration path is safe.

Quick Start

Invoke the architecture-evolve skill to plan the migration of our current monolith to a microservices architecture.

Frequently Asked Questions about architecture-evolve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan an architecture migration from a monolith to microservices?

Architecture migration planning involves generating decision records, target-state specifications, and phased transition plans using patterns like Strangler Fig. This framework enforces fitness functions and explicit rollback procedures to ensure production safety during large-scale technology shifts.

What is the Strangler Fig pattern for system refactoring?

The Strangler Fig pattern incrementally migrates legacy systems by building new functionality alongside the old, gradually replacing it. This architectural migration approach uses fitness functions and rollback procedures to manage risk during phased transitions like platform redesigns.

How do I create ADRs for an infrastructure modernization initiative?

Create Architecture Decision Records by documenting target-state architectures and phased migration plans for infrastructure modernization. This structured framework enforces fitness function implementation and explicit rollback procedures to mitigate risk during complex technology transitions.

Can I use this migration planning approach for a REST to gRPC API transition?

Yes, API migrations from REST to gRPC are supported by this framework. It generates target-state specifications and phased transition plans with defined migration patterns, ensuring the target state is well-defined and the migration path remains safe.

What are the limitations of using phased migration plans for platform redesigns?

Phased migration plans require strict adherence to defined migration patterns and fitness function implementation. Explicit rollback procedures must be established for every phase to ensure production safety during complex architectural transitions.

When do I need fitness functions during an architectural migration?

Fitness functions are required during architectural migrations to enforce defined migration patterns and verify production safety. They validate that each phase of the transition meets specified target-state architecture requirements before proceeding.