design-impact-analysis

Identify impacted artifacts across data models, business logic, UI, documentation, and tests.

1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/froide-kk/michinushi --skill design-impact-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-impact-analysis
Source: https://github.com/froide-kk/michinushi/tree/main/design-impact-analysis
Command: npx skills add https://github.com/froide-kk/michinushi --skill design-impact-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide provides a structured approach to identify and document the ripple effects of a change across models, design docs, tests, and deployment artifacts, ensuring nothing is overlooked.

Core Features & Use Cases

  • Systematic identification of direct and cascading impacts on data models, business logic, UI, and documentation.
  • Traceability to ADRs and design docs, enabling consistent decision-making and risk assessment.
  • Practical workflow for engineers to analyze changes and communicate risks to stakeholders.

Quick Start

Analyze a proposed change by listing affected components and referencing related ADRs, then update your YAML design docs accordingly.

Frequently Asked Questions about design-impact-analysis

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

FAQPage Schema
How do I analyze the ripple effects of a proposed architecture change?

To analyze ripple effects from an architecture change, identify all impacted artifacts across data models, business logic, UI, documentation, and tests, outlining both direct and cascading effects with clear traceability.

What is impact analysis in software engineering and when do I need it?

Impact analysis is a structured approach to identify and document the ripple effects of a change across models, design docs, tests, and deployment artifacts. You need it when proposing changes to ensure nothing is overlooked.

How do I map change impacts to ADRs and YAML design docs?

Map change impacts to ADRs and YAML design docs by listing affected components and referencing related architecture decision records. This ensures outputs map to updated documentation with clear safeguards and traceability.

Does impact analysis cover cross-cutting concerns and cascading effects?

Yes, impact analysis systematically identifies direct and cascading impacts on data models, business logic, UI, and documentation. It explicitly outlines cross-cutting concerns to ensure comprehensive risk assessment and stakeholder communication.

Can I use this workflow to assess risks for stakeholder communication?

Yes, this workflow provides a practical method for engineers to analyze changes and communicate risks to stakeholders. It ensures consistent decision-making by maintaining traceability to architecture decision records and design documents.

What is the best way to trace proposed changes to test plans and deployment artifacts?

The best way to trace changes to test plans and deployment artifacts is to systematically identify all impacted artifacts and ensure outputs map to updated test plans with clear safeguards and full traceability across the system.