propagate-design-change

Identify stale architecture decision records affected by game design document revisions.

Updated Jul 22, 2025
One-click install
npx skills add https://github.com/MichaelSolati/mkai --skill propagate-design-change-michaelsolati
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propagate-design-change
Source: https://github.com/MichaelSolati/mkai/tree/main/profiles/game-dev/skills/propagate-design-change
Command: npx skills add https://github.com/MichaelSolati/mkai --skill propagate-design-change-michaelsolati

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a Game Design Document (GDD) is revised, existing Architecture Decision Records (ADRs) written against the old GDD can become stale or invalid, leading to misaligned technical architecture and wasted rework for game development teams.

Core Features & Use Cases

  • Stale ADR Detection: Scans all ADRs and the architecture traceability index to identify which architectural decisions are affected by GDD changes.
  • Impact Classification: Automatically classifies each affected ADR as Still Valid, Needs Review, or Likely Superseded based on alignment with the updated GDD.
  • Guided Resolution Workflow: Walks users through updating superseded ADRs, modifying traceability records, and generating formal change impact documents.
  • Use Case: When your team updates the combat system GDD, this skill instantly flags all related ADRs (e.g., combat networking, physics rules) that need revision, eliminating manual cross-referencing of dozens of documents.

Quick Start

Use the propagate-design-change skill with the path to your updated game design document to generate a full impact report for all related architecture decisions.

Frequently Asked Questions about propagate-design-change

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

FAQPage Schema
How do I identify stale architecture decisions after a game design document revision?

To identify stale architecture decisions after a game design document revision, scan all architecture decision records and traceability indexes against the updated GDD. This process maps design changes to affected decisions, classifying each ADR as still valid, needing review, or likely superseded to eliminate manual cross-referencing.

What is architecture traceability impact analysis in game development?

Architecture traceability impact analysis in game development tracks dependencies between technical decisions and game design documents. It automatically flags invalidated architecture decision records when design changes occur, producing structured impact reports that classify ADR validity and guide resolution workflows.

How do I update architecture decision records when game design changes?

To update architecture decision records when game design changes, run an automated scan against the revised game design document. This generates a change impact report classifying affected ADRs, then walks you through modifying superseded records and updating traceability indexes to reflect the new design.

Can I map GDD changes to specific architecture decisions automatically?

Yes, you can map game design document changes to specific architecture decisions automatically by scanning existing ADRs and traceability indexes. The analysis matches GDD revisions against documented technical decisions, instantly flagging related records like combat networking or physics rules that require revision.

Does stale ADR detection work without external dependencies?

Stale ADR detection operates without external dependencies, scanning your local architecture decision records and traceability indexes directly. It processes your updated game design document path to generate impact reports and guide resolution workflows entirely within your existing game development environment.

When should I run an architecture traceability scan during game development?

You should run an architecture traceability scan immediately after any game design document revision to prevent misaligned technical architecture. Running this impact analysis detects invalidated ADRs early, guiding document updates and preventing wasted rework before development proceeds on outdated assumptions.