1.4 KiB
1.4 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:
- Overview — one-paragraph summary
- Player Fantasy — intended feeling and experience
- Detailed Rules — unambiguous mechanics
- Formulas — all math defined with variables
- Edge Cases — unusual situations handled
- Dependencies — other systems listed
- Tuning Knobs — configurable values identified
- 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.