Add README and refine game design doc

- Add concise English README (overview, features, controls, getting started)
- Fix Meccha Chameleon casing in the design doc

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Docs/GAME_DESIGN.md

@@ -1,12 +1,12 @@
 # Chameleon — Game Design & Fortschritt
 
 > Lebendes Dokument. Checkliste, was wir schon haben und was noch fehlt.
-> Vorbild: **MECCHA CHAMELEON** — aber **kein 1:1-Klon**. Wir picken die Mechaniken,
+> Vorbild: **Meccha Chameleon** — aber **kein 1:1-Klon**. Wir picken die Mechaniken,
 > die uns gefallen, und lassen den Rest weg oder machen es anders.
 
 ---
 
-## 1. Referenz: Was ist MECCHA CHAMELEON?
+## 1. Referenz: Was ist Meccha Chameleon?
 
 Online-PvP-Versteckspiel (Hide & Seek), 2–10 Spieler. Kurzüberblick der Mechaniken
 (Quellen: Wikipedia, Steam-Store-Seite, Stand der Recherche):
@@ -30,15 +30,15 @@ Online-PvP-Versteckspiel (Hide & Seek), 2–10 Spieler. Kurzüberblick der Mecha
 
 - **Behalten / Stärke ausbauen:** das **Bemalen** als Kern-Mechanik (haben wir bereits,
   sogar nahtfreies Mesh-Painting auf 3D) + **Bewegung über das Gewöhnliche hinaus**
-  (Wand-Klettern/Mantle ist bei uns schon drin und geht über Meccha hinaus).
-- **Noch offen / Geschmacksfrage** (bitte hier markieren, was dir an Meccha (nicht) gefällt):
+  (Wand-Klettern/Mantle ist bei uns schon drin und geht über Meccha Chameleon hinaus).
+- **Noch offen / Geschmacksfrage** (bitte hier markieren, was dir an Meccha Chameleon (nicht) gefällt):
   - Multiplayer-PvP zwingend, oder erst **Singleplayer/PvE** gegen KI-Seeker?
   - Tarnung **automatisch bewerten** (Spiel misst, wie gut die Bemalung zum Hintergrund passt)
     vs. rein durch das Auge des Seekers?
   - Posen-System ja/nein?
   - Taunt/Pfeifen ja/nein?
 
-> **TODO (User):** Hier eintragen, was dir bei MECCHA gefällt und was nicht — danach
+> **TODO (User):** Hier eintragen, was dir bei Meccha Chameleon gefällt und was nicht — danach
 > schärfen wir Scope & Reihenfolge.
 
 ---

README.md

@@ -0,0 +1,54 @@
+# Chameleon
+
+A Unity mesh-painting game inspired by **Meccha Chameleon** — not a 1:1 clone.
+You paint your character directly on its 3D mesh to blend into the environment,
+and move with an extended traversal kit (run, jump, slope-slide, wall-climb).
+
+> Status: early prototype. Core painting and movement work; the hide-and-seek
+> game loop (roles, rounds, scoring, multiplayer) is not built yet.
+
+## Features so far
+
+- **Seamless mesh painting** straight onto the character's 3D mesh (GPU + CPU path,
+  edge-dilation against seams).
+- **Third-person character controller** — camera-relative WASD, jump, gravity,
+  slope-sliding off too-steep surfaces.
+- **Wall-climb + mantle** — climb walls/ceilings (W approach/up, S detach, A/D
+  sideways) and pull up over top edges instead of dropping.
+- **Cinemachine orbit camera** — mouse look, scroll zoom, collision deocclusion.
+- **Game mode manager** — extensible state machine, switch with **Tab**:
+  - *Player Control* — move + mouse look.
+  - *Paint* — no movement, left-click paints, hold right-click to orbit.
+
+## Controls
+
+| Input | Action |
+|---|---|
+| WASD | Move (camera-relative) |
+| Space | Jump |
+| Mouse | Look / orbit camera |
+| Mouse wheel | Zoom |
+| Left click | Paint (Paint mode) |
+| Tab | Switch mode (Player Control ⇄ Paint) |
+
+## Getting started
+
+1. Open the project with **Unity 6000.3.11f1** (Unity 6).
+2. Open `Assets/Scenes/SampleScene.unity`.
+3. Press **Play**, move with WASD, press **Tab** to switch to Paint mode and paint.
+
+Cinemachine (`com.unity.cinemachine`) and the Input System are resolved
+automatically via the package manifest.
+
+## Project layout
+
+- `Assets/Scripts/` — gameplay scripts (`PlayerCharacterController`, `MeshPainter`,
+  `ThirdPersonOrbitInput`, `GameModeManager`, modes, `FrameRateLimiter`).
+- `Assets/Scenes/` — `SampleScene` (the playground).
+- `Docs/GAME_DESIGN.md` — design notes and the full feature checklist (German).
+
+## Roadmap
+
+See **[`Docs/GAME_DESIGN.md`](Docs/GAME_DESIGN.md)** for what's done and what's next
+(color-picker UI, eyedropper, camouflage scoring, poses, seeker role, rounds,
+multiplayer).