V1.0.0

Two Keys: co-op mystery games for couples. Eight games on four engines (story, defuse, sync, labyrinth), two-device and couch play, mobile-first UI.

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

README.md

@@ -0,0 +1,26 @@
+# Two Keys 🔑🔑
+
+Co-op mystery games for couples. Two players, different clues, every lock needs both of you.
+
+## Hand this to Claude Code
+
+1. Unzip this folder and open it in your terminal (or WebStorm's terminal).
+2. Run `claude`.
+3. Paste this as your first prompt:
+
+> Read CLAUDE.md and GAMES.md fully, then every file in content/games/. Build phase 1 from §11 and stop so I can review. Don't change any YAML puzzle content without asking me.
+
+4. After each phase, review, run `npm test` and `npm run validate-content`, then say **"next phase"**.
+
+## What's in here
+
+| File | What it is |
+|------|------------|
+| `CLAUDE.md` | Full build spec: stack, architecture, security, engines, socket events, design, phases |
+| `GAMES.md` | Spoiler guide with every answer (don't let your partner read this 👀) |
+| `content/games/*.yaml` | All 8 games: 3 murder mysteries, 2 escape rooms, defuse, In Sync, labyrinth |
+| `package.json` | Root workspace config |
+
+## Adding a new game later
+Copy a YAML in `content/games/`, change the `id` to match the filename, write your chapters,
+and run `npm run validate-content`. No code changes needed for new story games.