propagate-design-change

Detect and report ADRs impacted by revised game design documents.

14|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Euraika-Labs/Codex-Code-Game-Studios --skill propagate-design-change-euraika-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propagate-design-change
Source: https://github.com/Euraika-Labs/Codex-Code-Game-Studios/tree/main/.agents/skills/propagate-design-change
Command: npx skills add https://github.com/Euraika-Labs/Codex-Code-Game-Studios --skill propagate-design-change-euraika-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a Game Design Document (GDD) is updated, existing Architectural Decision Records (ADRs) may become outdated, leading to inconsistencies between design intent and implementation decisions.

Core Features & Use Cases

  • Scans all ADRs in docs/architecture and the traceability index for references to the changed GDD.
  • Performs a conceptual diff between the current and previous GDD versions using Git history.
  • Generates a detailed impact report classifying each affected ADR as still valid, needing review, or likely superseded.
  • Guides the user through resolution actions, updates ADR status, and amends the traceability matrix.
  • Optionally engages a technical director sub‑agent for a higher‑level review before finalizing changes.

Quick Start

Invoke the skill with the command propagate-design-change followed by the GDD file path to generate an 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 find outdated ADRs after updating a Game Design Document?

To find outdated ADRs after updating a Game Design Document, scan the repository's `docs/architecture` directory and compare the current GDD against the previous Git version to identify impacted architectural decision records.

What is the best way to maintain traceability between GDD changes and architecture decisions?

Maintaining traceability between GDD changes and architecture decisions requires scanning existing ADRs for references to the changed design document and updating the traceability matrix to reflect whether each record is still valid, needs review, or is likely superseded.

How do I generate an impact report for architectural decision records affected by design changes?

Generating an impact report for affected architectural decision records involves performing a conceptual diff between the current and previous GDD versions using Git history, then classifying each referenced ADR by its updated validity status.

Do I need Git access to detect stale architectural decision records in my repository?

Yes, Git access is required to detect stale architectural decision records because the Skill needs to retrieve prior versions of the Game Design Document from the repository history to perform the conceptual diff and determine ADR impact.

Can I automate updating ADR status and traceability indexes after a game design document revision?

You can automate updating ADR status and traceability indexes after a game design document revision by applying the impact report results to amend the markdown ADR files and modify the traceability matrix directly within the repository.

What limitations exist when tracking architectural impact from GDD updates?

Limitations when tracking architectural impact from GDD updates include the strict dependency on Git history for version comparison and the requirement that ADRs must reside in `docs/architecture` with existing traceability index files to be detected.