Add Context Studio Wizard — project scaffolding CLI

- wizard.sh: interactive bash wizard that scaffolds new CS projects
- lib/: utils, core install, project structure, workflow generation
- templates/: Dockerfile, devcontainer.json, agent presets (minimal/standard), system.json, roles, hook rules
- README: setup, usage, mobility workflow

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

README.md

@@ -1,2 +1,114 @@
-# ContextStudioWizard
+# Context Studio Wizard
 
+> Scaffold a fully configured multi-agent AI development environment in seconds.
+
+---
+
+## What it does
+
+One command. One conversation. A complete project drops out:
+
+```
+~/.context-studio/core/          ← installed once, shared globally
+
+~/projects/my-project/
+├── .devcontainer/               ← Node 22 · Rust · Claude Code · Electron deps
+├── workflow/                    ← agents, roles, A2A config, project docs
+└── src/                         ← your code
+```
+
+Open in devcontainer → start Context Studio → talk to your agent team.
+
+---
+
+## Prerequisites
+
+| Tool | Purpose |
+|------|---------|
+| `git` | Clone repos |
+| `docker` or `podman` | Run devcontainer |
+| SSH key → `github.com` | Access context-studio-core |
+| `ANTHROPIC_API_KEY` | Claude agents |
+
+---
+
+## Usage
+
+```bash
+./wizard.sh
+```
+
+The wizard guides you through:
+
+1. **Core setup** — clones `context-studio-core` to `~/.context-studio/core/` (once)
+2. **Project name & location**
+3. **Workflow** — generate from scratch _or_ clone an existing repo
+4. **Agent preset** _(if generating)_
+
+   | Preset | Agents |
+   |--------|--------|
+   | `minimal` | coordinator · 2× coder · researcher · tester |
+   | `standard` | 2× coordinator · 3× coder · 2× researcher · tester · reviewer |
+
+5. **Done** — git repo initialized, devcontainer ready
+
+---
+
+## Open the project
+
+**VS Code**
+```bash
+code ~/projects/my-project   # → "Reopen in Container"
+```
+
+**CLI**
+```bash
+cd ~/projects/my-project
+docker build -t my-project .devcontainer/
+docker run -it --rm \
+  -v "$(pwd)":/workspace \
+  -v "$HOME/.context-studio/core":/opt/context-studio/core \
+  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
+  my-project bash
+```
+
+**Start Context Studio** _(inside container)_
+```bash
+node $CS_CORE_DIR/core/start.js                    # Electron UI
+node $CS_CORE_DIR/core/start.js --ui-mode=headless # servers only
+```
+
+---
+
+## Mobility
+
+Commit your project. On any machine:
+
+```bash
+git clone <your-project-repo>
+cd my-project
+code .   # done
+```
+
+Core is re-cloned automatically on first run. Only `ANTHROPIC_API_KEY` is needed on the host.
+
+---
+
+## Repository layout
+
+```
+wizard.sh               ← entry point
+lib/
+  utils.sh              ← prompts, colors, helpers
+  core.sh               ← global core install/update
+  project.sh            ← devcontainer + project scaffold
+  workflow.sh           ← generate or clone workflow config
+templates/
+  Dockerfile            ← Node 22 + Rust + build tools + Claude Code
+  devcontainer.json     ← mounts, env vars, VS Code extensions
+  agents-minimal.json   ← 5-agent preset
+  agents-standard.json  ← 9-agent preset
+  system.json           ← A2A server defaults
+  roles/                ← coordinator, coder, researcher, tester, reviewer
+  hooks/rules/          ← per-role tool restrictions
+```