Skills

Review All Gdds

Holistic cross-GDD review, contradictions between systems, dominant strategies...

Install

npx skills add Donchitos/Claude-Code-Game-Studios --skill review-all-gdds -g -a claude-code -y
Category
Engineering
Updated
17d ago
License
MIT
Context cost
Mediumabout 1,726 tokens
Runs scripts
No, instructions only

What it does

Holistic cross-GDD review, contradictions between systems, dominant strategies, economic imbalance, cognitive overload, pillar drift.

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys automation,workflow,system_overrides

Review All GDDs

This skill reads every system GDD simultaneously and performs two complementary reviews that cannot be done per-GDD in isolation:

  1. Cross-GDD Consistency, contradictions, stale references, and ownership conflicts between documents
  2. Game Design Holism, issues that only emerge when you see all systems together: dominant strategies, broken economies, cognitive overload, pillar drift, competing progression loops

This is distinct from /design-review, which reviews one GDD for internal completeness. This skill reviews the relationships between all GDDs.

When to run:

  • After all MVP-tier GDDs are individually approved
  • After any GDD is significantly revised mid-production
  • Before /create-architecture begins (architecture built on inconsistent GDDs inherits those inconsistencies)

Every AskUserQuestion call follows .claude/docs/automation-modes.md (collaborative asks always · guided major-only · autonomous logs and proceeds; automation_always_ask categories always prompt).

Argument modes:

Focus: $ARGUMENTS (blank = full)

  • No argument / full: Both consistency and design theory passes
  • consistency: Cross-GDD consistency checks only (faster)
  • design-theory: Game design holism checks only
  • since-last-review: Only GDDs modified since the last review report (git-based)

workflow per GDD (per .claude/docs/workflow-modes.md): each GDD validates against its effective tier, the project value, overridden per system by the system_overrides row for that system when the block lists one. At full, validate all 8 sections across all GDDs. At standard, validate the 5 required sections; optional sections (Player Fantasy, Tuning Knobs, conditional Formulas) are surfaced as advisory only. At minimal, this skill is not applicable (no GDDs).

Read the whole SKILL.md on GitHub

More in Engineering