propagate-design-change

Cross-reference ADRs and traceability index to identify impacted architectural decisions from revised GDDs.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill propagate-design-change-polsegu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propagate-design-change
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/propagate-design-change
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill propagate-design-change-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a GDD is revised, architectural decisions written against it may no longer be valid. This skill finds every affected ADR, compares what the ADR assumed against what the GDD now says, and guides the user through resolution.

Core Features & Use Cases

  • Detects ADRs impacted by GDD changes and surfaces potential inconsistencies.
  • Compares historical ADR assumptions with the current GDD to reveal drift.
  • Generates a change impact report and provides guided steps to propagate fixes.

Quick Start

Provide the path to the changed GDD to start the propagation analysis.

Frequently Asked Questions about propagate-design-change

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

FAQPage Schema
How do I trace the impact of design changes on architectural decisions?

When a GDD is revised, architectural decisions written against it may become invalid. This skill detects affected ADRs by comparing historical ADR assumptions with the current GDD to reveal drift and guide resolution.

How do I detect inconsistencies between ADRs and an updated GDD?

You start the propagation analysis by providing the path to the changed GDD. The skill then loads all related ADRs, compares their assumptions to the updated GDD, and generates a change impact report with resolution steps.

What is the best way to find ADRs affected by a GDD revision?

This automated impact analysis approach distinguishes itself by classifying impacts and prescribing specific actions to propagate changes, rather than just listing files. It actively compares historical assumptions against the current GDD to reveal drift.

Can I use this skill to generate a change impact report for architecture decisions?

The skill requires a revised GDD and existing ADRs with a traceability index. It is suited for software architecture workflows that actively use GDDs to document design and ADRs to record architectural decisions.