# Project: ZERG

> Parallel Claude Code execution system that coordinates multiple worker instances to build features concurrently using spec-driven development.

- Skill: `tools-only/project-zerg` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/project-zerg`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/project-zerg/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/project-zerg

---

# Project: ZERG

## Overview
Parallel Claude Code execution system that coordinates multiple worker instances to build features concurrently using spec-driven development.

## Tech Stack
- **Runtime**: Python 3.12 (orchestrator), Node.js 20 (workers, MCP servers)
- **Isolation**: Docker devcontainers, git worktrees
- **Coordination**: Claude Code native Tasks, level-based synchronization
- **Infrastructure**: Docker Compose, volume mounts

## Repository Structure
```
.
├── .claude/
│   ├── commands/           # Slash commands (init, plan, design, rush, status)
│   └── agents/             # Agent definitions
├── .devcontainer/
│   ├── devcontainer.json   # Container definition
│   ├── Dockerfile          # Worker image
│   ├── docker-compose.yaml # Multi-container setup
│   ├── post-create.sh      # Setup script
│   ├── post-start.sh       # Startup script
│   └── mcp-servers/        # MCP configuration
├── .gsd/
│   ├── specs/              # Feature specifications
│   ├── PROJECT.md          # This file
│   └── INFRASTRUCTURE.md   # Infrastructure requirements
├── .zerg/
│   ├── config.yaml         # ZERG configuration
│   ├── orchestrator.py     # Fleet manager (to be created)
│   └── logs/               # Worker logs
├── zerg/                   # Python orchestrator package (to be created)
├── ARCHITECTURE.md         # System design
├── CLAUDE.md               # Project instructions
└── README.md               # User documentation
```

## Commands
- `/init` - Initialize factory infrastructure
- `/plan {feature}` - Capture requirements
- `/design` - Create architecture and task breakdown
- `/rush [--workers=N]` - Launch parallel execution
- `/status` - Monitor progress

## Configuration
Edit `.zerg/config.yaml` to customize:
- Worker limits and timeouts
- Quality gate commands
- MCP server availability
- Resource limits