How does this skill help with breaking changes?

It identifies all affected consumers, plans dual-support periods for backward compatibility, and generates migration guides to assist stakeholders during the transition.

How is the risk level of an architecture change determined?

The skill uses a weighted classification system that evaluates factors like data migration complexity, API compatibility, and cross-team dependencies to assign a risk score.

Does it support different migration strategies?

Yes, it includes templates and planning logic for various strategies including Big Bang, Phased rollouts, Blue-Green deployments, and the Strangler pattern.

Can it track transitive dependencies?

Yes, the impact analysis maps both direct dependencies and downstream transitive dependencies to ensure full visibility into the ripple effects of a change.

What is an Architecture Decision Record (ADR)?

An ADR is a document that captures a significant architectural decision, the context in which it was made, and the resulting consequences and trade-offs.

Architecture Evolution Manager

Name: Architecture Evolution Manager
Author: jmagly

byjmagly

•

API開発

Manages system architecture changes through automated impact analysis, ADR generation, and phased migration planning.

The Architecture Evolution skill provides a structured framework for managing complex system changes within Claude Code. It automates the technical overhead of architectural shifts by performing multi-dimensional impact analyses across APIs, data stores, and performance metrics. By generating standardized Architecture Decision Records (ADRs) and detailed migration paths—including rollback strategies and dependency mapping—it ensures that architectural growth is documented, low-risk, and transparent for the entire development team.

主な機能

01Direct and transitive dependency mapping to prevent breaking changes

0267 GitHub stars

03Risk-based change classification with defined approval requirements

04Step-by-step migration planning for component additions and deprecations

05Multi-dimensional impact analysis for APIs, data, security, and performance

06Automated Architecture Decision Record (ADR) generation and tracking

ユースケース

01Planning the deprecation of legacy services and migrating consumers to new infrastructure

02Evaluating the system-wide impact of introducing new technologies like caching layers or databases

03Managing breaking API changes with dual-support periods and communication plans

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