2917 Plan Container Dogfooding E2478197

# Plan: Build ZERG Container for Dogfooding

**Goal**: Build Docker container with Claude Code, enable both host-based development and container-based development workflows.

**Created**: 2026-01-27

---

## Current State

| Component | Status |
|-----------|--------|
| Dockerfile | ✅ Ready (Claude Code installed via npm) |
| docker-compose.yaml | ✅ Ready (workspace + zerg-worker services) |
| ContainerLauncher | ✅ Implemented (expects image: `zerg-worker`) |
| worker_entry.sh | ✅ Ready |
| Rush --mode flag | ✅ Implemented |

**Gap**: Image not built. ContainerLauncher expects `zerg-worker` image to exist.

---

## Implementation Steps

### Step 1: Build the Docker Image

```bash
docker build -t zerg-worker -f .devcontainer/Dockerfile .
```

Image includes: Ubuntu + Python 3.12 + Node.js 20 + Claude Code CLI + MCP servers

### Step 2: Verify Claude Code in Container

```bash
docker run --rm -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY zerg-worker claude --version
```

### Step 3: Test Container Launcher

```bash
zerg rush --mode container --dry-run
```

---

## Workflow A: Host Machine + Container Workers

Run Claude Code on Mac, spawn workers in containers:

```bash
# Your main session (Mac)
claude

# Inside session, rush spawns container workers
/zerg:plan my-feature
/zerg:design
/zerg:rush --mode container --workers 3
```

---

## Workflow B: Full Container Development

Run everything inside containers:

```bash
# Start development container
docker-compose -f .devcontainer/docker-compose.yaml up -d workspace

# Enter container
docker-compose -f .devcontainer/docker-compose.yaml exec workspace bash

# Inside container - run Claude Code
claude

# From inside, rush can spawn sibling containers (requires docker socket mount)
```

**Note**: For Workflow B to spawn worker containers, need Docker-in-Docker or socket mount. Current docker-compose.yaml has `privileged: true` which enables this.

---

## Quick Reference

| Command | Effect |
|---------|--------|
| `zerg rush --mode container` | Force container workers |
| `zerg rush --mode subprocess` | Force local subprocess workers |
| `zerg rush --mode auto` | Auto-detect (default) |
| `zerg rush --dry-run` | Preview without executing |

---

## Files Involved

| File | Role |
|------|------|
| `.devcontainer/Dockerfile` | Image definition |
| `.devcontainer/docker-compose.yaml` | Multi-container orchestration |
| `.zerg/worker_entry.sh` | Container startup script |
| `zerg/launcher.py:544-700` | ContainerLauncher class |
| `zerg/orchestrator.py:87-177` | Launcher auto-detection |

---

## Verification

1. **Image exists**: `docker images | grep zerg-worker`
2. **Claude works**: `docker run --rm zerg-worker claude --version`
3. **Launcher detects**: `zerg rush --mode container --dry-run` shows "container mode"
4. **Full test**: Create test feature, run `zerg rush --mode container --workers 2`

---

## Known Limitations

- `wait-for-services.sh` not implemented (only needed for postgres/redis profiles)
- DC-012 integration test still pending
- Container workers need `ANTHROPIC_API_KEY` in environment