review-all-gdds

Review all system GDD documents for cross-document contradictions and inconsistencies.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents inconsistent, stale, or incompatible game design documents from silently propagating into architecture by performing a holistic review across all system GDDs together.

Core Features & Use Cases

  • Cross-GDD Consistency: Finds contradictions between systems, stale cross-references, ownership conflicts over tuning knobs, and formula/input-range incompatibilities.
  • Game Design Holism: Flags player-facing systemic issues such as competing progression loops, dominant strategies, cognitive overload risks, economic imbalances, difficulty curve mismatches, pillar drift, and player-fantasy conflicts.
  • Interaction Boundary Validation: Walks through key multi-system player scenarios to surface ordering and state-transition failures that per-GDD reviews cannot catch.

Use case: After MVP-tier GDDs are approved and before architecture starts, run this to ensure the whole design set works coherently as a system rather than as isolated documents.

Quick Start

Use the review-all-gdds skill to review every system GDD in design/gdd/ for contradictions and holism issues in full mode.

Frequently Asked Questions about review-all-gdds

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

FAQPage Schema
How do I find contradictions across multiple game design documents?

To find contradictions across game design documents, you can perform a holistic GDD review that cross-references all system documents to identify stale cross-references, ownership conflicts, and incompatible formulas. This ensures alignment before architecture begins.

What is the best way to check game design holism for competing progression loops?

Checking game design holism involves reviewing all system GDDs together to flag player-facing systemic issues like competing progression loops, dominant strategies, economic imbalances, and pillar drift that isolated document reviews miss.

When do I need to run a cross-document consistency review for game design?

You need a cross-document consistency review during post-MVP GDD phases when multiple subsystems must align. It synchronizes game concept context and validates interaction boundaries before architecture starts to prevent silent design propagation.

How do I validate interaction boundaries and state-transition failures in game systems?

Validating interaction boundaries requires walking through key multi-system player scenarios to surface ordering and state-transition failures. This scenario walkthrough report outputs blocking or warning severities for unaligned subsystems.

Can I review only specific scopes or design theories instead of all system GDDs?

Yes, you can use optional focus modes like consistency-only, design-theory-only, or since-last-review scope. These modes run parallel passes on the synchronized GDD set to target specific cross-document checks without a full review.

What issues cause incompatible formulas and tuning knob ownership conflicts in game design?

Incompatible formulas and tuning knob ownership conflicts arise when isolated subsystem GDDs are approved separately. A holistic review detects these stale references and input-range incompatibilities by applying an optional entity registry baseline.