review-all-gdds

Reviews all game design documents for cross-document contradictions and design theory violations.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill review-all-gdds-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-all-gdds
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/review-all-gdds
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill review-all-gdds-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Individual GDD reviews cannot catch contradictions between documents, stale cross-references, or design issues that only emerge when all systems are viewed together, such as dominant strategies, broken economies, and pillar drift. ## Core Features & Use Cases - Cross-GDD Consistency Checks: Detects dependency asymmetries, rule contradictions, stale references, tuning knob ownership conflicts, formula range mismatches, and conflicting acceptance criteria across all system GDDs. - Game Design Holism Analysis: Evaluates progression loop competition, player attention budgets, dominant strategies, economic source/sink balance, difficulty curve alignment, pillar drift, and player fantasy coherence. - Cross-System Scenario Walkthroughs: Steps through multi-system player moments to find race conditions, feedback loops, and undefined behavior, then produces a severity-rated report with a PASS/CONCERNS/FAIL verdict. - Use Case: After all MVP GDDs are approved and before architecture begins, run this review to confirm the combat, economy, and progression GDDs do not contradict each other and that no system violates the design pillars. ## Quick Start Ask the AI to run a full cross-GDD consistency and design theory review over all documents in design/gdd and produce a verdict report before architecture work begins.

Frequently Asked Questions about review-all-gdds

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

FAQPage Schema
How do I check multiple game design documents for contradictions?

Run a cross-GDD review that loads every system GDD and compares dependency sections, rules, tuning knobs, formulas, and acceptance criteria pairwise. Contradictions are flagged as blocking issues or warnings with citations to the exact documents and sections involved.

What is the difference between a single GDD review and a cross-GDD review?

A single GDD review checks one document for internal completeness, while a cross-GDD review examines the relationships between all documents. Cross-GDD review catches stale references, dependency asymmetries, and design issues like dominant strategies that only appear when systems are viewed together.

When should I run a cross-GDD consistency review?

Run it after all MVP-tier GDDs are individually approved, after any GDD is significantly revised mid-production, and before architecture work begins. Architecture built on inconsistent GDDs inherits those inconsistencies.

Can I review only the GDDs that changed since the last review?

Yes, the since-last-review mode uses git history to identify GDDs modified since the last review report, then scopes the full read to those documents plus their listed dependencies. This avoids re-reading unchanged documents.

What happens if fewer than two system GDDs exist?

The review stops and reports that cross-GDD analysis requires at least two system GDDs. You must write additional GDDs first, then re-run the review.

What design problems does a holistic GDD review detect?

It detects competing progression loops, cognitive overload from too many simultaneous active systems, dominant strategies, economic source/sink imbalances, mismatched difficulty scaling curves, pillar drift, anti-pillar violations, and conflicting player fantasies.