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.