docs(04-02): complete visual polish plan

- Add 04-02-SUMMARY.md with animation and error handler results
- Update STATE.md with progress, decisions, metrics
- Update ROADMAP.md with plan progress
- Mark PLSH-01 through PLSH-05 complete in REQUIREMENTS.md

.planning/REQUIREMENTS.md

@@ -107,11 +107,11 @@ Requirements for initial release (MVP). Each maps to roadmap phases.
 
 ### Polish
 
-- [ ] **PLSH-01**: Fallende Buchstaben als sanft schwebende CSS-Animation (wie Blätter)
+- [x] **PLSH-01**: Fallende Buchstaben als sanft schwebende CSS-Animation (wie Blätter)
-- [ ] **PLSH-02**: Erfolg-Animation: Sternenstaub/Glitzer via CSS particles
+- [x] **PLSH-02**: Erfolg-Animation: Sternenstaub/Glitzer via CSS particles
-- [ ] **PLSH-03**: Begleitfigur-Avatar: Float-Animation (sanftes Schweben)
+- [x] **PLSH-03**: Begleitfigur-Avatar: Float-Animation (sanftes Schweben)
-- [ ] **PLSH-04**: Responsive bis 700px Breite (Tastatur verkleinert, Fonts skalieren)
+- [x] **PLSH-04**: Responsive bis 700px Breite (Tastatur verkleinert, Fonts skalieren)
-- [ ] **PLSH-05**: Globaler Error-Handler: Kindgerechte Fehlermeldung, kein Crash
+- [x] **PLSH-05**: Globaler Error-Handler: Kindgerechte Fehlermeldung, kein Crash
 - [x] **PLSH-06**: CSS-Palette + Typografie vollständig gemäss Spec (Custom Properties, Quicksand, Nunito)
 
 ## v2 Requirements
@@ -209,11 +209,11 @@ Which phases cover which requirements. Updated during roadmap creation.
 | AUDI-03 | Phase 4 | Pending |
 | AUDI-04 | Phase 4 | Pending |
 | AUDI-05 | Phase 4 | Pending |
-| PLSH-01 | Phase 4 | Pending |
+| PLSH-01 | Phase 4 | Complete |
-| PLSH-02 | Phase 4 | Pending |
+| PLSH-02 | Phase 4 | Complete |
-| PLSH-03 | Phase 4 | Pending |
+| PLSH-03 | Phase 4 | Complete |
-| PLSH-04 | Phase 4 | Pending |
+| PLSH-04 | Phase 4 | Complete |
-| PLSH-05 | Phase 4 | Pending |
+| PLSH-05 | Phase 4 | Complete |
 | PRNT-05 | Phase 4 | Pending |
 | PRNT-06 | Phase 4 | Pending |
 | PRNT-07 | Phase 4 | Pending |

.planning/ROADMAP.md

@@ -93,8 +93,8 @@ Plans:
 
 Plans:
 - [ ] 04-01-PLAN.md — Audio system (Web Audio API sounds, Web Speech API speech, mute button)
-- [ ] 04-02-PLAN.md — Animation polish (leaf-fall, stardust, companion float), responsive, error handler
+- [x] 04-02-PLAN.md — Animation polish (leaf-fall, stardust, companion float), responsive, error handler
-- [ ] 04-03-PLAN.md — Export/Import/Reset in parent area
+- [x] 04-03-PLAN.md — Export/Import/Reset in parent area
 - [ ] 04-04-PLAN.md — Wire audio into all screens, end-to-end human verification
 
 **UI hint**: yes

.planning/STATE.md

@@ -2,15 +2,15 @@
 gsd_state_version: 1.0
 milestone: v1.0
 milestone_name: milestone
-status: verifying
+status: executing
-stopped_at: Phase 4 context gathered (assumptions mode)
+stopped_at: Completed 04-02-PLAN.md
-last_updated: "2026-03-29T16:06:03.859Z"
+last_updated: "2026-03-29T16:17:26.933Z"
 last_activity: 2026-03-29
 progress:
   total_phases: 4
   completed_phases: 3
-  total_plans: 15
+  total_plans: 19
-  completed_plans: 15
+  completed_plans: 17
   percent: 0
 ---
 
@@ -21,13 +21,13 @@ progress:
 See: .planning/PROJECT.md (updated 2026-03-29)
 
 **Core value:** Das Kind übt freiwillig weiter, weil es wissen will, was als Nächstes im Wald erscheint — nicht weil es Punkte sammelt.
-**Current focus:** Phase 03 — komplettes-spielerlebnis
+**Current focus:** Phase 04 — polish-audio
 
 ## Current Position
 
-Phase: 4
+Phase: 04 (polish-audio) — EXECUTING
-Plan: Not started
+Plan: 2 of 4
-Status: Phase complete — ready for verification
+Status: Ready to execute
 Last activity: 2026-03-29
 
 Progress: [░░░░░░░░░░] 0%
@@ -67,6 +67,7 @@ Progress: [░░░░░░░░░░] 0%
 | Phase 03 P05 | 2min | 2 tasks | 4 files |
 | Phase 03 P02 | 4min | 2 tasks | 6 files |
 | Phase 03 P04 | 3min | 2 tasks | 4 files |
+| Phase 04 P02 | 2min | 2 tasks | 3 files |
 
 ## Accumulated Context
 
@@ -101,6 +102,8 @@ Recent decisions affecting current work:
 - [Phase 03]: Discover phase skips space key; review pulls 2 words from each of last 2-3 levels
 - [Phase 03]: Pre-generation uses fire-and-forget pattern: startPreGeneration() at lesson start, awaited on reward screen
 - [Phase 03]: Progress migration function ensures backward compat with older IndexedDB data
+- [Phase 04]: Stardust particles use box-shadow on pseudo-elements for 6 total sparkle points
+- [Phase 04]: Error overlay uses tree emoji and German child-friendly message
 
 ### Pending Todos
 
@@ -112,6 +115,6 @@ None yet.
 
 ## Session Continuity
 
-Last session: 2026-03-29T16:06:03.853Z
+Last session: 2026-03-29T16:17:26.927Z
-Stopped at: Phase 4 context gathered (assumptions mode)
+Stopped at: Completed 04-02-PLAN.md
-Resume file: .planning/phases/04-polish-audio/04-CONTEXT.md
+Resume file: None

.planning/phases/04-polish-audio/04-02-SUMMARY.md

@@ -0,0 +1,99 @@
+---
+phase: 04-polish-audio
+plan: 02
+subsystem: ui
+tags: [css-animations, responsive, error-handling, accessibility]
+
+# Dependency graph
+requires:
+  - phase: 03-gameplay
+    provides: "Lesson screen with falling letters, forest scene, companion area"
+provides:
+  - "Leaf-fall sinusoidal sway animation replacing letter-float"
+  - "Stardust CSS particles on correct keypress dissolve"
+  - "Companion avatar float animation"
+  - "prefers-reduced-motion accessibility support"
+  - "Responsive layout down to 700px"
+  - "Global error handler with child-friendly overlay"
+affects: []
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns: ["CSS pseudo-element particles", "prefers-reduced-motion media query", "global error overlay pattern"]
+
+key-files:
+  created: []
+  modified:
+    - src/styles/main.css
+    - src/main.ts
+    - index.html
+
+key-decisions:
+  - "Stardust particles use box-shadow on pseudo-elements for 6 total sparkle points"
+  - "Error overlay uses tree emoji and German child-friendly message"
+
+patterns-established:
+  - "CSS-only particle effects via ::before/::after pseudo-elements with box-shadow"
+  - "Global error/unhandledrejection handlers at top of main.ts entry point"
+
+requirements-completed: [PLSH-01, PLSH-02, PLSH-03, PLSH-04, PLSH-05]
+
+# Metrics
+duration: 2min
+completed: 2026-03-29
+---
+
+# Phase 04 Plan 02: Visual Polish Summary
+
+**Leaf-fall sway animation, stardust particles, companion float, responsive to 700px, and global error overlay with child-friendly message**
+
+## Performance
+
+- **Duration:** 2 min
+- **Started:** 2026-03-29T16:14:45Z
+- **Completed:** 2026-03-29T16:16:47Z
+- **Tasks:** 2
+- **Files modified:** 3
+
+## Accomplishments
+- Replaced letter-float with sinusoidal leaf-fall animation (lateral sway + vertical descent)
+- Added stardust CSS particles on .falling-letter--dissolve via ::before/::after pseudo-elements with box-shadow sparkle
+- Added companion-float animation for gentle avatar bobbing
+- Added prefers-reduced-motion media query disabling all animations
+- Added responsive styles at 700px (smaller keys, scaled fonts, adjusted grids)
+- Added global error handler catching uncaught exceptions with kindgerechtes overlay
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Enhanced CSS animations + responsive layout** - `3a79379` (feat)
+2. **Task 2: Global error handler + error overlay** - `f3cb948` (feat)
+
+## Files Created/Modified
+- `src/styles/main.css` - Leaf-fall, stardust, companion-float keyframes; error overlay styles; reduced-motion + responsive media queries
+- `src/main.ts` - Global error + unhandledrejection event listeners
+- `index.html` - Error overlay div with tree icon, message, and reload button
+
+## Decisions Made
+- Stardust particles use box-shadow on pseudo-elements for 6 total sparkle points (efficient, pure CSS)
+- Error overlay uses tree emoji and German child-friendly message ("Oh, der Wald braucht kurz eine Pause...")
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+None
+
+## User Setup Required
+None - no external service configuration required.
+
+## Next Phase Readiness
+- All visual polish complete (animations, responsive, error handling)
+- Ready for remaining Phase 04 plans (audio, export/import)
+
+---
+*Phase: 04-polish-audio*
+*Completed: 2026-03-29*