Zauberwald/CLAUDE.md

Project

Zauberwald

Zauberwald ist eine Webapplikation, die einem 7-jährigen Kind das 10-Finger-Tastaturschreiben beibringt. Die App verbindet strukturiertes Tipptraining mit einer dynamisch wachsenden, KI-generierten Waldwelt. Fester Übungsrahmen, überraschende Belohnungen — Neugier statt Leistungsdruck.

Core Value: Das Kind übt freiwillig weiter, weil es wissen will, was als Nächstes im Wald erscheint — nicht weil es Punkte sammelt oder Sterne verdient.

Constraints

• Tech Stack: Vanilla TypeScript, Vite 6.x, kein Framework. Einzelne main.css mit CSS Custom Properties. Biome für Lint. Vitest für Tests.
• API: Gemini REST via fetch(), kein Google SDK. Key im Frontend akzeptabel (private Nutzung).
• Datenhaltung: IndexedDB (Bilder als Blobs). Kein Backend, kein Server.
• Layout: QWERTZ DE + CH. Unterschiede erst ab Stufe 14+ relevant.
• Styling: Pastellfarben, Aquarell-Stil, Quicksand + Nunito Fonts, min. 16px. Sanfte Animationen.
• VPS-Deployment: --host 0.0.0.0, Port 5173 (dev) / 4173 (preview). Kein HTTPS nötig.

Technology Stack

Technology stack not yet documented. Will populate after codebase mapping or first phase.

Conventions

• Immer deutsche Umlaute (ä, ö, ü, Ä, Ö, Ü, ß) in UI-Texten verwenden, niemals ae/oe/ue Transliterierung.
• Kein No-Op Code: Keine leeren Funktionen, keine Stubs, keine auskommentierten Blöcke. Wenn etwas entfernt wird, komplett entfernen — inklusive Aufrufe, Imports, Typen und Tests.
• Never predict the future: Kein Code "für später", keine Abstraktionen für hypothetische Anforderungen, keine Platzhalter-Interfaces. Nur implementieren was jetzt gebraucht wird.

Architecture

Architecture not yet mapped. Follow existing patterns found in the codebase.

GSD Workflow Enforcement

Before using Edit, Write, or other file-changing tools, start work through a GSD command so planning artifacts and execution context stay in sync.

Use these entry points:

• /gsd:quick for small fixes, doc updates, and ad-hoc tasks
• /gsd:debug for investigation and bug fixing
• /gsd:execute-phase for planned phase work

Do not make direct repo edits outside a GSD workflow unless the user explicitly asks to bypass it.

Developer Profile

Profile not yet configured. Run /gsd:profile-user to generate your developer profile. This section is managed by generate-claude-profile -- do not edit manually.