mirror of
https://github.com/Donchitos/Claude-Code-Game-Studios.git
synced 2026-06-27 13:01:50 +00:00
6c041ac1be
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>
39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# 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`.
|