propagate-design-change

Detect stale Architectural Decision Records after Game Design Document revisions.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill propagate-design-change
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propagate-design-change
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/propagate-design-change
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill propagate-design-change

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a Game Design Document (GDD) is updated, existing Architectural Decision Records (ADRs) may become outdated, risking inconsistency across the project. This Skill automatically finds those ADRs, evaluates the impact of the GDD changes, and presents a clear report so teams can act.

Core Features & Use Cases

  • Impact detection: Scans all ADRs for references to the modified GDD and flags those that may be stale.
  • Change summary: Generates a concise diff of the GDD revision and highlights sections that affect architecture.
  • Resolution workflow: Guides users through reviewing, updating, or superseding affected ADRs and updates the traceability index.

Quick Start

Run the propagate-design-change skill with the path to the revised GDD, e.g., “propagate-design-change design/gdd/combat-system.md”.

Frequently Asked Questions about propagate-design-change

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

FAQPage Schema
How do I detect stale Architectural Decision Records after a Game Design Document revision?

Detect stale ADRs after a Game Design Document revision by scanning all ADRs for references to the modified GDD and flagging those that require updates. This impact analysis identifies outdated architectural decisions and generates a clear report for teams to act on.

How do I analyze the impact of GDD changes on existing architecture traceability?

Analyze the impact of GDD changes on architecture traceability by generating a concise diff of the GDD revision and highlighting sections that affect the architecture. The Skill evaluates modified requirement IDs referenced by ADRs to maintain project consistency.

What is the best way to update the architecture traceability index when ADRs become outdated?

Update the architecture traceability index when ADRs become outdated by following a guided resolution workflow. This workflow helps users review, update, or supersede affected ADRs and automatically updates the traceability index to reflect the current design state.

Do I need Git access to trace GDD requirement IDs across ADR files?

Git access is required to trace GDD requirement IDs across ADR files because the Skill retrieves previous GDD versions for comparison. Read and write permissions for ADR files and the architecture traceability index are also necessary to execute the resolution workflow.

Can I automate ADR staleness detection for version-controlled GDDs?

You can automate ADR staleness detection for version-controlled GDDs by running the Skill with the path to the revised GDD. It automatically scans all ADRs, evaluates the impact of the design changes, and presents a clear report of outdated records.

When should I supersede affected ADRs instead of updating them after a GDD change?

Supersede affected ADRs instead of updating them after a GDD change when the architectural decisions are fundamentally invalidated by the new design. The resolution workflow guides users through reviewing the diff to determine whether to update or supersede each flagged record.