Can I use this for service deprecation?

Absolutely. The skill maps all dependents of a legacy service, identifies the target migration service, and sets a phased decommissioning timeline.

What is an ADR in this context?

An Architecture Decision Record (ADR) is a document that captures a significant architectural decision, including the context of why the change was made, the options considered, and the long-term consequences.

How does this skill handle breaking changes?

The skill identifies all affected API consumers, plans a dual-support period where both old and new versions coexist, and generates migration guides for external and internal teams.

Does it support data migration planning?

Yes, it analyzes data stores, schema changes, and data volume to recommend specific migration strategies such as blue-green deployments or batch-and-sync processes.

Architecture Evolution & Migration

Name: Architecture Evolution & Migration
Author: jmagly

byjmagly

•

Deployment & DevOps

Manages structural code changes through comprehensive impact analysis, ADR generation, and phased migration planning.

This skill provides a structured framework for handling complex architectural shifts within a codebase using Claude Code. It automates the lifecycle of technical changes—from initial impact analysis and the generation of Architecture Decision Records (ADRs) to the creation of multi-phase migration plans and rollback strategies. By mapping dependencies across services and identifying potential breaking changes, it helps developers and autonomous agents maintain architecture health and documentation while minimizing the risks associated with service deprecation or technology migrations.

Key Features

01Automated Architecture Decision Record (ADR) generation and tracking

02Stakeholder communication and notification coordination templates

03Breaking change detection and API contract versioning support

04Comprehensive impact analysis for direct and transitive dependencies

05Detailed migration path planning with phased rollout and rollback steps

0667 GitHub stars

Use Cases

01Phasing out legacy services with complex cross-team dependencies

02Managing breaking API changes that require dual-support rollout periods

03Introducing new infrastructure components like caching layers or message brokers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jmagly/ai-writing-guide architecture-evolution

For use in Claude.ai and ChatGPT

Download Skill