# Iteration 001

## What shipped

- Reworked `/playground` into a display-name-only Hermes Playground entry flow with avatar customization before launch.
- Added the new `training` starter zone and made fresh players start in Training Grounds while persisting `lastZone` for return visits.
- Introduced a typed `playerProfile` model with persisted display name, avatar config, inventory, equipment, quest progress, level/xp, titles, and zone tracking.
- Added inventory + equip UI, visible gear-driven avatar accents, reward toasts, and a five-step Hermes-themed tutorial chain.
- Added the Training Grounds combat drill with a Glitch Wisp, plus the three-slot action bar: Strike, Dash, Bolt.

## Files touched

- `src/screens/playground/playground-screen.tsx`
- `src/screens/playground/hooks/use-playground-rpg.ts`
- `src/screens/playground/lib/playground-rpg.ts`
- `src/screens/playground/lib/npc-dialog.ts`
- `src/screens/playground/lib/playground-bots.ts`
- `src/screens/playground/components/playground-world-3d.tsx`
- `src/screens/playground/components/playground-sidepanel.tsx`
- `src/screens/playground/components/playground-hud.tsx`
- `src/screens/playground/components/playground-actionbar.tsx`
- `src/screens/playground/components/playground-customizer.tsx`
- `src/screens/playground/components/playground-dialog.tsx`
- `src/screens/playground/components/playground-journal.tsx`
- `src/screens/playground/components/playground-map.tsx`
- `src/screens/playground/components/playground-minimap.tsx`

## Commit hashes

- Base branch head before this iteration: `6c82bfd56`
- Intended feature commit: `feat(playground): add training grounds onboarding loop`
- New commit hash: blocked in this sandbox because Git needs write access to `/Users/aurora/hermes-workspace/.git/worktrees/hermes-playground-local`

## Screenshots needed

- Title screen showing display-name-only entry and pre-launch avatar customizer access
- Training Grounds HUD with quest tracker, minimap, and action bar visible
- Inventory/equipment panel with Training Blade and Novice Cloak equipped
- Archive Podium docs/memory briefing modal
- Tutorial completion modal with Forge Gate unlocked
- Glitch Wisp encounter near the Trainer’s Ring

## Next-up items

- Add audio cues for portal unlock, quest complete, hits, and ambient Training Grounds loop
- Improve the player silhouette or replace it with a simple GLB avatar
- Thread multiplayer room defaults and online counts more explicitly through Training Grounds
- Add more explicit Forge build output beyond the current placeholder ritual
