propagate-design-change

Scans ADRs and traceability index to identify architectural documents impacted by GDD changes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/thilthpc01208/Codex-Game-Studios --skill propagate-design-change-thilthpc01208
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propagate-design-change
Source: https://github.com/thilthpc01208/Codex-Game-Studios/tree/main/.codex/skills/propagate-design-change
Command: npx skills add https://github.com/thilthpc01208/Codex-Game-Studios --skill propagate-design-change-thilthpc01208

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a GDD is revised, architectural decisions and their traceability can become stale. This Skill identifies affected ADRs and guides you through resolution to maintain consistency across the design artifacts.

Core Features & Use Cases

  • Detects changes to a GDD and maps them to impacted ADRs by inspecting the GDD Requirements Addressed.
  • Classifies ADR impact into Still Valid, Needs Review, or Likely Superseded, and surfaces a consolidated change-impact report.
  • Generates actionable guidance to update ADRs and the traceability index where necessary.

Quick Start

Execute /propagate-design-change design/gdd/updated.md to generate the impact report.

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 a design change on existing architectural decisions?

To trace the impact of a design change, this skill scans your ADRs and traceability index against the revised GDD, classifying impacted decisions as Still Valid, Needs Review, or Likely Superseded. It generates a comprehensive change-impact report with guided resolution steps.

When do I need to propagate architectural changes from a GDD?

You need to propagate architectural changes when a GDD is revised and existing ADRs risk becoming stale. This skill identifies affected architectural decisions by inspecting GDD Requirements Addressed and flags them for review to maintain consistency across design artifacts.

How do I analyze ADR impact after updating a GDD?

You analyze ADR impact by executing the /propagate-design-change command with the path to your updated GDD. The skill reads the GDD, ADRs, and traceability index to produce a consolidated report detailing affected architectural decisions.

Does this impact analysis tool require a specific project structure for ADRs and GDDs?

Yes, this impact analysis tool applies to projects with ADRs and GDDs linked in the docs/architecture directory. It requires this specific environment setup to map GDD changes to impacted ADRs and generate the change-impact report.

What is the best way to maintain traceability between GDDs and ADRs?

The best way to maintain traceability is to automate propagation of design changes by scanning the traceability index and ADRs. This approach generates actionable guidance to update affected ADRs and the index where necessary, ensuring consistency.