# Demo Test Quick Reference

## Module File Types
| File | Purpose | Required |
|------|---------|----------|
| `module.yaml` | Metadata, XP, triggers, visuals config | Yes |
| `content.md` | Reference content (the "textbook") | Yes |
| `walkthrough.md` | Socratic guided lesson steps | No |
| `quiz.md` | Quiz questions with answers | No |
| `exercises.md` | Hands-on exercises with validation | No |
| `quick-ref.md` | Cheat sheet / command reference | No |
| `resources.md` | External links, videos, books | No |
| `game.yaml` | Interactive games | No |
| `workshop.yaml` | Workshop scenarios (editor + terminal) | No |

## Quiz Types
| Type | Directive | Use Case |
|------|-----------|----------|
| Timed choice | *(default)* | Multiple choice A/B/C/D |
| Drag order | `<!-- VISUAL: drag-order -->` | Order items correctly |
| Matching | `<!-- VISUAL: quiz-matching -->` | Match pairs |
| Fill blank | `<!-- VISUAL: fill-blank -->` | Fill in missing text |

## Game Types
| Type | Data | Purpose |
|------|------|---------|
| `speed-round` | `rounds` | Timed multiple choice |
| `bug-hunt` | `snippets` | Find bugs in code |
| `classify` | `categories`, `items` | Sort items into groups |
| `scenario` | `steps`, `startHealth` | Branching narrative |
| `command-sprint` | `challenges` | Type correct commands |
| `memory-match` | `pairs` | Match term/definition |

## Walkthrough Hints
| Hint | Visual Element |
|------|---------------|
| `hint:terminal` | Practice terminal |
| `hint:diagram` | Mermaid diagram |
| `hint:buttons` | Smart buttons |
| `hint:card` | Info card |
| `hint:code` | Code snippet |
| `hint:list` | Smart list |
| `hint:steps` | Step tracker |
| `hint:progress` | Progress bar |
| `hint:embed` | Web embed |
| `hint:quiz inline` | Inline quiz |
| `hint:celebrate` | Celebration |
| `hint:video` | YouTube video |
| `hint:game` | Game offer |

## Belt Progression
```
White (0) → Yellow (50) → Green (150) → Blue (400) → Purple (800) → Brown (1500) → Black (3000)
```