propagate-design-change

Analyze revised GDDs to identify impacted ADRs and generate change-impact reports.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/emcconnell/nova-scout --skill propagate-design-change-emcconnell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propagate-design-change
Source: https://github.com/emcconnell/nova-scout/tree/main/.claude/skills/propagate-design-change
Command: npx skills add https://github.com/emcconnell/nova-scout --skill propagate-design-change-emcconnell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a GDD is revised, architectural decisions and ADRs may become stale. This skill automatically identifies affected ADRs and guides resolutions to maintain traceability.

Core Features & Use Cases

  • Scans ADRs referencing the changed GDD and compares their assumptions against the updated content.
  • Generates a structured change-impact report with recommended resolutions and traceability adjustments.
  • Guides subsequent ADR updates and traceability maintenance to keep design decisions aligned with the GDD.

Quick Start

Run the command with the path to the changed GDD, for example 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 trace architectural decisions affected by a GDD revision?

To trace architectural decisions affected by a GDD revision, analyze the revised GDD to surface impacted ADRs. The skill examines ADRs referencing the changed GDD, contrasts their assumptions, and outputs a change-impact report with resolution guidance.

Why do my ADRs become stale when I update a game design document?

ADRs become stale when a GDD is revised because existing architectural decisions were based on previous design assumptions. Without automatic traceability analysis, ADRs that reference the changed GDD are not updated to reflect new requirements.

How do I generate a change-impact report for updated architecture decisions?

Generate a change-impact report by scanning ADRs that reference the changed GDD and comparing their assumptions against the updated content. This produces a structured report with recommended resolutions and traceability adjustments.

Can I analyze ADRs stored in docs/architecture against git history?

Yes, you can analyze ADRs stored in docs/architecture against git history. The process requires access to the repository's ADR directory and reads git history to fetch previous GDD versions for assumption contrast.

What is the best way to maintain ADR traceability after modifying a GDD?

The best way to maintain ADR traceability after modifying a GDD is to automatically identify affected ADRs and guide subsequent updates. This keeps design decisions aligned with the current GDD through structured resolution recommendations.

Do I need git history access to analyze architectural decision record impacts?

Yes, you need git history access to analyze architectural decision record impacts. Reading git history is required to fetch previous versions of the GDD and contrast their assumptions against the updated content.