propagate-design-change

Detect stale architectural decisions after Game Design Document revisions.

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill propagate-design-change-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propagate-design-change
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/propagate-design-change
Command: npx skills add https://github.com/imgamer/AILearn --skill propagate-design-change-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When your Game Design Document (GDD) changes, existing Architectural Decision Records (ADRs) can silently become outdated and internally inconsistent. This skill detects which ADR assumptions no longer match the updated GDD and helps you resolve the fallout systematically.

Core Features & Use Cases

  • Change summary from Git history: Uses the previous committed version of the specified GDD to identify exactly what changed.
  • Traceability-driven impact analysis: Loads ADRs and the architecture traceability index to find all ADRs referencing the changed GDD.
  • Decision validity classification: Classifies affected ADRs as Still Valid, Needs Review, or Likely Superseded, and recommends next actions.
  • Human-in-the-loop resolution workflow: Walks the user ADR-by-ADR through updating, superseding, and updating the traceability index.

Quick Start

Run the skill with the revised GDD path to generate an impact report and resolution plan in a single guided workflow.

Frequently Asked Questions about propagate-design-change

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

FAQPage Schema
How do I check which ADRs are affected when my GDD changes?

To check which ADRs are affected by GDD changes, compare the revised GDD against its previous git version, load your ADRs and traceability index, then generate an impact report classifying each decision as Still Valid, Needs Review, or Likely Superseded.

What is architectural traceability and when do I need it for game development?

Architectural traceability links design decisions to game design requirements, ensuring internal consistency. You need traceability when a GDD evolves, so you can detect which existing ADR assumptions have become stale and resolve the fallout systematically.

How do I keep ADRs aligned with an updated Game Design Document?

To keep ADRs aligned with an updated GDD, use git diff to identify revised requirements, load the architecture traceability index to find referenced ADRs, and walk through a human-in-the-loop workflow to update or supersede affected decisions.

Does this impact analysis workflow require a git repository?

Yes, this impact analysis workflow requires a git repository to access the previous committed version of the GDD, enabling an accurate revision diff to identify exactly what design changes occurred.

Can I automate ADR validation after git diff detects GDD changes?

You can automate ADR validation after git diff detects GDD changes by loading the traceability index to classify affected ADRs, but a human-in-the-loop workflow is required to guide ADR-by-ADR resolution, supersession, and traceability updates.

What are the limitations of automated ADR impact classification?

The limitation of automated ADR impact classification is that it cannot autonomously finalize architectural decisions; it requires a human-in-the-loop resolution workflow and optionally invokes a technical director gate to validate updates before applying traceability changes.