Files
Claude-Code-Game-Studios/design/CLAUDE.md
Donchitos 763ad1f0d1 Add notification hook, directory CLAUDE.md scaffolding
- Wire Notification event in settings.json to new notify.sh hook
- notify.sh: Windows toast notifications via PowerShell balloon tip
- docs/CLAUDE.md: authoring standards for ADRs, TR registry, control manifest, engine reference
- design/CLAUDE.md: GDD directory guidance placeholder
- src/: scaffold with .gitkeep and CLAUDE.md authoring guide

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-16 20:17:53 +11:00

1.5 KiB

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. Template: .claude/docs/templates/quick-spec.md

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.