Karamelmar
09ff27be92
- 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>
114 lines
2.8 KiB
Markdown
114 lines
2.8 KiB
Markdown
# 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
|
||
```
|