Elgato_dark/Claude-Code-Game-Studios
1
0
Fork 0
mirror of https://github.com/Donchitos/Claude-Code-Game-Studios synced 2026-04-21 13:27:18 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Claude-Code-Game-Studios/design/CLAUDE.md
Donchitos 6c041ac1be Release v0.4.0: /consistency-check, skill fixes, genre-agnostic agents 
New skill: /consistency-check — cross-GDD entity registry scanner
New registries: design/registry/entities.yaml, docs/registry/architecture.yaml
Skill fixes: no-arg guards, verdict keywords, AskUserQuestion gates on all team-* skills
Agent fixes: genre-agnostic language in game-designer, systems-designer, economy-designer, live-ops-designer
Docs: skill/template counts corrected, stale references cleaned up

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 20:07:44 +11:00

1.4 KiB
Raw Permalink Blame History

Design Directory

When authoring or editing files in this directory, follow these standards.

GDD Files (design/gdd/)

Every GDD must include all 8 required sections in this order:

  1. Overview — one-paragraph summary
  2. Player Fantasy — intended feeling and experience
  3. Detailed Rules — unambiguous mechanics
  4. Formulas — all math defined with variables
  5. Edge Cases — unusual situations handled
  6. Dependencies — other systems listed
  7. Tuning Knobs — configurable values identified
  8. Acceptance Criteria — testable success conditions

File naming: [system-slug].md (e.g. movement-system.md, combat-system.md)

Systems index: design/gdd/systems-index.md — update when adding a new GDD.

Design order: Foundation → Core → Feature → Presentation → Polish

Validation: Run /design-review [path] after authoring any GDD. Run /review-all-gdds after completing a set of related GDDs.

Quick Specs (design/quick-specs/)

Lightweight specs for tuning changes, minor mechanics, or balance adjustments. Use /quick-design to author.

UX Specs (design/ux/)

  • Per-screen specs: design/ux/[screen-name].md
  • HUD design: design/ux/hud.md
  • Interaction pattern library: design/ux/interaction-patterns.md
  • Accessibility requirements: design/ux/accessibility-requirements.md

Use /ux-design to author. Validate with /ux-review before passing to /team-ui.